審查代理指令檔案
目標：找出指令檔案中錯誤、過時、模糊或危險的行，並提出更簡潔、準確的版本。絕對不要「修正」你尚未執行過的指令或尚未檢查過的路徑。
步驟
- 尋找檔案。 尋找
AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules/*.md、.cursor/rules/*.mdc、.cursorrules、.github/copilot-instructions.md和.github/instructions/*.md。列出你找到的內容，並說明每個檔案由誰讀取。 - 從儲存庫根目錄執行檢查工具 以先取得機械性發現：
python3 scripts/audit_instructions.py <file> [<file> ...]（路徑是相對於此技能資料夾；請使用已安裝技能的完整路徑。）它會回報長度、損毀的檔案路徑、提到不存在的腳本或 make 目標的指令、模糊用語、殘留的[括號]佔位符、重複行以及看似機密的字串。如果 Python 不可用，請手動執行相同的檢查。 - 自己檢查每個指令。 對於檔案中的每個指令，確認其存在（在
package.json中的腳本、Makefile中的目標、pyproject.toml中的條目）。執行那些低成本、安全的指令（lint、單元測試、型別檢查）。不要執行部署、遷移或刪除指令；將它們列出為「未驗證」。 - 檢查腳本無法做出的判斷性呼叫：
- Linter 或格式化工具已經強制的規則（候選刪除）。
- 互相矛盾的規則，或與另一個指令檔案矛盾的規則。
- 代理可以在數秒內從儲存庫讀取的事實（框架名稱、資料夾列表）。
- 沒有可測試意義的規則（「編寫乾淨的程式碼」）。
- 任何應該放在路徑範圍限定規則中而非根檔案中的內容。
- 報告，然後等待批准後再編輯。
報告格式
## 指令檔案審查：<file>
長度：<n> 行 (<verdict>)
### 必須修復（錯誤或不安全）
- 第 <n> 行：<什麼是錯的>，<證據：指令輸出或遺失的路徑>
### 應該修剪（低價值）
- 第 <n> 行：<為什麼可以刪除>
### 矛盾
- <檔案 A 第 n 行> vs <檔案 B 第 m 行>：<衝突點>
### 未驗證
- <指令>：<為什麼你沒執行它>
### 建議版本
<較短的檔案，或一個 diff>
規則
- 證據優先於意見：每個「必須修復」都要引用輸出或遺失的檔案。
- 保留擁有者的語氣，以及任何編碼了實際事件或硬性限制的規則。
- 審計期間不要新增規則。最多在結束時另外建議三條。
- 將看似機密的字串視為真實：告知使用者將其輪換，並且不要在報告中重複該值。