Menu
用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
规范驱动开发工具包。绿地用 /sillyspec:init，棕地用 /sillyspec:scan，全自动用 /sillyspec:auto。完整流程：scan → brainstorm → plan → execute → verify → archive。支持 TDD、子代理并行、worktree 隔离、E2E 验证。兼容 Claude Code / Cursor / Codex / OpenCode / OpenClaw。
用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
| name | sillyspec:plan |
| description | 用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。 |
plan.md（Wave 分组 + Task 列表 + 依赖关系），可能含 tasks/task-NN.md 任务蓝图项目有多个活跃变更（.sillyspec/changes/ 下有多个目录）时，所有 sillyspec run 命令需加 --change <变更名> 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
sillyspec plan是sillyspec run plan的顶层别名，两者等价。
sillyspec run plan # 输出当前步骤 prompt
sillyspec run plan --done --output "摘要" # 完成当前步骤（--input "用户原话" 记录输入）
sillyspec run plan --status # 查看阶段进度
sillyspec run plan --skip # 跳过可选步骤
sillyspec run plan --reset # 重置阶段（从头开始）
sillyspec run plan --reopen --from-step N # 重新打开已完成阶段修订（N=序号或名称）
sillyspec run plan --wait --reason "..." --options "A,B" # 暂停等用户决策
sillyspec run plan --continue --answer "..." # 恢复等待中的步骤
sillyspec run plan --done --answer "..." --output "..." # 一步完成 wait+done
| 参数 | 说明 |
|---|---|
--change <名> | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过审批/校验门控（需明确意图） |
--json | 输出 JSON（程序化读取） |
plan 的步骤是动态的：generate_plan（生成分级计划）→ review_plan（审查计划，按规模分级：tier=self 当前 agent 自审 / tier=independent 启动独立审查子代理产出 stage review.json，避免生成+自审同一次输出的偏差）→ CLI 从 plan.md 解析出 task 自动插入"任务蓝图协调器"步骤（per-task）。这是正常行为，不要手动添加。
design.md 是否满足 plan 契约（缺文件变更清单/风险登记/自审章节会阻断）。若失败需先 sillyspec run brainstorm --reopen --from-step N 修订设计。plan.md 是否满足 execute 契约（Wave 结构、task 引用等）。失败会阻断完成，提示修复后重新 --done。plan 完成校验会检查：design 提到入口文件（cli.ts/main.ts/server.ts 等）但 task 的 allowed_paths 不含该文件 → 报 error。若确实不需要改入口，在 design.md 明示理由。
brainstorm → plan → execute
plan 完成后（plan.md 通过 execute 契约校验），运行 sillyspec run execute --change <变更名> 开始实现。
--done，不跳过$ARGUMENTS