agents-md-sync
Installation
SKILL.md
agents-md-sync
リポジトリを解析し、階層ごとの AGENTS.md 知識ベースを生成・更新するワークフロースキル。
設計原則の正本は agent-native-project-design（「条件付きの知識ベース型」: ①オンデマンド階層に置く ②検証ループを通して生成する ③更新機構で鮮度を維持する）。本スキルはこの3条件を実行に移す実装である: 生成物はネスト階層に置かれ、階層別レビュー（②）と drift 検出（③）を内蔵する。原則の本文はここにコピーしない。AGENTS.md 階層以外の一般ドキュメントの同期要否検証には documentation-sync（auto）を使う。
引数とモード
| モード | 起動例 | 動作 |
|---|---|---|
| update（既定） | /agents-md-sync |
既存 AGENTS.md を読み、drift 閾値超の階層を更新。スコアリングで新規作成が妥当な階層は追加 |
| create-new | /agents-md-sync --create-new |
既存を全て読んで文脈を保全した上で、全階層を再生成 |
| 再ヒアリング | /agents-md-sync --interview |
既存ルートの有無によらず Phase 2 の規範ヒアリングを実施（再ヒアリングの唯一の経路） |
| 深さ制限 | --max-depth=2 |
対象ディレクトリ深さの上限（既定 3） |
| パス限定 | /agents-md-sync packages/api |
指定サブツリーのみ処理 |
引数に「承認不要」「そのまま進めて」等の明示があれば Phase 2 の承認 Gate を省略してよい。それ以外では省略しない。これらの引数がある場合、初回規範ヒアリング（Phase 2）も実施しない。ただし「グローバル設定実体の保護」による停止は、これらの引数があっても省略しない。