sillyspec 2.6.1 → 3.0.0

package/.claude/commands/sillyspec/archive.md

@@ -18,7 +18,6 @@ $ARGUMENTS
 
 读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
 
-- [ ] **verify 状态：** 检查是否有验证记录，无则提示先执行 `/sillyspec:verify`
 - [ ] **文件完整性：** 检查 `proposal.md` 和 `design.md` 是否存在，缺失则警告
 - [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
   - ① 继续归档（未完成任务将被标记完成）

package/.claude/commands/sillyspec/brainstorm.md

@@ -1,8 +1,3 @@
----
-description: 需求探索 — 结构化头脑风暴，生成设计文档（创建性工作前必用）
-argument-hint: "[需求或想法描述]"
----
-
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
@@ -15,7 +10,7 @@ argument-hint: "[需求或想法描述]"
 - ❌ 在 checklist 未完成前开始写设计文档
 - ❌ 编造不存在的表名、字段名、API 端点
 - ❌ 一次性抛出多个问题（必须逐个等待回答）
-- ❌ 用户确认前自行推进到 propose 或任何后续阶段
+- ❌ 用户确认前自行推进到 plan 或任何后续阶段
 
 ## 状态检查（必须先执行）
 
@@ -42,9 +37,11 @@ $ARGUMENTS
 - [ ] **Step 5** — 分段展示设计，逐段确认
 - [ ] **Step 6** — 写设计文档并保存
 - [ ] **Step 7** — AI 自审（对照约束检查）
-- [ ] **Step 8** — 用户确认 → 调用 `/sillyspec:propose`
+- [ ] **Step 8** — 用户确认设计方案
+- [ ] **Step 9** — 输出 design.md
+- [ ] **Step 10** — 更新 STATE.md
 
-**终态：** brainstorm 完成后唯一出口是 `/sillyspec:propose`。不允许直接进入 execute、plan 或任何代码操作。
+**终态：** brainstorm 完成后唯一出口是 `/sillyspec:plan`。不允许直接进入 execute 或任何代码操作。
 
 ---
 
@@ -162,13 +159,20 @@ git commit -m "docs: master change plan for <变更名>"
 sillyspec status --json
 ```
 
-展示设计方案，AskUserQuestion：确认进入 propose / 需要修改 / 推翻重来。
+展示设计方案，AskUserQuestion：确认 / 需要修改 / 推翻重来。
+
+### Step 9: 输出技术方案
 
-用户确认 → `sillyspec next`，将 CLI 返回命令推荐给用户。
+用户确认后，直接产出 `design.md` 写入 `.sillyspec/changes/<变更名>/design.md`。内容包含：
+- 架构决策及理由
+- 文件变更清单表格
+- 数据模型
+- API 设计
+- 代码风格参照（参考已有 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
 
-### Step 9: 更新 STATE.md
+### Step 10: 更新 STATE.md
 
-自动更新 `.sillyspec/STATE.md`（不存在则创建）：当前变更、阶段、下一步、关键决策、历史记录。不需要 Git 提交。
+自动更新 `.sillyspec/STATE.md`（不存在则创建）：当前变更、阶段、下一步 `/sillyspec:plan`、关键决策、历史记录。不需要 Git 提交。
 
 ## 关键原则
 - YAGNI — 无情砍掉不需要的功能

package/.claude/commands/sillyspec/execute.md

@@ -36,7 +36,7 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 **单项目模式：**
 ```bash
-PLAN=$(ls -t .sillyspec/changes/*/plan.md 2>/dev/null | head -1); cat "$PLAN"
+PLAN=$(ls -t .sillyspec/changes/*/tasks.md 2>/dev/null | head -1); cat "$PLAN"
 LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
 cat "$LATEST"/{tasks,design}.md 2>/dev/null
 cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
@@ -81,9 +81,14 @@ cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
 ☑️ CHECK  → 勾选 tasks.md 中对应的 checkbox
 ```
 
-**Git 提交：** 检查 Git 仓库 → `git add -A && git commit`。工作区模式下在子项目目录提交。跳过不可提交的情况但记录在报告中。
+**Git 提交：** 检查 Git 仓库 → `git add -A` → 生成 commit message → **用 AskUserQuestion 展示 commit message 给用户确认**：
+1. 确认提交 — 执行 `git commit`
+2. 修改提交信息 — 用户调整后重新确认
+3. 跳过提交 — 本任务不 commit（记录原因）
 
-**勾选 tasks：** 每个 Task 完成后，**必须立即**在 `.sillyspec/changes/<变更名>/tasks.md` 中将对应 checkbox 标记为 `[x]`。这是 Task 完成的最后一步，不允许跳过。
+用户确认后才执行 `git commit`。工作区模式下在子项目目录提交。
+
+**勾选 tasks：** 每个 Task 完成后，**必须立即**在 `.sillyspec/changes/<变更名>/tasks.md` 中将对应 checkbox 标记为 `[x]`，并附上完成时间：`- [x] [YYYY-MM-DD HH:MM:SS] 任务描述`。这是 Task 完成的最后一步，不允许跳过。
 
 **测试文件必须保留：** 测试是产出物，不是草稿。写完的测试文件必须保留在项目中，随代码一起 commit，不能删除。
 
@@ -102,6 +107,16 @@ cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
 - 没有读过相关源文件，不允许写任何代码
 - 方法签名必须来自已有代码或 plan 中的明确定义，禁止凭空编造
 - 调用已有方法时，必须先 `cat` 源文件确认方法签名（参数、返回值、异常）
+- **调用任何已有方法前，必须 grep 确认方法存在**：
+
+```bash
+# 调用 userService.getById() 之前
+grep -rn "public.*getById" --include="*.java" src/main/java/**/service/
+# 调用 result.success() 之前
+grep -rn "public.*success" --include="*.java" src/main/java/**/common/
+```
+
+grep 不到 → 方法不存在或名字不同 → 不许调用，先查清楚。
 
 ```bash
 cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
@@ -145,6 +160,11 @@ find . \( -name "*Service*" -o -name "*Manager*" -o -name "*UseCase*" -o -name "
 
 ## 完成后
 
+所有任务完成后，用 AskUserQuestion 询问用户下一步：
+1. **验证** — 执行 `/sillyspec:verify` 全面验证
+2. **归档** — 跳过 verify，执行 `/sillyspec:archive`
+3. **继续开发** — 不结束当前阶段
+
 ```bash
 sillyspec status --json
 sillyspec next

package/.claude/commands/sillyspec/plan.md

@@ -42,7 +42,7 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 ### 2. 逐任务展开
 
-把 tasks.md 每个 checkbox 展开为详细步骤。工作区模式下每个 Task 标注所属项目。
+把 tasks.md 每个 checkbox 展开为详细步骤，按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
 
 **每个 Task 必须包含：**
 - 精确文件路径
@@ -57,20 +57,31 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 按 Wave 分组，标注依赖关系：
 ```markdown
-**Wave 1**（并行，无依赖）：Task 1, Task 2
-**Wave 2**（依赖 Wave 1）：Task 3
+### Wave 1（并行，无依赖）
+- [ ] 添加用户创建接口
+  - 修改: `UserController.java`
+  - 方法签名: `public Result<UserVO> createUser(@RequestBody @Valid UserDTO dto)`
+  - 参考: `RoleController.createRole`
+  - TDD: 🔴 测试 → 🟢 实现 → 🔵 重构
+
+- [ ] 添加角色创建接口
+  - ...
+
+### Wave 2（依赖 Wave 1）
+- [ ] 添加用户列表查询（依赖用户创建完成）
+  - ...
 ```
 
 ### 4. 保存
 
-保存到 `.sillyspec/changes/<变更名>/plan.md`
+**直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
 
 ### 5. 自检门控
 
 - [ ] 每个 task 有具体文件路径？
 - [ ] 每个 task 有验证命令和预期输出？
 - [ ] 标注了 Wave 和执行顺序？
-- [ ] plan 与 design.md 文件变更清单一致？
+- [ ] 与 design.md 文件变更清单一致？
 
 ```bash
 bash scripts/validate-plan.sh .sillyspec/changes/<当前变更目录> 2>/dev/null

package/.claude/commands/sillyspec/propose.md

@@ -1,6 +1,8 @@
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
+> **提示：** 通常不需要单独执行 propose。brainstorm 阶段会自动产出 design.md。仅当需求已经明确、跳过 brainstorm 时才手动执行 propose。
+
 ## 核心约束（必须遵守）
 - ❌ 写实现代码
 - ❌ tasks.md 写具体步骤（只列任务名）

package/.claude/commands/sillyspec/quick.md

@@ -1,8 +1,3 @@
----
-description: 快速任务 — 跳过完整流程，直接做
-argument-hint: "[任务描述]"
----
-
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
@@ -11,6 +6,11 @@ argument-hint: "[任务描述]"
 - ❌ 修改无关文件
 - ❌ 跳过测试因为"任务太简单"
 
+## 用法
+
+- `/sillyspec:quick "修复用户创建接口漏了手机号校验"` — 独立记录到 QUICKLOG.md
+- `/sillyspec:quick --change user-module "修复用户创建接口漏了手机号校验"` — 追加到 user-module 变更的 tasks.md
+
 ## 任务
 $ARGUMENTS
 
@@ -18,10 +18,39 @@ $ARGUMENTS
 
 ## 流程
 
-1. **理解任务：** 模糊则问一个问题确认
-2. **加载最小上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
-3. **TDD 执行：** 🔴 写失败测试 → 🟢 写最少代码 → 🔵 重构
-4. **运行相关测试：** `pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null`
-5. **Git commit：** `git add -A && git commit -m "fix: $ARGUMENTS"`
+1. **解析参数：** 检查是否携带 `--change <变更名>`，确定记录方式
+2. **理解任务：** 模糊则问一个问题确认
+3. **加载上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
+4. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
+5. **TDD 执行：**
+   ```
+   🔴 RED    → 先写测试，运行确认失败
+   🟢 GREEN  → 写最少代码让测试通过
+   🔵 REFACTOR → 清理，保持测试通过
+   ✅ COMMIT  → git 提交（测试文件必须包含在提交中）
+   ```
+   测试文件必须保留在项目中，不能删除。违反 TDD → 删掉代码从测试重新开始。
+   - 纯配置/数据/文档可跳过 TDD
+   - 其他情况一律走 TDD
+6. **运行相关测试：** `pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null`
+7. **Git commit：** 展示 commit message 给用户确认后提交
+8. **记录：**
+   - **有 `--change`：** 在 `.sillyspec/changes/<变更名>/tasks.md` 追加 task 并勾选 `[x]`
+   - **无 `--change`：** 记录到 `.sillyspec/QUICKLOG.md`（见下方规则）
+9. **检查复杂度：** 任务比预期复杂 → 建议用完整流程
+
+### QUICKLOG.md 规则
+
+文件路径：`.sillyspec/QUICKLOG.md`
+
+**追加记录格式：**
+```markdown
+## YYYY-MM-DD HH:MM:SS | fix: 任务描述
+- 文件：`修改的文件列表`
+- commit：`commit hash`
+- 关联归档：`相关的已归档变更名`（如有）
+```
 
-如果任务比预期复杂 → 停下来建议用完整流程。
+**文件轮转：** 追加前检查文件大小，超过 500 行则：
+1. 将当前 `QUICKLOG.md` 重命名为 `QUICKLOG-YYYY-MM-DD.md`
+2. 创建新的空 `QUICKLOG.md`

package/.claude/commands/sillyspec/resume.md

@@ -23,7 +23,7 @@ cat .sillyspec/STATE.md 2>/dev/null
 ls .sillyspec/changes/*/MASTER.md 2>/dev/null
 ls -d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
 ls .sillyspec/changes/*/stages/*/proposal.md 2>/dev/null
-ls .sillyspec/codebase/*.md .sillyspec/changes/*/plan.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
+ls .sillyspec/codebase/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
 ```
 
 **探测结果推断：**
@@ -33,7 +33,7 @@ ls .sillyspec/codebase/*.md .sillyspec/changes/*/plan.md .sillyspec/{REQUIREMENT
 | 无 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
 | 有 SCAN-RAW.md 或 codebase 文档不全 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
 | codebase 7 份齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
-| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:propose` |
+| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:brainstorm` |
 | changes/ 有 proposal 无 tasks | 待计划 | `/sillyspec:plan` |
 | tasks.md 有未完成 checkbox | 执行中 | `/sillyspec:execute` |
 | tasks.md 全完成 | 待验证 | `/sillyspec:verify` |

package/.claude/commands/sillyspec/scan.md

@@ -49,7 +49,7 @@ ls .sillyspec/codebase/ 2>/dev/null
 
 ### Step 3-5: 扫描模式、范围、排除目录
 
-AskUserQuestion 依次确认：快速⚡/深度🔍、扫描范围（留空全量）、排除目录。
+AskUserQuestion 依次确认：快速⚡/深度🔍、扫描范围（留空全量）、排除目录（默认选中 `node_modules`、`.git`、`dist`、`build`、`vendor`、`target`、`__pycache__`、`.next`、`coverage`、`.nuxt`，用户可调整）。
 
 ### Step 6: 确认并开始
 

package/.claude/commands/sillyspec/verify.md

@@ -1,11 +1,8 @@
----
-description: 验证实现 — 对照规范检查 + 测试套件
-argument-hint: "[可选：指定验证范围]"
----
-
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
+> **可选阶段。** execute 完成后会询问是否需要 verify，也可以手动调用。
+
 ## 核心约束（必须遵守）
 - ❌ 修改任何代码（只做检查和报告）
 - ❌ 跳过状态检查

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "2.6.1",
+  "version": "3.0.0",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "type": "module",
   "bin": {

package/src/init.js

@@ -179,7 +179,7 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   // .sillyspec/codebase/    → scan
   // .sillyspec/changes/     → brainstorm/propose
   // .sillyspec/changes/archive/ → archive
-  // .sillyspec/plans/        → plan
+  // (plan 内容已合并到 tasks.md)
   // .sillyspec/specs/        → propose
   if (isWorkspace) {
     mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });

package/templates/archive.md

@@ -18,7 +18,6 @@ $ARGUMENTS
 
 读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
 
-- [ ] **verify 状态：** 检查是否有验证记录，无则提示先执行 `/sillyspec:verify`
 - [ ] **文件完整性：** 检查 `proposal.md` 和 `design.md` 是否存在，缺失则警告
 - [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
   - ① 继续归档（未完成任务将被标记完成）

package/templates/brainstorm.md

@@ -10,7 +10,7 @@
 - ❌ 在 checklist 未完成前开始写设计文档
 - ❌ 编造不存在的表名、字段名、API 端点
 - ❌ 一次性抛出多个问题（必须逐个等待回答）
-- ❌ 用户确认前自行推进到 propose 或任何后续阶段
+- ❌ 用户确认前自行推进到 plan 或任何后续阶段
 
 ## 状态检查（必须先执行）
 
@@ -37,9 +37,11 @@ $ARGUMENTS
 - [ ] **Step 5** — 分段展示设计，逐段确认
 - [ ] **Step 6** — 写设计文档并保存
 - [ ] **Step 7** — AI 自审（对照约束检查）
-- [ ] **Step 8** — 用户确认 → 调用 `/sillyspec:propose`
+- [ ] **Step 8** — 用户确认设计方案
+- [ ] **Step 9** — 输出 design.md
+- [ ] **Step 10** — 更新 STATE.md
 
-**终态：** brainstorm 完成后唯一出口是 `/sillyspec:propose`。不允许直接进入 execute、plan 或任何代码操作。
+**终态：** brainstorm 完成后唯一出口是 `/sillyspec:plan`。不允许直接进入 execute 或任何代码操作。
 
 ---
 
@@ -157,13 +159,20 @@ git commit -m "docs: master change plan for <变更名>"
 sillyspec status --json
 ```
 
-展示设计方案，AskUserQuestion：确认进入 propose / 需要修改 / 推翻重来。
+展示设计方案，AskUserQuestion：确认 / 需要修改 / 推翻重来。
 
-用户确认 → `sillyspec next`，将 CLI 返回命令推荐给用户。
+### Step 9: 输出技术方案
 
-### Step 9: 更新 STATE.md
+用户确认后，直接产出 `design.md` 写入 `.sillyspec/changes/<变更名>/design.md`。内容包含：
+- 架构决策及理由
+- 文件变更清单表格
+- 数据模型
+- API 设计
+- 代码风格参照（参考已有 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
 
-自动更新 `.sillyspec/STATE.md`（不存在则创建）：当前变更、阶段、下一步、关键决策、历史记录。不需要 Git 提交。
+### Step 10: 更新 STATE.md
+
+自动更新 `.sillyspec/STATE.md`（不存在则创建）：当前变更、阶段、下一步 `/sillyspec:plan`、关键决策、历史记录。不需要 Git 提交。
 
 ## 关键原则
 - YAGNI — 无情砍掉不需要的功能

package/templates/execute.md

@@ -36,7 +36,7 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 **单项目模式：**
 ```bash
-PLAN=$(ls -t .sillyspec/changes/*/plan.md 2>/dev/null | head -1); cat "$PLAN"
+PLAN=$(ls -t .sillyspec/changes/*/tasks.md 2>/dev/null | head -1); cat "$PLAN"
 LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
 cat "$LATEST"/{tasks,design}.md 2>/dev/null
 cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
@@ -81,9 +81,14 @@ cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
 ☑️ CHECK  → 勾选 tasks.md 中对应的 checkbox
 ```
 
-**Git 提交：** 检查 Git 仓库 → `git add -A && git commit`。工作区模式下在子项目目录提交。跳过不可提交的情况但记录在报告中。
+**Git 提交：** 检查 Git 仓库 → `git add -A` → 生成 commit message → **用 AskUserQuestion 展示 commit message 给用户确认**：
+1. 确认提交 — 执行 `git commit`
+2. 修改提交信息 — 用户调整后重新确认
+3. 跳过提交 — 本任务不 commit（记录原因）
 
-**勾选 tasks：** 每个 Task 完成后，**必须立即**在 `.sillyspec/changes/<变更名>/tasks.md` 中将对应 checkbox 标记为 `[x]`。这是 Task 完成的最后一步，不允许跳过。
+用户确认后才执行 `git commit`。工作区模式下在子项目目录提交。
+
+**勾选 tasks：** 每个 Task 完成后，**必须立即**在 `.sillyspec/changes/<变更名>/tasks.md` 中将对应 checkbox 标记为 `[x]`，并附上完成时间：`- [x] [YYYY-MM-DD HH:MM:SS] 任务描述`。这是 Task 完成的最后一步，不允许跳过。
 
 **测试文件必须保留：** 测试是产出物，不是草稿。写完的测试文件必须保留在项目中，随代码一起 commit，不能删除。
 
@@ -102,6 +107,16 @@ cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
 - 没有读过相关源文件，不允许写任何代码
 - 方法签名必须来自已有代码或 plan 中的明确定义，禁止凭空编造
 - 调用已有方法时，必须先 `cat` 源文件确认方法签名（参数、返回值、异常）
+- **调用任何已有方法前，必须 grep 确认方法存在**：
+
+```bash
+# 调用 userService.getById() 之前
+grep -rn "public.*getById" --include="*.java" src/main/java/**/service/
+# 调用 result.success() 之前
+grep -rn "public.*success" --include="*.java" src/main/java/**/common/
+```
+
+grep 不到 → 方法不存在或名字不同 → 不许调用，先查清楚。
 
 ```bash
 cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
@@ -145,6 +160,11 @@ find . \( -name "*Service*" -o -name "*Manager*" -o -name "*UseCase*" -o -name "
 
 ## 完成后
 
+所有任务完成后，用 AskUserQuestion 询问用户下一步：
+1. **验证** — 执行 `/sillyspec:verify` 全面验证
+2. **归档** — 跳过 verify，执行 `/sillyspec:archive`
+3. **继续开发** — 不结束当前阶段
+
 ```bash
 sillyspec status --json
 sillyspec next

package/templates/plan.md

@@ -42,7 +42,7 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 ### 2. 逐任务展开
 
-把 tasks.md 每个 checkbox 展开为详细步骤。工作区模式下每个 Task 标注所属项目。
+把 tasks.md 每个 checkbox 展开为详细步骤，按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
 
 **每个 Task 必须包含：**
 - 精确文件路径
@@ -57,20 +57,31 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 按 Wave 分组，标注依赖关系：
 ```markdown
-**Wave 1**（并行，无依赖）：Task 1, Task 2
-**Wave 2**（依赖 Wave 1）：Task 3
+### Wave 1（并行，无依赖）
+- [ ] 添加用户创建接口
+  - 修改: `UserController.java`
+  - 方法签名: `public Result<UserVO> createUser(@RequestBody @Valid UserDTO dto)`
+  - 参考: `RoleController.createRole`
+  - TDD: 🔴 测试 → 🟢 实现 → 🔵 重构
+
+- [ ] 添加角色创建接口
+  - ...
+
+### Wave 2（依赖 Wave 1）
+- [ ] 添加用户列表查询（依赖用户创建完成）
+  - ...
 ```
 
 ### 4. 保存
 
-保存到 `.sillyspec/changes/<变更名>/plan.md`
+**直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
 
 ### 5. 自检门控
 
 - [ ] 每个 task 有具体文件路径？
 - [ ] 每个 task 有验证命令和预期输出？
 - [ ] 标注了 Wave 和执行顺序？
-- [ ] plan 与 design.md 文件变更清单一致？
+- [ ] 与 design.md 文件变更清单一致？
 
 ```bash
 bash scripts/validate-plan.sh .sillyspec/changes/<当前变更目录> 2>/dev/null

package/templates/propose.md

@@ -1,6 +1,8 @@
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
+> **提示：** 通常不需要单独执行 propose。brainstorm 阶段会自动产出 design.md。仅当需求已经明确、跳过 brainstorm 时才手动执行 propose。
+
 ## 核心约束（必须遵守）
 - ❌ 写实现代码
 - ❌ tasks.md 写具体步骤（只列任务名）

package/templates/quick.md

@@ -6,6 +6,11 @@
 - ❌ 修改无关文件
 - ❌ 跳过测试因为"任务太简单"
 
+## 用法
+
+- `/sillyspec:quick "修复用户创建接口漏了手机号校验"` — 独立记录到 QUICKLOG.md
+- `/sillyspec:quick --change user-module "修复用户创建接口漏了手机号校验"` — 追加到 user-module 变更的 tasks.md
+
 ## 任务
 $ARGUMENTS
 
@@ -13,10 +18,39 @@ $ARGUMENTS
 
 ## 流程
 
-1. **理解任务：** 模糊则问一个问题确认
-2. **加载最小上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
-3. **TDD 执行：** 🔴 写失败测试 → 🟢 写最少代码 → 🔵 重构
-4. **运行相关测试：** `pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null`
-5. **Git commit：** `git add -A && git commit -m "fix: $ARGUMENTS"`
+1. **解析参数：** 检查是否携带 `--change <变更名>`，确定记录方式
+2. **理解任务：** 模糊则问一个问题确认
+3. **加载上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
+4. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
+5. **TDD 执行：**
+   ```
+   🔴 RED    → 先写测试，运行确认失败
+   🟢 GREEN  → 写最少代码让测试通过
+   🔵 REFACTOR → 清理，保持测试通过
+   ✅ COMMIT  → git 提交（测试文件必须包含在提交中）
+   ```
+   测试文件必须保留在项目中，不能删除。违反 TDD → 删掉代码从测试重新开始。
+   - 纯配置/数据/文档可跳过 TDD
+   - 其他情况一律走 TDD
+6. **运行相关测试：** `pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null`
+7. **Git commit：** 展示 commit message 给用户确认后提交
+8. **记录：**
+   - **有 `--change`：** 在 `.sillyspec/changes/<变更名>/tasks.md` 追加 task 并勾选 `[x]`
+   - **无 `--change`：** 记录到 `.sillyspec/QUICKLOG.md`（见下方规则）
+9. **检查复杂度：** 任务比预期复杂 → 建议用完整流程
+
+### QUICKLOG.md 规则
+
+文件路径：`.sillyspec/QUICKLOG.md`
+
+**追加记录格式：**
+```markdown
+## YYYY-MM-DD HH:MM:SS | fix: 任务描述
+- 文件：`修改的文件列表`
+- commit：`commit hash`
+- 关联归档：`相关的已归档变更名`（如有）
+```
 
-如果任务比预期复杂 → 停下来建议用完整流程。
+**文件轮转：** 追加前检查文件大小，超过 500 行则：
+1. 将当前 `QUICKLOG.md` 重命名为 `QUICKLOG-YYYY-MM-DD.md`
+2. 创建新的空 `QUICKLOG.md`

package/templates/resume.md

@@ -23,7 +23,7 @@ cat .sillyspec/STATE.md 2>/dev/null
 ls .sillyspec/changes/*/MASTER.md 2>/dev/null
 ls -d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
 ls .sillyspec/changes/*/stages/*/proposal.md 2>/dev/null
-ls .sillyspec/codebase/*.md .sillyspec/changes/*/plan.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
+ls .sillyspec/codebase/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
 ```
 
 **探测结果推断：**
@@ -33,7 +33,7 @@ ls .sillyspec/codebase/*.md .sillyspec/changes/*/plan.md .sillyspec/{REQUIREMENT
 | 无 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
 | 有 SCAN-RAW.md 或 codebase 文档不全 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
 | codebase 7 份齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
-| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:propose` |
+| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:brainstorm` |
 | changes/ 有 proposal 无 tasks | 待计划 | `/sillyspec:plan` |
 | tasks.md 有未完成 checkbox | 执行中 | `/sillyspec:execute` |
 | tasks.md 全完成 | 待验证 | `/sillyspec:verify` |

package/templates/scan.md

@@ -49,7 +49,7 @@ ls .sillyspec/codebase/ 2>/dev/null
 
 ### Step 3-5: 扫描模式、范围、排除目录
 
-AskUserQuestion 依次确认：快速⚡/深度🔍、扫描范围（留空全量）、排除目录。
+AskUserQuestion 依次确认：快速⚡/深度🔍、扫描范围（留空全量）、排除目录（默认选中 `node_modules`、`.git`、`dist`、`build`、`vendor`、`target`、`__pycache__`、`.next`、`coverage`、`.nuxt`，用户可调整）。
 
 ### Step 6: 确认并开始
 

package/templates/verify.md

@@ -1,6 +1,8 @@
 ## 交互规范
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
+> **可选阶段。** execute 完成后会询问是否需要 verify，也可以手动调用。
+
 ## 核心约束（必须遵守）
 - ❌ 修改任何代码（只做检查和报告）
 - ❌ 跳过状态检查