agents-md-guide
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、群組、工具),再依需要加入記憶與心跳的說明與實際建立目錄/檔案。
More from mz038197/vanscoding-skills
agent-soul-crafter
Design compelling AI agent personalities with structured SOUL.md templates — tone, rules, expertise, and response behavior
27user-md-guide
>-
5git smart commit
將雜亂的 git 變更,依功能邏輯自動拆分成多個有意義的 conventional commit
4peas-example-coach
內建凡思陪練流程(五階段),預設自動讀取專案根目錄 `example-learning-checklist.md` 作為學習清單;**新工作階段第一則**訊息頂端先一行純文字字標 `PEAS · 凡思陪練`(見 `references/peas-splash.md`),再顯示 ASCII 品牌框,**隨即詢問使用者是否準備好開始**;確認準備好後**下一則**才出進度條與第一題。每條引導前核對工作階段紀錄避免重複;過程與最終評分預設寫入 `session-records/peas-example-log.md`、`peas-example-score.md`(見 skill「輸入」)。新主題開頭顯示文字進度條(M/N),**N 必須等於該清單檔內「必做」checklist 列之總數:排除 `##` 含「老師示範」或「老師示範題」之小節底下各列,並排除「選修/選擇性」小節底下各列(或單列明確標為選修者);不得自行增減**;選修不納入正式五軸/Sigmoid 總分,另於 `references/score.md` 之「挑戰加分」記錄。且不暴露清單。老師示範小節預設跳過陪練;**必做**條目走主線流程,**開場不向學生確認**示範範圍或起點(**準備好開始**之確認除外,見「開場準備確認」)。當使用者提到「peas-example-coach」、凡思陪練、checklist 陪練、思考格陪練時使用。
4peas-challenge-coach
學生完成 checklist 陪練後,以教練模式逐題釐清進階題需求與規格、條列對齊後再依 Persona~Example 六欄收成完整一份提示詞交 coding agent 改碼(不含純手寫路徑),並驗收實作與理解;過程與最終評分預設寫入 session-records/。最終評分與 peas-example-coach 同為「理解評估摘要」五軸與 Sigmoid 總分(見 references/coach-score.md);**必做** Challenge 納入正式五軸/總分,**選修**不納入正式計分、另列挑戰加分。當使用者提到「peas-challenge-coach」「教練模式」「challenge 教練」「進階挑戰」「挑戰題引導」「動手實作引導」時觸發。不適用於概念理解的逐條陪練(那是 peas-example-coach 的工作)。
4pptx
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
1