AGENTS.md レビュー
判定は agents-md のテストに従います。つまり、発見と修正に複数のフィードバックラウンドが必要であり、スキルや常時読み取りファイルに記載されていないものを対象とします。
確認後、分類
与えられたファイルをレビューし、リビジョンを記述します。 各ブロックを判定する前に、実際の状態と照らし合わせて確認します。判定ごとに1つの証拠で十分です。
- ツール(チェンジログ生成ツール、リリースツール、CIワークフローなど)が使用するサンプルやフォーマット:間違い。 ツールの設定を読めば十分です。ツールが誤ってレンダリングするものは、実際に誤った出力が出荷されていなくても間違いです。
- ツリーおよびリモートのデフォルトブランチに対するリスト:古い情報。
- マージ済みPRの履歴に対する主張された規約:決して規約ではない(誰も従っておらず、メンテナーが誰も決定していないと確認した場合)。 メンテナーが意図的にルールを導入している可能性があり、人間のコミッターが誰が決定したかを証明するものではないため、メンテナーが判断していない未遵守のルールは、人間の判断リストに追加されます。
- インストール済みスキルおよび常時読み取りファイルに対するルール:重複。
- 上記以外のものは、上記のテストに照らして:検出可能、内容なし、またはプレーンコマンド。
- 長いガイドへの常時読み込みポインタ:誤配置。それはそれを必要とするスキルに属します。
ブロックは、それぞれ独自の証拠を持つ複数の判定を受ける可能性があります。人間の確認を必要としない判定を先頭に置くことで、メンテナーが回答する前に削除を開始できます。
また、欠落しているものも探します:組織が他の場所で適用しているポリシー(意図ファイルのルール、記述規則、コメントマーカー)、ポインタのない非標準レイアウト、および兄弟 CLAUDE.md シンボリックリンクのない AGENTS.md。
agents-md/references/before-after.md は、あるリポジトリの解決済みの例です。現在のリポジトリに対してすべての行を再確認し、決して貼り付けないでください。
報告
| ブロック | 判定 | 証拠 |
|---|---|---|
| `Issue: #456`、`Issue: N/A` を有効なフッターとする | 間違い、決して規約ではない | `cliff.toml` はすべての `Issue:` をJiraリンクに変換します。メンテナーはどちらも決定されていないと確認 |
| テストはライブラリではなくCLIバイナリを駆動します。`testsuite/AGENTS.md` を参照 | 維持 | ライブラリレベルのテストスイートのやり直しは複数ラウンドです。どのスキルもそれを明記していません |
次に、完全に削除したファイルを提案し、スキルまたはネストされた AGENTS.md に移動した内容をリストアップし、人間の判断が必要なものをリストアップします。
依頼がない限り、変更を適用しないでください。