sillyspec 3.20.2 → 3.20.3

package/src/stages/propose.js

@@ -1,8 +1,3 @@
-/**
- * @deprecated propose 阶段已移除入口（2026-06-14）。
- * brainstorm 现在拥有四件套（design/proposal/requirements/tasks）的生成职责。
- * 本文件保留以备未来需要恢复，但未注册到 stageRegistry。
- */
 export const definition = {
   name: 'propose',
   title: '方案设计',
@@ -31,14 +26,8 @@ export const definition = {
 2. 读取最新设计文档、需求文档、代码库约定
 3. 如果是子阶段变更，读取 MASTER.md 和前序阶段设计
 
-### 模块文档加载
-4. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
-5. 根据当前提案初步判断涉及的模块（匹配提案中的文件路径到 _module-map.yaml 的 paths）
-6. 读取匹配到的 \`.sillyspec/docs/<project>/modules/<module>.md\`
-7. 如果发现提案中的变更范围与某个模块文档描述的当前设计存在潜在冲突，在后续提案中明确标注并说明处理方案
-
 ### 输出
-已加载的文件列表（含模块文档）`,
+已加载的文件列表`,
       outputHint: '文件列表',
       optional: false
     },
@@ -74,63 +63,19 @@ export const definition = {
     },
     {
       name: '生成规范文件',
-      prompt: `在 \`.sillyspec/changes/<change-name>/\` 下生成四个文件。
-
-**⚠️ 路径注意：<change-name> 是变更目录名（如 \`2026-05-28-agent-log-streaming\`），直接放在 \`.sillyspec/changes/\` 下，不要加额外的子目录层级。正确路径示例：\`.sillyspec/changes/2026-05-28-agent-log-streaming/proposal.md\`**
-
-### proposal.md 格式要求
-- **动机**：为什么做、解决什么核心问题
-- **关键问题**：为什么现有方案不够（展开 2-3 个具体痛点）
-- **变更范围**：本次做什么
-- **不在范围内**（显式清单）：不做 X、不做 Y
-- **成功标准**（可验证条件）：旧配置默认行为不变、新功能配置后可用
-
-### requirements.md 格式要求
-- **角色表**：涉及的角色和说明
-- **FR 编号需求**：FR-01、FR-02 ... 每条需求用 Given/When/Then 格式
-- **每个边界条件**独立 GWT 块
-- **非功能需求**：兼容性、可回退、可测试、可扩展
-
-### design.md 格式要求
-
-**必须包含的章节：**
-1. **背景**：为什么做、解决什么问题
-2. **设计目标**：要达成什么
-3. **非目标**：明确不做的事（防止 scope creep）
-4. **总体方案**：技术方案（分 Phase/Wave）
-5. **文件变更清单**（必填）：
-
-| 操作 | 文件路径 | 说明 |
-|---|---|---|
-| 新增 | src/xxx/NewFile.java | ... |
-| 修改 | src/xxx/ExistingFile.java | 新增 xx 方法 |
-
-6. **接口定义**：方法签名、数据结构（代码类任务必填）
-7. **数据模型**（如涉及）：表结构/字段变更
-8. **兼容策略**（brownfield 必填）：未配置新功能时行为不变、新旧逻辑的回退路径
-9. **风险登记**：
-
-| 编号 | 风险 | 等级 | 应对策略 |
-|---|---|---|---|
-| R-01 | ... | P0/P1/P2 | ... |
-
-10. **自审**：需求覆盖、约束一致性、真实性、YAGNI、验收标准、非目标清晰、兼容策略、风险识别
-
-### tasks.md 格式要求
-- 任务列表（只列名称，不展开步骤）
-- 每个 task 附文件路径
+      prompt: `在 \`.sillyspec/changes/<变更名>/\` 下生成四个文件。
 
 ### 操作
-1. 生成 proposal.md
-2. 生成 requirements.md
-3. 生成 design.md
-4. 生成 tasks.md
+1. 生成 proposal.md：动机、变更范围、不在范围内、成功标准
+2. 生成 requirements.md：功能需求、用户场景（Given/When/Then）、非功能需求
+3. 生成 design.md：架构决策、文件变更清单、数据模型、API 设计、代码风格参照
+4. 生成 tasks.md：任务列表（只列名称，不展开步骤）
 
 ### 输出
 四个文件路径
 
 ### 注意
-- 表名/字段名/类名必须来自真实代码或标注"新增"
+- 表名/字段名必须来自真实 schema 或标注"新增"
 - 用户场景必须用 Given/When/Then 格式
 - tasks.md 只列任务名，细节在 plan 阶段展开`,
       outputHint: '四个文件路径',
@@ -142,21 +87,17 @@ export const definition = {
 
 ### 操作
 检查以下各项：
-- [ ] proposal.md 有动机、关键问题、变更范围、不在范围内、成功标准
-- [ ] design.md 有背景、设计目标、非目标
+- [ ] proposal.md 有动机、变更范围、不在范围内、成功标准
 - [ ] design.md 有文件变更清单表格
-- [ ] design.md 有兼容策略（brownfield 时）
-- [ ] design.md 有风险登记表格
-- [ ] design.md 有自审
-- [ ] requirements.md 有角色表
-- [ ] requirements.md 有 FR 编号和 Given/When/Then 用户场景
+- [ ] requirements.md 有 Given/When/Then 用户场景
 - [ ] tasks.md 每个 task 有文件路径
 
 任何不通过 → 修正后重新检查。
 
 ### 输出
 自检通过/不通过`,
-
+      outputHint: '自检结果',
+      optional: false
     },
     {
       name: '展示并更新进度',

package/src/stages/quick.js

@@ -14,42 +14,17 @@ export const definition = {
 3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
 4. 加载上下文：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
 5. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
-6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<change-name>/design.md 2>/dev/null\`（理解设计意图）
+6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<变更名>/design.md 2>/dev/null\`（理解设计意图）
 7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
 
-### 模块文档加载
-8. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
-9. 根据任务描述初步判断可能涉及的模块
-10. 读取匹配到的 \`.sillyspec/docs/<project>/modules/<module>.md\`
-
-### 创建任务记录（⛔ 此步骤不能跳过，没有 quicklog 记录 = 未完成）
-理解完任务后，**必须**立即创建记录文件，再输出任何其他内容：
-1. 使用预注入的 git 用户名：\`<git-user>\`
-2. 无 \`--change\`：创建 .sillyspec/quicklog/QUICKLOG-\`<git-user>\`.md\`（已存在则追加），写入：
-   \`\`\`
-   ## ql-<YYYYMMDD>-<NNN>-<XXXX> | <now-datetime> | <一句话任务描述>
-   状态：进行中
-   文件：<预估要改的文件>
-   \`\`\`
-   - ID 格式：\`ql-YYYYMMDD-NNN-XXXX\`
-   - \`XXXX\` 是 4 位随机十六进制字符（如 a3f2、b7c1、00ef），**不是描述词缩写**
-   - 追加前扫描文件中已有的 \`ql-<当天日期>-\` 前缀的最大序号，+1 作为新序号
-   - 每天从 001 开始，跨日重新计数
-   - 此 ID 可被 design.md / plan.md / archive / module 变更索引引用
-3. 有 \`--change\`：在 \`.sillyspec/changes/<change-name>/tasks.md\` 追加未勾选的 task
-
-这样 Gate 检测到 .sillyspec/\` 下有变更，就不会拦截后续的代码修改。
-
 ### 输出
-quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上下文摘要
-
-⚠️ **先创建 quicklog，再输出任务理解。** 如果 quicklog 未创建，CLI post-check 会报 warning。`,
+任务理解 + 上下文摘要`,
       outputHint: '任务理解',
       optional: false
     },
     {
       name: '实现并验证',
-      prompt: `直接在主工作区实现任务。
+      prompt: `实现任务。
 
 ### 操作
 1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
@@ -68,34 +43,20 @@ quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上
       optional: false
     },
     {
-      name: '暂存和更新记录',
-      prompt: `Git 暂存并更新任务记录。
+      name: '暂存和记录',
+      prompt: `Git 暂存并记录任务。
 
 ### 操作
-1. 查看 \`git status --porcelain\`，确认只包含本次 quick 相关文件
-2. 使用 \`git add -- <file...>\` 暂存本次 quick 实际修改的文件（不要 commit，由用户通过统一提交工具处理）
-   - 禁止使用 \`git add -A\`
-   - 不要暂存 quick 开始前就已存在的无关改动
-3. 更新 Step 1 创建的记录：
-   - 无 \`--change\`：找到对应 ql-ID 的条目，将「状态：进行中」改为「状态：已完成」，补充实际改动文件和结果摘要
-   - 有 \`--change\`：勾选 tasks.md 中对应的 task checkbox
-4. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`（日期取最后一条记录的日期）。新文件从空开始，ql-ID 需扫描同目录所有 QUICKLOG 文件中当天最大序号 +1
-5. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
-6. 任务比预期复杂 → 建议用完整流程
-
-### 模块文档同步
-7. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
-8. 对比本次修改的文件（\`git diff --name-only HEAD\`）与模块映射
-9. 如果命中模块 → 直接同步模块文档：
-   - 读取对应的 \`.sillyspec/docs/<project>/modules/<module>.md\`（如不存在则新建）
-   - 根据本次改动内容更新模块文档（正文描述当前状态，底部变更索引追加本次 ql-ID）
-   - 变更索引格式：\`- ql-YYYYMMDD-NNN-XXXX | <一句话描述>\`
-   - 写入模块文档
-   - 使用 \`git add -- <module-doc>\` 暂存更新的模块文件
-10. 未命中任何模块 → 跳过，不做额外操作
+1. \`git add -A\` — **不要 commit**，由用户通过统一提交
+2. 记录：
+   - 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加 task 并勾选，记录精确到秒的时间戳
+   - 无 \`--change\`：记录到 \`.sillyspec/quicklog/QUICKLOG-<git用户名>.md\`（按 git 用户名隔离）
+3. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`
+4. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
+5. 任务比预期复杂 → 建议用完整流程
 
 ### 输出
-暂存确认 + 记录路径 + 模块文档同步结果（如有）`,
+暂存确认 + 记录路径`,
       outputHint: '暂存和记录确认',
       optional: false
     }