agent-rules-skill

為什麼要用

核心特性

遵循 agents.md 慣例
自動偵測建置／測試／lint 指令
從現有程式碼擷取撰碼慣例
一份檔案適用於 Claude Code、Cursor、Codex 等工具
保持檔案簡短——agents.md 是提供方向的指引，不是長篇大論

即時演示

實際使用效果

agent-rules-skill.replay ▶ 就緒

0/0

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法： agent-rules-skill

為尚未擁有 AGENTS.md 的專案產生一份

👤 正在將 AI 程式代理引入既有程式碼庫的團隊 ⏱ ~15 min beginner

何時使用： 團隊剛開始使用 Claude Code／Cursor，但還沒有人撰寫入門說明文件。

步驟

在專案上執行

Use agent-rules-skill. Analyze this repo and draft an AGENTS.md following the convention.✓ 已複製

→ 草稿包含建置／測試指令、lint 設定、程式風格說明與注意事項
細部調整

Add a section on where not to edit (generated files, vendor/).✓ 已複製

→ 已新增含明確路徑的章節
提交

Commit as docs/AGENTS.md.✓ 已複製

→ 檔案已提交至專案根目錄或 docs/ 目錄下

結果： 一份持續維護的 AGENTS.md，讓未來每次代理工作階段都能帶著完整背景脈絡開始。

注意事項

AGENTS.md 膨脹成鉅細靡遺的大全 — 專注於代理真正需要的內容，其餘細節連結至 README 供人閱讀。

搭配使用： filesystem · git

在 monorepo 中為各套件分別產生 AGENTS.md

👤 Monorepo 維護者 ⏱ ~30 min intermediate

何時使用： 各套件有不同的慣例，單一根目錄的 AGENTS.md 不足以涵蓋所有情況。

步驟

掃描各套件

Use agent-rules-skill. For each package in packages/, generate a tailored AGENTS.md capturing its specifics.✓ 已複製

→ 每個套件各自產生一份 AGENTS.md
建立根目錄摘要

Generate a root AGENTS.md that links to per-package files and lists shared rules.✓ 已複製

→ 根目錄檔案含各套件連結

結果： 代理能根據當前所在的套件自動取得正確的背景脈絡。

搭配使用： filesystem

讓 AGENTS.md 與持續演進的專案保持同步

👤 AGENTS.md 容易快速過時的專案 ⏱ ~10 min beginner

何時使用： 你新增了建置指令或變更了慣例，但 AGENTS.md 的內容已不再正確。

步驟

差異比對

Use agent-rules-skill. Compare current AGENTS.md to what the repo actually has now. What's stale?✓ 已複製

→ 列出所有落差項目
更新

Update only the stale parts; leave human-written sections alone.✓ 已複製

→ 最小化差異，保留人工撰寫的說明

結果： AGENTS.md 維持可信賴的狀態。

搭配使用： git

組合

與其他 MCP 搭配，撬動十倍槓桿

agent-rules-skill + filesystem

直接將產生的檔案寫入專案

Write the draft to AGENTS.md at repo root.✓ 已複製

agent-rules-skill + git

以專注的提交記錄變更

Commit the new AGENTS.md with a message describing what it covers.✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
scan_repo	repo path	任何專案的第一步
draft_agents_md	scan output	起草新檔案時使用
diff_check	existing AGENTS.md + current repo	檢查內容是否已過時

成本與限制

運行它的成本

API 配額: None
每次呼叫 Token 數: 適中——專案掃描加上簡短輸出
費用: Free
提示: 在大型 monorepo 中針對特定目錄執行；掃描整個專案會消耗大量 token。

安全

權限、密鑰、影響範圍

憑證儲存： 無

資料出站： 掃描過程中專案內容會經由 Claude API 傳輸

故障排查

常見錯誤與修復

Generated commands don't match CI

請對照實際的 CI 設定檔驗證；技能是從常見檔案推斷指令，不一定完全正確

File is too long

提示要求更精簡；agents.md 原本就應保持簡短

替代方案