| 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