agents-md
AGENTS.md 遵循規範
核心原則
AGENTS.md 是專案層級的 AI 工作指南,等同於人類開發者的 README.md,但對象是 AI Agent。
- 開工必讀:開始任何開發任務前,必須先閱讀專案根目錄的
AGENTS.md。 - 嚴格遵守:在整個任務週期中,所有產出和行為必須符合
AGENTS.md中定義的規範。 - 衝突提示:若使用者的要求與
AGENTS.md中的內容產生衝突,必須立即提示使用者,並等待使用者決定。 - 不可擅改:未經使用者明確同意,不得修改
AGENTS.md。若認為需要修改,應先說明修改原因和方向,取得使用者同意後才執行。
AGENTS.md 的用途
AGENTS.md 通常包含以下類型的資訊:
More from cacaorick/skills
ai-dev-workflow
由文件串起完整的 AI 開發流程。涵蓋領域建模與程式碼組織(DDD)以及 AI 開發規範設定(Agent 規範)。Use when (1) the user asks to organize code by business features or define naming conventions, (2) creating or updating AGENTS.md / project rule files, (3) starting a new project from scratch, or (4) the agent needs the full development lifecycle.
12bdd
行為驅動開發流程。幫助撰寫 Gherkin、建立 Step Definitions 骨架、選擇測試工具、執行驗證並回報問題。開發和修正是由其他 skills 處理。Use when (1) the project uses BDD or has .feature files, (2) the user asks to write Gherkin scenarios or Step Definitions, (3) the user asks to run BDD tests.
1ddd
DDD 領域驅動設計 - 戰略設計。專注於產出 Domain Model 文件,包括識別核心域/支撐域/通用域、拆分 Bounded Context、定義 Ubiquitous Language 與 Context Map。Use when (1) the user asks how to split Bounded Contexts, (2) the user asks to define Ubiquitous Language, (3) the user wants to create a Domain Model document, (4) the project uses DDD architecture and requires strategic design.
1temp-folder
當 AI Agent 需要建立非專案所需的臨時檔案時(如測試輸出、生成的程式碼草稿、除錯檔案等),自動在專案根目錄建立 `.ai` 資料夾,並確保該資料夾已被加入 `.gitignore`。使用時機:(1) 當 AI 需要產生臨時/測試性質的檔案,(2) 當 AI 產生的檔案不是專案正式所需。
1