コンテンツにスキップ

ファイル同期

.github/workflows/sync-managed-files.yml にあるファイル同期ワークフローは、REPO_SYNC_TOKEN(Contents R/W、Issues R/W、Pull Requests R/W、Metadata Read)を使用して、設定適用と並列ジョブとして実行されます。

ソースリポジトリ自体(docs-control)で実行される場合は、正規のファイルが既にここに存在するため、実行をスキップします。

ワークフローは、中央設定 から managed_files.files 配列を反復処理します。各エントリについて、docs-control から正規のコンテンツを取得し、ダウンストリームのコピーと比較します。存在しないファイルや差異(ドリフト)があるファイルは同期対象としてフラグが立てられます。

管理対象ファイルのマニフェストには以下が含まれます:

  • 呼び出し元ワークフロー(enforce-repo-settings.ymlgithub-pages-deploy.ymlrequire-linked-issue.ymlantigravity-review.ymlantigravity-translate.yml
  • エージェントスキル(.agents/skills/demo-components/SKILL.md.agents/skills/i18n-translate/SKILL.md
  • Issue および PR テンプレート
  • CONTRIBUTING.mdCLAUDE.mdAGENTS.mdSTYLE_GUIDE.md.editorconfig.gitignoreLICENSE
  • .pre-commit-config.yaml

ワークフローは、ダウンストリームリポジトリにどのパッケージエコシステムが存在するかを検出します:

  • npmpackage.json が存在
  • piprequirements.txtpyproject.toml、または setup.py が存在
  • dockerDockerfile が存在

常に含まれる github-actions エコシステムエントリに加えて、検出された各エコシステムのエントリを含む .github/dependabot.yml を生成します。すべてのエコシステムは、コンベンショナルコミットの接頭辞とマイナー/パッチのグループ化を使用して、毎週月曜日のスケジュールを使用します。

各ダウンストリームリポジトリは、以下の 2 つのソースから構築された生成済み README.md を受け取ります:

  • README.md.tpl — プレースホルダー(__TITLE____DESCRIPTION____REPO_NAME____DOCS_URL__)を含む docs-control ルート内のテンプレート
  • docs-sites.json — リポジトリ名を URL フィールドと照合することにより、各リポジトリの人間が読みやすいラベルと説明を提供