菜单
用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
规范驱动开发工具包。绿地用 /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 四件套），但不直接写代码。
用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
| name | sillyspec:quick |
| description | 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。 |
scale=small 的变更：带 design.md 进 quick（sillyspec run quick --linked-changes <变更名>），design 当背景quick 阶段的 --change 语义是「关联变更」且会触发步骤重置，不要用 --change 来指定关联变更。多活跃变更时改用：
--linked-changes none：不关联，仅记 QUICKLOG--linked-changes a,b：显式关联到变更 a、b--non-interactive：CI/脚本环境，默认不关联（避免交互 prompt 崩溃）首次 sillyspec run quick 选定的关联会持久化到 .runtime/quick-guard.json，后续 --done 自动复用，不会重复弹交互 prompt。
sillyspec quick是sillyspec run quick的顶层别名，两者等价。
sillyspec run quick # 输出当前步骤 prompt（首次会记录 baseline）
sillyspec run quick --done --output "摘要" # 完成当前步骤
sillyspec run quick --status # 查看阶段进度
sillyspec run quick --skip # 跳过可选步骤
sillyspec run quick --reset # 重置阶段（从头开始）
sillyspec run quick --reopen --from-step N # 重新打开已完成阶段修订（N=序号或名称）
| 参数 | 说明 |
|---|---|
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过审批/校验门控（需明确意图） |
--json | 输出 JSON（程序化读取） |
| 参数 | 说明 |
|---|---|
--linked-changes none|a,b | 显式关联变更（取代 --change，推荐）。none=不关联，a,b=关联列表 |
--files a.js,b.js | 显式声明本次允许修改的文件（边界保护） |
--allow-new | 允许新增文件（默认禁止，防意外创建） |
--force-baseline | 允许覆盖 baseline 受保护文件（危险，慎用） |
--confirm | 完成时确认接受变更审计结果（warning/blocked 时用） |
# 单变更项目，直接开始
sillyspec run quick
# 多变更项目，显式不关联
sillyspec run quick --linked-changes none
# 多变更项目，关联到指定变更
sillyspec run quick --linked-changes 2026-07-03-add-login
# CI/脚本（非交互，避免 prompt 崩溃）
sillyspec run quick --non-interactive
sillyspec run quick --done --linked-changes none --output "修复手机号校验"
# 限定修改文件范围
sillyspec run quick --files src/phone.ts,src/phone.test.ts
--done，不跳过.sillyspec/quicklog/QUICKLOG-<user>.md 记录（理解任务时），完成前 CLI 会校验它存在$ARGUMENTS