sillyspec-quick

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                            # 输出当前步骤 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（程序化读取）

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

# 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

铁律

• 必须用 exec 工具（shell）执行 CLI，不要自己编造流程
• quick 直接在主工作区改代码（不创建 worktree），范围必须小且明确
• 完成后立即 --done，不跳过
• step 2 会创建 .sillyspec/quicklog/QUICKLOG-<user>.md 记录，完成前 CLI 会校验它存在
• 禁止在没有运行 CLI 的情况下自行决定流程

用户指令

$ARGUMENTS