AGENTS.md 審查
判決套用 agents-md 中的測試:超過一輪低成本的反饋循環來發現並修正,且未在技能或始終讀取的檔案中陳述。
驗證,然後分類
審查提供的檔案,並說明是哪個修訂版本。 在判斷每個區塊之前,先根據實際情況進行檢查;每個判決只需一個證據即可。
- 根據使用它們的工具(變更日誌生成器、發佈工具、CI 工作流程)檢查範例和格式:錯誤。 閱讀工具的設定檔就足夠了;無論錯誤的輸出是否已發佈,工具會錯誤呈現的內容就是錯誤的。
- 根據目錄樹和遠端預設分支檢查列表:過時。
- 根據已合併的 PR 歷史檢查聲稱的慣例:從未是慣例,當沒有人遵循它,且維護者確認沒有人決定過它時。 維護者可能正在刻意引入規則,而人類提交者無法證明是誰決定的,因此對於未經維護者裁決的未遵循規則,應列入人類決策清單。
- 根據已安裝的技能和始終讀取的檔案檢查規則:重複。
- 其他所有內容均根據上述測試進行檢查:可發現、無內容 或 純命令。
- 始終指向長篇指南的指標:錯置;它應屬於需要它的技能。
一個區塊可以獲得多個判決,每個判決都有自己的證據;以不需要人類確認的判決為先,這樣可以在維護者回答之前就開始修剪。
同時尋找缺失的項目:組織在其他地方應用的政策(意圖檔案規則、寫作慣例、註釋標記)、沒有指標的非標準佈局,以及沒有兄弟檔案 CLAUDE.md symlink 的 AGENTS.md。
agents-md/references/before-after.md 是某個儲存庫的工作答案;請針對您面前的儲存庫重新驗證每一行,切勿直接貼上。
報告
| 區塊 | 判決 | 證據 |
|---|---|---|
| `Issue: #456`、`Issue: N/A` 作為有效的頁尾 | 錯誤,從未是慣例 | `cliff.toml` 將每個 `Issue:` 值轉換為 Jira 連結;維護者確認兩者均非經決議 |
| 測試驅動 CLI 二進位檔案,而非函式庫;請參閱 `testsuite/AGENTS.md` | 保留 | 重做函式庫層級的測試套件需花費超過一輪;沒有技能陳述此事 |
然後提出完整的修剪後檔案,列出移至技能或巢狀 AGENTS.md 的項目,並列出需要人類決策的項目。
除非被要求,否則不要套用變更。