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;記憶與心跳段落以「若存在則…」撰寫,故從第一天到之後擴充都能用同一份檔案。

設計原則(引導時向對方說明)

  1. 一份檔案從頭用到尾:不產出「簡易版 / 完整版」兩份,避免分裂。
  2. 條件式描述:凡依賴「記憶目錄、MEMORY.md、HEARTBEAT.md、cron」的段落,一律寫成「若存在則…」「當環境支援時…」,沒有就跳過,不報錯。
  3. 階段式擴充:先完成核心(身份、原則、Red Lines、群組、工具),再依需要加入記憶與心跳的說明與實際建立目錄/檔案。
Related skills

More from mz038197/vanscoding-skills

Installs
4
First Seen
Mar 18, 2026