| name | sillyspec:quick |
| description | 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。 |
何时使用
- 明确、低风险、范围小的直接修改：改文案、修小 bug、更新单个文件
- 用户说"直接改、快速修、顺手调整、不要完整流程"
- 跳过 brainstorm/plan，但仍走 quick 的 3 步流程（理解任务 → 实现 → 自检提交）
多变更说明（quick 特殊，务必注意）
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
sillyspec run quick --done --output "摘要"
sillyspec run quick --status
sillyspec run quick --skip
sillyspec run quick --reset
sillyspec run quick --reopen --from-step N
通用参数（所有阶段适用）
| 参数 | 说明 |
|---|
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过审批/校验门控（需明确意图） |
--json | 输出 JSON（程序化读取） |
quick 特有参数
| 参数 | 说明 |
|---|
--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
sillyspec run quick --non-interactive
sillyspec run quick --done --linked-changes none --output "修复手机号校验"
sillyspec run quick --files src/phone.ts,src/phone.test.ts
铁律
- 必须用 exec 工具（shell）执行 CLI，不要自己编造流程
- quick 直接在主工作区改代码（不创建 worktree），范围必须小且明确
- 完成后立即
--done，不跳过
- step 2 会创建
.sillyspec/quicklog/QUICKLOG-<user>.md 记录，完成前 CLI 会校验它存在
- 禁止在没有运行 CLI 的情况下自行决定流程
用户指令
$ARGUMENTS
