creating-agents-md

creating-agents-md 技能簡化了為 AI 程式開發代理建立專案內容檔案的流程。透過在專案根目錄維護一個 agents.md 檔案，開發者能確保 AI 助手能即時存取關鍵的架構、工作流程與編碼標準，無需處理複雜的設定檔。此格式依賴純 Markdown，嚴格禁止 YAML frontmatter，以確保在各類 AI 開發工具與環境中的相容性。

• 使用純 Markdown 標準化專案上下文，實現通用相容性

• 消除 YAML frontmatter，為 LLM 提供清晰易讀的結構

• 強制執行文件化架構、技術堆疊、檔案結構與開發工作流程的最佳實踐

• 透過提供專案慣例與業務邏輯的單一事實來源，防止 AI 產生幻覺

• 非常適合搭配 PRPM、Cursor、Claude、Windsurf 及其他 AI 原生開發環境使用

• 在儲存庫中推廣「文件即程式碼」的文化

• 若要執行，請在儲存庫根目錄建立 agents.md 檔案，並填入涵蓋專案概述、技術堆疊、檔案結構與編碼慣例的區塊

• 專注於高優先級資訊，例如特定的框架版本、測試模式與獨特的領域知識

• 避免紀錄 AI 已知的通用程式設計最佳實踐；保持條目簡潔且專屬於專案

• 使用自由結構來突顯程式碼庫的獨特性，例如特定的 API 設計模式或資料庫架構慣例

• 確保所有內容皆保持為純 Markdown；避免添加可能混淆助手的後設資料或特殊標頭

• 隨重大重構或專案架構變更時定期更新 agents.md 檔案，確保 AI 的上下文保持相關且即時