| name | sillyspec:quick |
| description | 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。 |
何时使用
- 明确、低风险、范围小的直接修改：改文案、修小 bug、更新单个文件
- 用户说"直接改、快速修、顺手调整、不要完整流程"
- brainstorm 判定
scale=small 的变更：带 design.md 进 quick（sillyspec run quick --linked-changes <变更名>），design 当背景
- 跳过 brainstorm/plan，但仍走 quick 的 3 步流程（理解任务 → 实现 → 自检提交）
多变更说明（quick 特殊，务必注意）
quick 阶段的 --change 语义是「关联变更」且会触发步骤重置，不要用 --change 来指定关联变更。多活跃变更时改用：
--linked-changes none：不关联，仅记 QUICKLOG（CLI 启动时写入）--linked-changes a,b：显式关联到变更 a、b--non-interactive：CI/脚本环境，默认不关联（避免交互 prompt 崩溃）
首次 sillyspec run quick 选定的关联会持久化到 .runtime/quick-sessions/<quick-session-id>/guard.json（每个 quick 会话独立，多会话并发不互覆盖），后续 --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
已有进行中会话的恢复（sessionId）
sillyspec run quick / run quick --done / --status 不带 --change 时，是启动一个新 quick 会话（CLI 分配新 quick-<hash> + 新 ql-ID，QUICKLOG 追加「进行中」条目），不是恢复正在进行的旧会话。多会话并发或中断恢复时，必须带上启动时 CLI 打印的 sessionId：
sillyspec run quick --change quick-<hash>
sillyspec run quick --done --change quick-<hash> --output "…"
- 这里的
--change quick-<hash> 是「恢复到该 CLI 生成的 session」，与下方 --linked-changes 的关联业务变更语义不同：想关联真实业务变更才用 --linked-changes。
- 误启动的空壳会话：
sillyspec run quick --cancel --change quick-<hash> 一键取消（QUICKLOG 条目翻「已取消」+ tasks.md 挂载行移除 + 会话目录清理 + db 行注销；已完成/已勾选的拒绝取消）。
通用参数（所有阶段适用）
| 参数 | 说明 |
|---|
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--input "<一句话任务描述>" | 通用参数，quick 启动时强烈建议带：作为 QUICKLOG 条目标题，条目从第一分钟即语义可读。不带则落「(quick 任务)」占位标题——平台「快速修复」列表默认隐藏进行中的占位条目，语义标题要到最终 --done 才回填（关联变更有 proposal/design 标题时可自动提取，免传） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
quick 特有参数
| 参数 | 说明 |
|---|
--linked-changes none|a,b | 显式关联变更（取代 --change，推荐）。none=不关联，a,b=关联列表 |
--files a.js,b.js | 显式声明本次允许修改的文件（边界保护 + 声明即归属：多 agent 并发仓防他者窗口文件混入 QUICKLOG 文件行，未声明窗口文件进「审计：」行追溯；他向亦然——其他 active 会话已声明的文件在你的 --done 审计中自动剔除归该会话，不再误拦、无需 --force-baseline）。中途可追加：发现要改声明外文件（如新写的测试）时，带新增文件恢复会话即并入边界（追加不替换）——sillyspec run quick --files <新增> --change <sessionId>；不带 --files 恢复则边界原样保留 |
--file-notes "p::注 || p::注" | quick --done 用：QUICKLOG「文件：」行落盘为多行带括注 bullet（省事后手改文件行）。格式 path::括注，|| 分隔多条；只随 step3 --done 同命令传（CLI 短进程，step1/step2 传无效，不带到 step3） |
--allow-new | 允许新增文件（默认禁止，防意外创建） |
--allow-delete | 允许删除文件（默认 fail-closed，删除是破坏性操作；确认删除带此 flag 显式解锁） |
--force-baseline | 允许覆盖 baseline 受保护文件 / 压制 .sillyspec/ 危险判定（危险，慎用） |
--confirm | ⚠️ 仅打印变更概览，不解锁 blocked（blocked 仍 exit 1）。真正解锁用 --force-baseline/--allow-new/--allow-delete |
审计与并发变更（--done 边界审计）
--done 收尾时对比 step1 baseline 与当前 git status，拦「危险文件 / 新增文件 / 覆盖 baseline」。要点：
- 并发其他会话的
.sillyspec/changes/<非关联变更>/ 不再被本 quick 拦截。quick 自己没有 changes/ 目录，该路径下非关联内容视为并发会话的工作，整体放行（确定性审计无法区分「并发工作」与「本 quick 偷建变更」，后者这类意图软判定留给 sillyhub）。
- 其他 active 会话已声明的文件自动豁免（
--files 的他向语义）。多 agent 并发时，并行 quick 会话 --files 显式声明的文件（如它的 daemon/router.py）出现在你的窗口内（它在你启动后改的、不在你的 baseline）——--done 审计自动剔除归该会话边界管，不再判危险 BLOCK、无需 --force-baseline。放行可见：输出 🔗 软警告逐文件列归属会话；若确系你的改动，恢复会话时 --files 追加声明；超 7 天未收尾的僵尸会话声明自动失效（sillyspec run quick --cancel --change <他者会话ID> 清理）。豁免只认他者显式声明——未声明的他者文件照旧走各门判定（漏声明的补 --files，危险文件仍需 --force-baseline）。
- 关联变更的文件仍走审计：reverse-sync 改自己关联变更的
design.md 会被拦，需 --force-baseline 显式确认。
- baseline 折叠目录前缀匹配：step1 启动时整片
changes/ 未跟踪会被 git 折叠成 ?? .sillyspec/changes/（带尾斜杠 token）；审计时若该目录下文件被并发会话跟踪而展开成文件级路径，按尾斜杠 token 前缀放行其下所有文件，不误判。
- 同文件并发 warn（advisory，不阻断）：step1 启动时若你的某个
allowedFile 已在他者脏文件列表里（他者也改了这文件），--done 时 CLI 会比对当前内容 hash 与启动时录入的 hash——不一致（你也改了它）即判「同文件并发」并 warn：整文件 pathspec 提交会夹带他者 hunk。warn 给出分离指引（git add -p <file> 交互选你自己的 hunk，或 git diff <file> > mine.patch 编辑后 git apply --cached mine.patch 再 commit）。这不阻断 --done（你可能有意整文件提交），看 warn 后自行决定是否分离。
--confirm ≠ 解锁：它只打印概览。blocked 时真正解锁的是 --force-baseline（压制 .sillyspec/ 危险判定 + baseline 覆盖）/--allow-new（放行新增）/--allow-delete（放行删除，删除是破坏性操作默认 fail-closed，须显式 opt-in），三者可在 step1 或 --done 传，都生效。
典型用法
sillyspec run quick --input "修复登录限流 INCR 计数误清" --linked-changes none --files src/auth.ts
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，不跳过
- QUICKLOG 记录的骨架由 CLI 接管：启动时 CLI 自动分配 ql-ID 并在
.sillyspec/quicklog/QUICKLOG-<user>.md 写「进行中」条目（含关联变更 tasks.md），--done 时 CLI 自动翻「已完成」+ 勾选 task + 回填文件路径。ql-ID 分配/状态/task 你无需手写，只需用注入的 <quicklog-id> 在模块文档变更索引引用
- QUICKLOG 落盘已结构化（
--done 后按需核对，多数无需手改）：CLI 已落盘结构化条目——标题从 --output 的「需求：」自动提取、正文四字段自动分行、文件行用 --file-notes 时为多行带括注。--done 后只需核对：标题弱才改（禁留 (quick 任务) 占位）；没用 --file-notes 时文件行是单行、可事后补括注（参照同文件早期丰富条目）；正文 需求：/根因：/方案：/结果： 四段按需充实（禁只留一段「结果：」）。一条 quick = 一条独立 ql，不追加到旧条目
- 收尾顺序（模块文档在
--done 前，QUICKLOG 在 --done 后，别记混）：① 命中模块→改模块文档→git add；② sillyspec run quick --done --change <id> --output "四字段" [--file-notes "..."]（CLI 自动翻完成 + 勾 task + 落盘 QUICKLOG 标题/文件/正文；若 --linked-changes 关联的真实变更其 tasks.md 已全部勾选且该变更未进入完整流程（进度库阶段停在 brainstorm 及之前），CLI 会自动将其归档到 changes/archive/；已走到 plan/execute/verify/archive 的变更不自动归档（tasks.md 全勾不等于流程收尾），须走原流程收尾）；③ 核对 QUICKLOG 标题（CLI 已从「需求：」提取并截断，写成短标题则无需改）→若改了再 git add
- 最后一步
--done 必须给全四字段（逐项一句话）：🔧 推荐四参数形式（CLI 自动合成结构化模板，无格式事故面）：--done --change <id> --req "一句语义化短标题" --cause "为什么改" --solution "怎么改的" --result "验证结果"。兼容旧形式 --output "需求：… 根因：… 方案：… 结果：…"（手拼须懂截断规则、禁嵌套全角冒号，缺字段被拒 exit 1）。这是 QUICKLOG「结果：」归档的唯一来源。--req 写一句语义化短标题（写「改了什么」，如「登录限流修复——INCR 计数误清」）——CLI 把它提取为 QUICKLOG 条目标题，截到首个标点、超 80 字截断；写完整需求长句会被截成语义不完整的状语前半段，需求背景放 --cause/--solution。前两个 step 的 --output 是中间摘要，不用此模板
- 禁止在没有运行 CLI 的情况下自行决定流程
用户指令
$ARGUMENTS
