Menu
执行（/run）：gate-check→ACTIVE→验收→审计→CHANGELOG→README（门面）→plan→必 commit。每任务/Sprint 收尾自动提交。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
总入口（/master）— 迷路时 AskQuestion 路由 plan/run/learn 等
交付验收（/delivery）：视觉 · i18n · 文档对齐 · 后端对接 · 组件完整度 · 可维护性 · 生产就绪。Sprint 收尾或 /release 分支前走查。说「交付验收」「上线前检查」「生产就绪」时用。
规划（/plan）：需求→先总后分→Sprint→plan.md→/run。说「规划」「拆任务」时用。禁止写业务代码。≠ IDE Plan 模式。
Sprint 出口（/release）：分支 merge/PR/保留/丢弃 4 选 1 · semver · CHANGELOG · tag。 说「收尾」「merge」「开 PR」「发版」「打 tag」「分支怎么办」时用。自治发版→ship agent。
脚手架（/scaffold）：空项目创建栈模板，已有项目审计与建议。说「初始化」「创建项目」「脚手架」时用。须用户确认后再创建。
可发布测试报告（/report）— 全量/分层 verify 后汇总 · Report Contract · 日志解析 · benchmark 文档。项目无关 · 操作者无关。说「测试报告」「全量测试报告」「verify 报告」「benchmark 报告」时用。
| name | run |
| description | 执行（/run）：gate-check→ACTIVE→验收→审计→CHANGELOG→README（门面）→plan→必 commit。每任务/Sprint 收尾自动提交。 |
| disable-model-invocation | true |
日常三指令之二：/plan 拆好任务 → /run 做到底。Sprint 收尾后 merge/打版 → /release。
闸门见 rules/workflow.mdc。先读 learn/（若有）。规划侧见 plan skill「先总后分」— run 负责 按坐标执行、归档 与 及时 commit。
./.cursor/bin/runner.sh gate-check # BLOCK → /plan
AUTONOMOUS:true）plan handoff 默认自治时，用户 只说一次 /run；Agent 同会话按 执行顺序做完 Sprint P0 TASK（verify+commit），仅决策点打断。
| 必须 | 禁止 |
|---|---|
每 TASK 收尾后 立即续下一 ACTIVE（next-task / 读 plan） | TASK ✅ 后停住等用户再说 /run |
决策清单命中 → AskQuestion 或 ⚠️ → /plan | 静默扩 scope · 跳过 verify |
人格/行为 → super-cursor-persona · role.default（dashu） | 因语气跳过高风险确认 |
触点矩阵 → plan reference/autonomy-chain.md · workflow.json → autonomy.interrupt_on。
禁止在任务 ✅ 后仅更新 plan/CHANGELOG 却留给用户手动 commit。单轮顺序固定：
ACTIVE → 🔧 → 实现 → task-verify → closeout review（若触发） → 审计复核 → CHANGELOG（若有用户可见变更）→ README 同步（若触发） → 更新 plan.md → git commit（必做） → release-tag（tag-per-commit 时必做） → next-task
./.cursor/bin/runner.sh task-verify
git status && git diff --stat # commit 前：无密钥、无意外文件
./.cursor/bin/runner.sh next-task
./.cursor/bin/runner.sh verify # Sprint / 打版前全量
task-verify 非 OK 不得标 ✅、不得 commit（见 rules/communication/constitution.mdc）。
| 时机 | 规则 |
|---|---|
| 每个 TASK / DOC / SPIKE 归档任务 ✅ | 同轮 必须 git commit（不含 plan.md）；tag-per-commit 时同轮 release-tag |
| Sprint 全部 ✅ 收尾 | CHANGELOG / 已跟踪文件更新后 commit；Sprint 笔记进 .cursorGrowth/archive/ |
仅改 .cursorGrowth/plan.md | 勿 commit（.cursorGrowth/ gitignore） |
| push | 默认 不 push；用户说 push 或 ship / release §分支 再推 |
Message 须含任务 ID（TASK-003 · DOC-001 · SPIKE-002）。格式：type(scope): summary (ID)。
无改动可提交（罕见）→ 在回复中说明「working tree clean」，勿伪造 empty commit。
| 阶段 | 推荐命令 |
|---|---|
| 开发任务 | ./scripts/test.sh 或域脚本 L1（bash scripts/verify_<feature>.sh） |
| 任务收尾 / P0 闭合 | ./scripts/verify.sh 或域脚本 --full（L3） |
分层定义 → rules/feedback/verify.mdc · 测试侧重 → test skill。
task_verify_heuristics.enabled=true 时，描述性验收列会回退到 ./scripts/test.sh（若存在）。
失败自修 ≤2 轮（须按 debug 循环：复现→假设→隔离→验证；禁止无复现盲改）· 仍失败 ⚠️ → /plan · 打版读 release skill
经验沉淀：用户纠正或 ⚠️ 且根因已定位时，回复中提议 /learn 记一条（ERRORS / LEARNINGS，见 learn §经验捕获）；不自动写 .cursorGrowth/。
禁止功能已交付、CHANGELOG 已写、README 仍滞后留给人手补。见 plan skill「对外门面 · README」。
| 本次 diff 含 | 同轮必做（commit 前） |
|---|---|
.cursor/skills/ 新增/改名/职责变更 | README 开箱即用 · 指令表 · skills 计数/名单 |
.cursor/agents/ | README agents 行 |
master/ routes · 新 / 指令 · plan/run 工作流 | README mermaid · 机制表 · plan-run 链 |
| 安装路径 · config 公开键 · verify 链 | README 安装/验证节 |
CHANGELOG [Unreleased] 有 Added/Changed（用户可见） | README 摘要与之对齐 |
母版仓库验收：
bash .cursor/bin/cursor-coherence.sh # README ↔ 磁盘 skills/agents 一致
[Unreleased] 审 README；coherence 绿再 commit在标 ✅ 与 commit 之前，对照 rules/core.mdc 审计三公理自检：
| 检查 | 要点 |
|---|---|
| 意图主权 | 改动符合 ACTIVE 与 Sprint Goal；不碰 Out of scope；无 drive-by 重构 |
| 信号可信 | 验收命令已实际执行；关键结论可引用 file:line |
| 认知可审计 | CHANGELOG/plan 已更新 · Sprint 收尾时 plan 正文 reconciliation · 门面变更已同步 README · commit message 含任务 ID |
轻量清单（不必委派 review agent，除非任务标 REV-* 或 diff 高风险）：
git status 脏文件cursor-coherence.sh 绿复核不通过 → 继续修，勿标 ✅、勿 commit。
task-verify 后 · 可选）用这个：P0 任务 task-verify 绿后、commit 前再做一轮结构化回顾。不是那个：日常轻量审计（上节清单已覆盖）· 专项 REV-* 须委派 review agent。
吸收自 SkillsMP autoreview（协议 only，不装 OpenClaw CLI）。
| 触发 | 动作 |
|---|---|
| diff 非 trivial（多文件 / 行为变更 / auth·API） | 叠加 review skill（Standards/Spec 双轴）或委派 review agent（只读） |
| 用户要求「再过一眼」「第二模型 review」 | 同上；可用另一模型会话，禁止无 diff 采证空评 |
| 纯文案 / 单节 skill 补协议且无行为面 | 可跳过 closeout，仅走上节审计清单 |
顺序（插入单轮流程）：task-verify ✅ → closeout review（若触发） → 审计复核 → CHANGELOG → commit。
输出：Blocker/High 须修或向用户说明；仅 Medium/Low 可在回复中列出，用户确认后再 commit。
| 触发 | 动作 |
|---|---|
DOC-* 或 plan 三阶段协作文档 阶段 3 | 生成 5–10 个「读者会发现的问题」 |
| 验证 | 委派 review agent（只读）或新会话：仅给文档全文 + 单题，检查答案与歧义 |
| 失败 | 回到 plan 阶段 2 修订对应节；勿标 DOC ✅ |
用户说「不用测读者」→ 记录跳过，仍须用户最终通读确认。
用户自然语言命中下表时，自动选用右侧能力（勿要求用户说 skill 名）：
| 用户意图 | Agent 动作 |
|---|---|
| 写 PRD/RFC/设计 doc | plan §协作文档 · AskQuestion 结构化 vs 自由 |
| E2E / Playwright / 起 dev server | test §E2E · with_server.py |
| PDF 表单/验收 | delivery §PDF 工具 |
| 编辑 docx/pptx/xlsx 深度 | AskQuestion：装 upstream anthropics skill / 用 MCP / 跳过 |
| 新 UI 交付走查 | delivery §1 反模板自检 |
| 使用说明书 / 配图 regen | user-manual /manual |
| 测试报告 / verify 汇总 | test-report /report |
| MCP 建服 | mcp §Eval |
| 新功能 0→1 / 写 spec / SDD | plan §SDD · Greenfield 模式 |
| 实现后仍有差距 | run §converge |
Ambiguous 时 AskQuestion ≤4 项，禁止开放式「你想用哪个 skill」。
触发：Greenfield/Brownfield feature 一批 TASK ✅ 后 · 或用户说「对照 spec 看还差什么」。
| 步 | 动作 |
|---|---|
| 1 | 读 {specs_dir}/<id>/spec.md + 当前实现（grep/Read） |
| 2 | 列 未覆盖 FR/用户故事/验收场景 |
| 3 | 差距 → 新 TASK-* 写入 plan · 或 下一 Sprint 候选 |
| 4 | 无差距 → 可选 review §SDD analyze 终检 |
勿 silent merge：Blocker 级差距须用户确认再标 feature 完成。
.cursorGrowth/plan.md 在 .gitignore — 只更新本地，禁止 git add .cursorGrowth/。
task-verify 与审计通过后、commit 前更新本地 plan：
<!-- LAST_DONE: TASK-xxx -->（或 DOC-/SPIKE-）./.cursor/bin/runner.sh next-task → 更新 <!-- ACTIVE: ... --> 与 <!-- NEXT: ... -->ACTIVE；表空 → 进入 Sprint 收尾禁止只改 LAST_DONE / ACTIVE 而留 Done when 未勾、TASK 表无 ✅、可选基线段落仍写「未交付」——头部与正文须同步（见 Sprint 收尾 · plan 正文 reconciliation）。
勿把长叙事写进 plan；细节进 CHANGELOG 或 .cursorGrowth/archive/。
当前 Sprint 任务表无 ⬜/🔧 时：
./.cursor/bin/runner.sh verify — 须满足 Sprint Done when（母版含 cursor-coherence.sh · README 与 CHANGELOG 对齐）
docs/test-report.md → /report（test-report；步骤 1 刚跑完 verify 时优先 from-logs；见 reference/regen-gates.md §sprint）.cursorGrowth/archive/（命名见 learn/plan-conventions.md）.cursorGrowth/plan.md）：
<!-- SPRINT_STATUS: closed --> · <!-- ACTIVE: (none) --> · <!-- NEXT: (none) -->done 表或「历史 Sprint」链接列表plan-conventions.md 登记的可选段落 → 交付态或仅 archive[Unreleased]（勿在 plan 维护 ROADMAP 全表）git commit（必做） — 仅已跟踪文件；message 例：docs: close SPRINT-NN readme sync (DOC-00N)/learn — 吸收 archive / CHANGELOG 到 .cursorGrowth/learn/（建议）./.cursor/bin/runner.sh plan-check — plan 内无已闭合 Sprint 正文git status 无意外脏文件（.cursorGrowth/ 改动可存在且不必提交）Sprint 收尾后若需 merge/PR 或打 tag → /release；新开 Sprint → /plan（设 <!-- SPRINT_STATUS: active -->）。
| 时机 | run | plan |
|---|---|---|
| 单任务 ✅ + commit + README（门面） | ✅ | |
| Sprint 收尾 README/coherence + 归档 | ✅ | |
| 阶段 1 门面进 Done when · 禁事后 DOC Sprint | ✅ | |
| 新开 Sprint | 阶段 1 总 → 阶段 2 分 | |
⚠️ 阻塞 | 标状态 | 重排；Goal 偏了 → 阶段 1 |