agents-md-guide
Installation
SKILL.md
AGENTS.md 建構引導 — 給工作區的 Agent 指令
本 skill 協助初次使用者建立 AGENTS.md,讓 Cursor、nanobot 或其他 agent 知道「自己是誰、怎麼開機、怎麼用記憶與心跳」。採用階段式與條件式設計:同一份 AGENTS.md 在還沒有 memory/ 或 HEARTBEAT.md 時也能正常運作;之後建立這些檔案後不必改 AGENTS.md 就會生效。
何時使用本引導
- 第一次要為工作區或 agent 建立 AGENTS.md
- 想合併多份 AGENTS.md(例如 nanobot 版與通用模板版)並統一格式
- 不確定記憶、心跳在「初期還沒有」時該怎麼寫——本引導用條件式描述處理
AGENTS.md 是什麼
AGENTS.md 是給 agent 讀的工作區指令:身份與開機流程、記憶與心跳規則、對外行為、群組禮節、工具與平台格式等。本引導產出的內容同時適用 Cursor 系工具與 nanobot;記憶與心跳段落以「若存在則…」撰寫,故從第一天到之後擴充都能用同一份檔案。
設計原則(引導時向對方說明)
- 一份檔案從頭用到尾:不產出「簡易版 / 完整版」兩份,避免分裂。
- 條件式描述:凡依賴「記憶目錄、MEMORY.md、HEARTBEAT.md、cron」的段落,一律寫成「若存在則…」「當環境支援時…」,沒有就跳過,不報錯。
- 階段式擴充:先完成核心(身份、原則、Red Lines、群組、工具),再依需要加入記憶與心跳的說明與實際建立目錄/檔案。