sillyspec 2.7.0 → 3.1.0

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec
-description: "规范驱动开发工具包。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、explore、brainstorm、propose、plan、execute、verify、archive、status、handoff、resume、continue、quick、workspace。"
+description: "规范驱动开发工具包。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、explore、brainstorm、plan、execute、verify、archive、status、resume、continue、quick、workspace。"
 version: "2.0.0"
 ---
 
@@ -20,8 +20,8 @@ version: "2.0.0"
 ## 完整工作流
 
 ```
-绿地：init → brainstorm → propose → plan → execute → verify → archive
-棕地：scan → brainstorm → propose → plan → execute → verify → archive
+绿地：init → brainstorm → plan → execute → [verify] → archive
+棕地：scan → brainstorm → plan → execute → [verify] → archive
 工作区：workspace → (init/scan per project) → brainstorm → ...
 ```
 
@@ -32,11 +32,10 @@ version: "2.0.0"
 | `/sillyspec:init` | 绿地项目初始化 |
 | `/sillyspec:scan` | 棕地项目扫描（7 份文档） |
 | `/sillyspec:explore` | 自由思考模式 |
-| `/sillyspec:brainstorm` | 需求探索 |
-| `/sillyspec:propose` | 生成规范 |
+| `/sillyspec:brainstorm` | 需求探索+规范生成 |
 | `/sillyspec:plan` | 实现计划 |
 | `/sillyspec:execute` | TDD 执行 |
-| `/sillyspec:verify` | 验证 |
+| `/sillyspec:verify` | 验证（可选） |
 | `/sillyspec:archive` | 归档 |
 | `/sillyspec:status` | 查看进度 |
 | `/sillyspec:continue` | 自动下一步 |

package/package.json

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

package/src/init.js

@@ -175,27 +175,31 @@ function isTTY() {
 
 async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   // 创建基础目录
-  // 不预创建子目录，由各命令按需创建
   // .sillyspec/codebase/    → scan
+  // .sillyspec/codebase/details/ → scan (deep)
   // .sillyspec/changes/     → brainstorm/propose
   // .sillyspec/changes/archive/ → archive
+  // .sillyspec/quicklog/    → quick
+  // .sillyspec/knowledge/   → archive (spec 沉淀)
   // (plan 内容已合并到 tasks.md)
-  // .sillyspec/specs/        → propose
   if (isWorkspace) {
     mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
     mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
   }
 
-  // .gitignore — 确保 STATE.md 被忽略
   const gitignorePath = join(projectDir, '.gitignore');
-  const stateIgnoreRule = '.sillyspec/STATE.md';
+  const ignoreRules = ['.sillyspec/STATE.md', '.sillyspec/codebase/SCAN-RAW.md'];
   if (existsSync(gitignorePath)) {
     const content = readFileSync(gitignorePath, 'utf8');
-    if (!content.includes(stateIgnoreRule)) {
-      writeFileSync(gitignorePath, content.trimEnd() + '\n' + stateIgnoreRule + '\n');
+    let updated = content.trimEnd();
+    for (const rule of ignoreRules) {
+      if (!updated.includes(rule)) {
+        updated += '\n' + rule;
+      }
     }
+    writeFileSync(gitignorePath, updated + '\n');
   } else {
-    writeFileSync(gitignorePath, stateIgnoreRule + '\n');
+    writeFileSync(gitignorePath, ignoreRules.join('\n') + '\n');
   }
 
   // 生成文件

package/templates/archive.md

@@ -18,7 +18,7 @@ $ARGUMENTS
 
 读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
 
-- [ ] **文件完整性：** 检查 `proposal.md` 和 `design.md` 是否存在，缺失则警告
+- [ ] **文件完整性：** 检查 `design.md` 是否存在，缺失则警告
 - [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
   - ① 继续归档（未完成任务将被标记完成）
   - ② 取消，回去完成任务
@@ -35,7 +35,7 @@ $ARGUMENTS
 
 ### 3. Spec 沉淀
 
-将 `.sillyspec/changes/<change-name>/specs/` 下的设计文档**复制到 `.sillyspec/specs/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
+将 `.sillyspec/changes/<change-name>/` 下的设计文档**复制到 `.sillyspec/knowledge/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
 
 ### 4. 用户确认
 

package/templates/brainstorm.md

@@ -53,14 +53,14 @@ $ARGUMENTS
 cat .sillyspec/config.yaml 2>/dev/null
 ```
 
-**工作区模式：** AskUserQuestion 选子项目，加载子项目上下文 + 共享规范 + 工作区概览，设计文档保存到子项目 `.sillyspec/specs/`。
+**工作区模式：** AskUserQuestion 选子项目，加载子项目上下文 + 共享规范 + 工作区概览，设计文档保存到子项目 `.sillyspec/changes/`。
 
 **单项目模式：**
 ```bash
 cat .sillyspec/{PROJECT,REQUIREMENTS,ROADMAP}.md 2>/dev/null
 cat .sillyspec/codebase/{STRUCTURE,CONVENTIONS}.md 2>/dev/null
 ls .sillyspec/changes/ 2>/dev/null | grep -v archive
-ls .sillyspec/specs/ 2>/dev/null
+ls .sillyspec/knowledge/ 2>/dev/null
 ```
 
 ### Step 1.5: 协作与复用检查
@@ -126,18 +126,24 @@ git commit -m "docs: master change plan for <变更名>"
 
 ### Step 6: 写设计文档
 
-保存到 `.sillyspec/specs/YYYY-MM-DD-<topic>-design.md`：
+保存到 `.sillyspec/changes/<变更名>/design.md`：
 
 ```markdown
 # [Feature Name] 设计
 
-## 概述
-## 功能描述
+## 动机与范围
+（为什么做、范围边界、成功标准）
+
+## 功能需求
+（需求场景、验收标准）
+- [ ] 标准 1
+
 ## 技术方案
 ## 约束和假设
 ## 不在范围内
-## 验收标准
-- [ ] 标准 1
+## 文件变更
+## 代码风格参照
+（参考已有源文件，标注返回值类型、异常类型、注解风格）
 ```
 
 **注意：** 引用的表名必须来自 ARCHITECTURE.md 数据模型或明确标注"新增"。必须先读取 `.sillyspec/codebase/ARCHITECTURE.md`。
@@ -163,12 +169,7 @@ sillyspec status --json
 
 ### Step 9: 输出技术方案
 
-用户确认后，直接产出 `design.md` 写入 `.sillyspec/changes/<变更名>/design.md`。内容包含：
-- 架构决策及理由
-- 文件变更清单表格
-- 数据模型
-- API 设计
-- 代码风格参照（参考已有 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
+用户确认后，确认 design.md 已包含完整内容（动机、需求、方案、文件变更、代码风格参照）。如 Step 6 已保存则无需重复。
 
 ### Step 10: 更新 STATE.md
 

package/templates/continue.md

@@ -9,20 +9,16 @@
 
 ```
 1. 有进行中的变更？
-   1a. 无文件 → 提示完善 proposal
-   1b. 无 design.md → 提示补充 design
-   1c. 无 tasks.md → 执行 /sillyspec:propose
-   1d. tasks.md 有未完成项 + 有计划 → 执行 /sillyspec:execute
-   1e. tasks.md 全完成 + 未验证 → 执行 /sillyspec:verify
-   1f. 已验证通过 → 执行 /sillyspec:archive
+   1a. 无 design.md → 提示补充设计（/sillyspec:brainstorm）
+   1b. 无 tasks.md → 执行 /sillyspec:plan
+   1c. tasks.md 有未完成项 + 有计划 → 执行 /sillyspec:execute
+   1d. tasks.md 全完成 + 未验证 → 执行 /sillyspec:verify（可选）
+   1e. 已验证通过 → 执行 /sillyspec:archive
 
-2. 有设计文档但无对应变更？
-   → /sillyspec:propose <name>
-
-3. 有 .sillyspec/codebase/ 但无进行中工作？
+2. 有 .sillyspec/codebase/ 但无进行中工作？
    → /sillyspec:brainstorm "你的想法"
 
-4. 什么都没有？
+3. 什么都没有？
    → /sillyspec:init（新项目）或 /sillyspec:scan（棕地项目）
 ```
 

package/templates/execute.md

@@ -5,9 +5,6 @@
 - ❌ 跳过状态检查，自行推断阶段
 - ❌ 跳步执行（不允许跳过 plan 直接 execute）
 - ❌ 先写代码后补测试
-- ❌ "先写草稿回头再测"
-- ❌ 跳过测试因为"太简单"
-- ❌ 测试意外通过时不重写
 - ❌ 编造不存在的方法/注解/路径/类/字段
 - ❌ 自行补全缺失的接口/方法（应报告给用户）
 - ❌ 意外修改了计划外的文件却不报告
@@ -42,121 +39,78 @@ cat "$LATEST"/{tasks,design}.md 2>/dev/null
 cat .sillyspec/codebase/CONVENTIONS.md 2>/dev/null
 ```
 
-### 锚定确认（必须完成）
-
-确认实际存在的文件：
-```
-已读取并理解：
-- [x] plan — 实现计划和执行顺序
-- [x] tasks.md — 实现清单
-- [x] design.md — 技术方案和文件变更
-所有可用上下文已加载，开始执行。
-```
-
-如果 `$ARGUMENTS` 指定范围（如 `wave-1`、`task-3`），只执行对应部分。
+确认实际存在的文件，不存在的标注跳过。如果 `$ARGUMENTS` 指定范围（如 `wave-1`、`task-3`），只执行对应部分。
 
 ---
 
 ## 执行策略
 
-用 AskUserQuestion 询问用户选择执行模式：
-1. 串行执行 — 当前会话逐任务执行，适合简单变更
-2. 子代理并行 — 每个 Task 启动独立子代理，适合多任务独立变更（需要 subagent 能力）
+用 AskUserQuestion 询问用户选择：
+
+**1. 执行模式：**
+- 串行执行 — 当前会话逐任务执行，适合简单变更
+- 子代理并行 — 每个 Task 启动独立子代理，适合多任务独立变更
+
+**2. 确认频率：**
+- 每个任务确认 — 每完成一个 task 展示结果，等用户确认后继续
+- 每 N 个任务确认 — 每完成 N 个 task 汇总展示，用户一次性确认
+- AI 自主判断 — AI 在遇到歧义、风险、计划外变更时才询问，其余自动推进
+- 全自动 — 全部自动执行，不在中途打断用户
 
 选择子代理模式时：
 1. 按计划的 Wave 分组
 2. 每个 Task 启动独立子代理（不继承主 session 历史）
-3. 子代理上下文：任务描述 + TDD 纪律 + 精确文件路径 + 相关约定 + **要修改文件的当前源码** + **被调用类的源码**
-
-选择串行模式时：
-当前会话逐任务串行执行，每完成一个任务展示结果并等待用户确认。
-
-## 每个任务的 TDD 铁律
-
-```
-🔴 RED    → 先写测试，运行确认失败
-🟢 GREEN  → 写最少代码让测试通过
-🔵 REFACTOR → 清理，保持测试通过
-✅ COMMIT  → git 提交（测试文件必须包含在提交中）
-☑️ CHECK  → 勾选 tasks.md 中对应的 checkbox
-```
-
-**Git 提交：** 检查 Git 仓库 → `git add -A` → 生成 commit message → **用 AskUserQuestion 展示 commit message 给用户确认**：
-1. 确认提交 — 执行 `git commit`
-2. 修改提交信息 — 用户调整后重新确认
-3. 跳过提交 — 本任务不 commit（记录原因）
-
-用户确认后才执行 `git commit`。工作区模式下在子项目目录提交。
-
-**勾选 tasks：** 每个 Task 完成后，**必须立即**在 `.sillyspec/changes/<变更名>/tasks.md` 中将对应 checkbox 标记为 `[x]`，并附上完成时间：`- [x] [YYYY-MM-DD HH:MM:SS] 任务描述`。这是 Task 完成的最后一步，不允许跳过。
-
-**测试文件必须保留：** 测试是产出物，不是草稿。写完的测试文件必须保留在项目中，随代码一起 commit，不能删除。
+3. 子代理上下文：任务描述 + 相关约定 + 要修改文件和被调用类的源码
 
-**哪些任务可以跳过 TDD（不需要人工确认）：**
-- 纯配置文件（YAML、properties、.env、JSON 配置）
-- 纯数据文件（SQL seed、fixture）
-- 纯文档（README、注释）
+---
 
-**其他情况一律走 TDD：** Service、Controller、Mapper、组件、工具类、DTO（需要验证序列化/校验逻辑时）、API 接口 — 全部先写测试。
+## 每个任务的执行流程
 
-**违反 TDD → 删掉代码从测试重新开始。没有例外。**
+### 1. 先读后写
 
-## 写代码前必须读取现有源码（先读后写）
+写代码前，读取相关源文件确认风格和方法签名：
 
-**⛔ 铁律：**
-- 没有读过相关源文件，不允许写任何代码
-- 方法签名必须来自已有代码或 plan 中的明确定义，禁止凭空编造
-- 调用已有方法时，必须先 `cat` 源文件确认方法签名（参数、返回值、异常）
-- **调用任何已有方法前，必须 grep 确认方法存在**：
+```bash
+# 读取 CONVENTIONS
+cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+# 读取要修改的文件和同模块参考文件
+cat <要修改的文件路径>
+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 不到 → 不许调用，先查清楚或报告给用户。
 
-grep 不到 → 方法不存在或名字不同 → 不许调用，先查清楚。
+### 2. TDD
 
-```bash
-cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
 ```
-
-然后读取同模块已有代码（根据语言过滤）：
-```bash
-# Controller/Handler/Router
-find . \( -path "*/controller*" -o -path "*/handler*" -o -path "*/router*" -o -path "*/api*" \) \
-  -type f \( -name "*.java" -o -name "*.ts" -o -name "*.py" -o -name "*.go" \) \
-  -not -path "*/{node_modules,dist,.git,vendor,build}/*" | head -15
-# Service/Manager/Repository
-find . \( -name "*Service*" -o -name "*Manager*" -o -name "*UseCase*" -o -name "*Repository*" \) \
-  -type f \( -name "*.java" -o -name "*.ts" -o -name "*.py" -o -name "*.go" \) \
-  -not -path "*/{node_modules,dist,.git,vendor,build}/*" | head -15
+🔴 RED    → 写测试，运行确认失败
+🟢 GREEN  → 写最少代码让测试通过
+🔵 REFACTOR → 清理，保持测试通过
 ```
 
-**找不到相关代码时：**
-- 棕地项目 → 报告缺失，请用户提供参考路径
-- 绿地项目 → 靠 CONVENTIONS.md + ARCHITECTURE.md + brainstorm 设计方案驱动
+TDD 中间步骤（RED→GREEN→REFACTOR）连续执行，不需要每步等用户确认。
 
-## 两阶段审查
+**测试文件必须保留**，随代码一起 commit。违反 TDD → 删代码重来。
 
-每个任务完成后：
-- **A 规范合规：** tasks checkbox 完成？design 方案一致？测试有意义？
-- **B 代码质量：** DRY、YAGNI、死代码、错误处理、CONVENTIONS.md 合规？
+**可跳过 TDD（不需要确认）：** 纯配置（YAML/properties）、纯数据（SQL seed）、纯文档（README/注释）。
 
-**3 轮审查不通过 → 提交人工处理。**
+### 3. 勾选 tasks
 
-## 偏差处理
+完成后在 `.sillyspec/changes/<变更名>/tasks.md` 勾选对应 checkbox：`- [x] [YYYY-MM-DD HH:MM:SS] 任务描述`
+
+### 4. Git commit
 
-遇到问题：**停 → 报告 → 等人工确认。** 代码缺失、方法不存在、权限注解未知 → 先读已有代码确认风格，再问用户。
+`git add -A` → 生成 commit message → **根据用户选择的确认频率决定是否立即确认或批量确认**。
 
-## 自检门控
+---
+
+## 偏差处理
 
-- [ ] 完成任务与 plan 一致？
-- [ ] tasks.md 所有 checkbox 都已勾选为 `[x]`？
-- [ ] 未意外修改计划外文件？
-- [ ] 每个任务有 git commit？
-- [ ] 测试全部通过？
+遇到问题：**停 → 报告 → 等人工确认。** 代码缺失、方法不存在、计划外变更 → 先读已有代码，再问用户。
 
 ## 完成后
 
@@ -166,8 +120,7 @@ find . \( -name "*Service*" -o -name "*Manager*" -o -name "*UseCase*" -o -name "
 3. **继续开发** — 不结束当前阶段
 
 ```bash
-sillyspec status --json
-sillyspec next
+sillyspec status --json && sillyspec next
 ```
 
 更新 `.sillyspec/STATE.md`：阶段改为 `execute ✅` 或 `execute 🔄 (X/M)`，历史记录追加执行结果。

package/templates/explore.md

@@ -31,7 +31,7 @@ ls .sillyspec/changes/ 2>/dev/null | grep -v archive
 cat .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
 ```
 
-有进行中变更时读取其 proposal/design/tasks，自然引用。发现重要决策时可提议保存（不自动保存）。
+有进行中变更时读取其 design/tasks，自然引用。发现重要决策时可提议保存（不自动保存）。
 
 ## 没有必需的结束
 

package/templates/export.md

@@ -8,7 +8,7 @@
 
 ## 流程
 
-1. **读取变更文件：** `cat .sillyspec/changes/$ARGUMENTS/{proposal,design}.md specs/requirements.md 2>/dev/null`。不存在则报错。
+1. **读取变更文件：** `cat .sillyspec/changes/$ARGUMENTS/{design}.md 2>/dev/null`。不存在则报错。
 2. **清理为通用模板：** 移除项目特定信息，保留通用设计方案，添加 `notes.md` 使用建议。
 3. **导出：** `mkdir -p ~/.sillyspec/templates/<change-name>` 并复制文件。
 4. **确认：** 展示摘要和模板路径。

package/templates/plan.md

@@ -30,28 +30,26 @@ cat .sillyspec/config.yaml 2>/dev/null
 **单项目模式：**
 ```bash
 LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
-cat "$LATEST"/{proposal,design,tasks}.md 2>/dev/null
-cat "$LATEST/specs/requirements.md" 2>/dev/null
-cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE,STACK}.md 2>/dev/null
+cat "$LATEST"/{design,tasks}.md 2>/dev/null
+cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
 cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 ```
 
 ### 1.5 锚定确认（必须完成）
 
-确认实际存在的文件（proposal / design / tasks / requirements），不存在的标注跳过。
+确认实际存在的文件（design / tasks），不存在的标注跳过。
 
 ### 2. 逐任务展开
 
-把 tasks.md 每个 checkbox 展开为详细步骤，按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
+把 tasks.md 每个 checkbox 展开为任务描述，按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
 
-**每个 Task 必须包含：**
-- 精确文件路径
-- **精确方法签名**（参数类型、返回值类型、注解）— ❌ "实现用户创建接口" → ✅ `public Result<UserVO> createUser(@RequestBody @Valid UserDTO dto)`，参考 `RoleController.createRole`
-- 完整可运行的代码示例（不写"添加验证逻辑"这种模糊描述）
-- 涉及已有类调用时，标注"参考 `XxxService.java` 的 `xxx` 方法"
-- 新增方法必须列出方法签名，方法签名必须来自已有代码风格或 design.md
-- 运行命令和预期输出
-- TDD 步骤：🔴 写失败测试 → 🟢 写最少代码 → 🔵 重构 → ✅ commit
+**每个 Task 包含：**
+- 精确文件路径（修改哪个文件）
+- 任务描述（做什么，一两句话说清楚）
+- 涉及已有类调用时，标注参考文件（如"参考 `RoleController.createRole`）
+- 依赖关系
+
+**注意：不需要写精确方法签名和代码示例。** 方法签名和代码风格由 execute 阶段先读后写确认。plan 专注"做什么"，execute 负责"怎么做"。
 
 ### 3. 标注执行顺序
 
@@ -59,10 +57,8 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 ```markdown
 ### Wave 1（并行，无依赖）
 - [ ] 添加用户创建接口
-  - 修改: `UserController.java`
-  - 方法签名: `public Result<UserVO> createUser(@RequestBody @Valid UserDTO dto)`
+  - 修改: `UserController.java`、`UserService.java`
   - 参考: `RoleController.createRole`
-  - TDD: 🔴 测试 → 🟢 实现 → 🔵 重构
 
 - [ ] 添加角色创建接口
   - ...
@@ -79,13 +75,7 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 ### 5. 自检门控
 
 - [ ] 每个 task 有具体文件路径？
-- [ ] 每个 task 有验证命令和预期输出？
-- [ ] 标注了 Wave 和执行顺序？
-- [ ] 与 design.md 文件变更清单一致？
-
-```bash
-bash scripts/validate-plan.sh .sillyspec/changes/<当前变更目录> 2>/dev/null
-```
+- [ ] 标注了 Wave 和依赖关系？
 
 ### 6. 完成
 

package/templates/propose.md

@@ -28,7 +28,7 @@ $ARGUMENTS
 
 ```bash
 cat .sillyspec/changes/*/MASTER.md 2>/dev/null  # 子阶段变更
-ls -t .sillyspec/specs/*.md | head -1
+ls -t .sillyspec/knowledge/*.md | head -1
 cat .sillyspec/{REQUIREMENTS}.md .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
 ls .sillyspec/changes/ | grep -v archive
 ```
@@ -49,23 +49,19 @@ ls .sillyspec/changes/ | grep -v archive
 
 创建 `.sillyspec/changes/$ARGUMENTS/`：
 
-**`proposal.md`：** 动机、变更范围、不在范围内、可量化成功标准
-
-**`specs/requirements.md`：** 功能需求（REQ-001 格式）、Given/When/Then 用户场景、非功能需求
-
-**`design.md`：** 架构决策及理由、文件变更清单表格、数据模型、API 设计、**代码风格参照**（参考已有的 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
+**`design.md`：** 动机与范围、功能需求（REQ-001 格式、Given/When/Then 用户场景、非功能需求）、架构决策及理由、文件变更清单表格、数据模型、API 设计、**代码风格参照**（参考已有的 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
 
 **`tasks.md`：** 准备 → 实现 → 收尾的任务列表（每个 task 标注文件路径）
 
 ### 4. 展示关键文件
 
-展示 proposal.md 和 design.md 给用户审阅。tasks.md 只展示任务列表。
+展示 design.md 给用户审阅。tasks.md 只展示任务列表。
 
 ### 5. 自检门控
 
-- [ ] proposal.md 含"动机、变更范围、不在范围内、成功标准"？
+- [ ] design.md 含"动机、变更范围、功能需求"？
 - [ ] design.md 含"文件变更清单"表格？
-- [ ] requirements.md 含 Given/When/Then 用户场景？
+- [ ] design.md 含 Given/When/Then 用户场景？
 - [ ] tasks.md 每个 task 有文件路径？
 
 ```bash

package/templates/quick.md

@@ -36,12 +36,12 @@ $ARGUMENTS
 7. **Git commit：** 展示 commit message 给用户确认后提交
 8. **记录：**
    - **有 `--change`：** 在 `.sillyspec/changes/<变更名>/tasks.md` 追加 task 并勾选 `[x]`
-   - **无 `--change`：** 记录到 `.sillyspec/QUICKLOG.md`（见下方规则）
+   - **无 `--change`：** 记录到 `.sillyspec/quicklog/QUICKLOG.md`（见下方规则）
 9. **检查复杂度：** 任务比预期复杂 → 建议用完整流程
 
 ### QUICKLOG.md 规则
 
-文件路径：`.sillyspec/QUICKLOG.md`
+文件路径：`.sillyspec/quicklog/QUICKLOG.md`
 
 **追加记录格式：**
 ```markdown

package/templates/resume.md

@@ -22,8 +22,7 @@ cat .sillyspec/STATE.md 2>/dev/null
 ```bash
 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/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
+ls .sillyspec/codebase/*.md .sillyspec/codebase/details/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
 ```
 
 **探测结果推断：**
@@ -32,9 +31,9 @@ ls .sillyspec/codebase/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMEN
 |---|---|---|
 | 无 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
 | 有 SCAN-RAW.md 或 codebase 文档不全 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
-| codebase 7 份齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
+| codebase 文档齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
 | 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:brainstorm` |
-| changes/ 有 proposal 无 tasks | 待计划 | `/sillyspec:plan` |
+| changes/ 有 design 无 tasks | 待计划 | `/sillyspec:plan` |
 | tasks.md 有未完成 checkbox | 执行中 | `/sillyspec:execute` |
 | tasks.md 全完成 | 待验证 | `/sillyspec:verify` |
 

package/templates/scan.md

@@ -61,7 +61,7 @@ AskUserQuestion 依次确认：快速⚡/深度🔍、扫描范围（留空全
 
 **只读入口和配置文件，不读源码。** 生成 3 份文档到 `mkdir -p .sillyspec/codebase`：
 
-1. `STACK.md` — 技术栈
+1. `ARCHITECTURE.md` — 架构 + 技术栈（合并原 STACK.md）
 2. `STRUCTURE.md` — 目录结构
 3. `PROJECT.md` — 项目概览
 
@@ -191,8 +191,8 @@ bash scripts/scan-preprocess.sh [扫描区域] 2>/dev/null
 ### Step 1: 断点续扫
 
 ```bash
-for f in STACK ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS; do
-  [ -f ".sillyspec/codebase/${f}.md" ] && echo "✅ ${f}" || echo "⬜ ${f}"
+for f in ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS; do
+  [ -f ".sillyspec/codebase/${f}.md" ] || [ -f ".sillyspec/codebase/details/${f}.md" ] && echo "✅ ${f}" || echo "⬜ ${f}"
 done
 ```
 
@@ -202,18 +202,19 @@ done
 
 **不直接读原始源码。** 读 SCAN-RAW.md，按需深挖相关文件。
 
-按顺序生成 7 份文档（写完立即保存，中断不丢失）：
+按顺序生成文档（写完立即保存，中断不丢失）：
 
-1. `STACK.md` — 技术栈
-2. `ARCHITECTURE.md` — 架构（含数据模型摘要）
-3. `STRUCTURE.md` — 目录结构
-4. `CONVENTIONS.md` — 编码约定（含框架隐形规则、实体继承规范）
-5. `INTEGRATIONS.md` — 集成
-6. `TESTING.md` — 测试现状
-7. `CONCERNS.md` — 技术债务和风险
+1. `ARCHITECTURE.md` — 架构 + 技术栈 + 数据模型摘要（合并原 STACK.md）
+2. `CONVENTIONS.md` — 编码约定（含框架隐形规则、实体继承规范）
+3. `codebase/details/STRUCTURE.md` — 目录结构（深扫详情）
+4. `codebase/details/INTEGRATIONS.md` — 集成（深扫详情）
+5. `codebase/details/TESTING.md` — 测试现状（深扫详情）
+6. `codebase/details/CONCERNS.md` — 技术债务和风险（深扫详情）
 
 同时更新 `.sillyspec/PROJECT.md`。
 
+> **注意：** `SCAN-RAW.md` 是临时文件，扫描完成后可删除。
+
 ---
 
 ## 完成后
@@ -237,19 +238,19 @@ git commit -m "chore: sillyspec scan - codebase mapped"
 **路径校验：** 每份文档写完后检查必须在 `.sillyspec/codebase/` 下，误放则自动修正：
 
 ```bash
-for f in $(find . -maxdepth 2 -name "{ARCHITECTURE,STACK,STRUCTURE,CONVENTIONS,INTEGRATIONS,TESTING,CONCERNS,PROJECT,SCAN-RAW}.md" ! -path "./.sillyspec/codebase/*"); do
+for f in $(find . -maxdepth 2 -name "{ARCHITECTURE,STRUCTURE,CONVENTIONS,INTEGRATIONS,TESTING,CONCERNS,PROJECT,SCAN-RAW}.md" ! -path "./.sillyspec/codebase/*" ! -path "./.sillyspec/codebase/details/*"); do
   [ -f "$f" ] && mkdir -p .sillyspec/codebase && mv "$f" ".sillyspec/codebase/$(basename $f)"
 done
 ```
 
 **自检门控：**
-- [ ] STACK.md 含主要语言和框架？
-- [ ] ARCHITECTURE.md 描述了整体架构？
-- [ ] STRUCTURE.md 含目录结构？
+- [ ] ARCHITECTURE.md 含主要语言、框架和整体架构？
+- [ ] ARCHITECTURE.md 含数据模型摘要？（深扫）
+- [ ] STRUCTURE.md 含目录结构？（深扫，位于 details/）
 - [ ] CONVENTIONS.md 含编码约定？（深扫）
-- [ ] INTEGRATIONS.md 列出外部依赖？（深扫）
-- [ ] TESTING.md 描述测试状况？（深扫）
-- [ ] CONCERNS.md 列出技术债务？（深扫）
+- [ ] INTEGRATIONS.md 列出外部依赖？（深扫，位于 details/）
+- [ ] TESTING.md 描述测试状况？（深扫，位于 details/）
+- [ ] CONCERNS.md 列出技术债务？（深扫，位于 details/）
 - [ ] PROJECT.md 已生成？
 
 ```bash

package/templates/status.md

@@ -21,7 +21,7 @@ cat .sillyspec/config.yaml 2>/dev/null
 ### Step 2-5: 单项目检查
 
 1. **项目基础：** PROJECT.md、codebase 文档、REQUIREMENTS.md、ROADMAP.md
-2. **进行中变更：** 对每个变更检查 proposal/design/requirements/tasks 完成度
+2. **进行中变更：** 对每个变更检查 design/tasks 完成度
 3. **归档历史：** `ls .sillyspec/changes/archive/ | wc -l`
 4. **代码库文档：** `ls .sillyspec/codebase/`
 

package/templates/verify.md

@@ -25,7 +25,7 @@ sillyspec status --json
 
 ```bash
 LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
-cat "$LATEST"/{proposal,design,tasks}.md "$LATEST/specs/requirements.md" 2>/dev/null
+cat "$LATEST"/{design,tasks}.md 2>/dev/null
 ```
 
 锚定确认实际存在的文件。