sillyspec 3.11.1 → 3.11.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.11.1",
+  "version": "3.11.2",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/stages/brainstorm.js

@@ -194,7 +194,7 @@ export const definition = {
    - 适合：有 UI 组件/布局/交互流程/状态转换/架构图
    - 不适合：纯后端逻辑/配置修改/无可视化意义
 2. 如果适合，生成一个独立的 HTML 文件（内联 CSS + JS），保存到：
-   \`.sillyspec/changes/<变更名>/prototype-<名称>.html\`（变更名格式：YYYY-MM-DD-<简短描述>）
+   \`.sillyspec/changes/<change-name>/prototype-<名称>.html\`（变更名格式：YYYY-MM-DD-<简短描述>）
 3. 原型要求：
    - 单文件，浏览器直接打开
    - 展示关键布局结构和交互流程
@@ -240,9 +240,9 @@ HTML 原型文件路径（或"跳过"如果不适合）`,
 11. **自审**（AI 对自身设计的校验）
 
 ### 操作
-1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<变更名>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<变更名>\`）
+1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<change-name>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<change-name>\`）
    - 变更名格式必须为 \`YYYY-MM-DD-<简短描述>\`（如 \`2026-05-13-user-auth\`）
-2. 将确认的设计写入 \`.sillyspec/changes/<变更名>/design.md\`
+2. 将确认的设计写入 \`.sillyspec/changes/<change-name>/design.md\`
 3. 自审检查：
    - 需求覆盖：是否完整覆盖 Step 6 确认的需求
    - 约束一致性：是否与 CONVENTIONS.md、ARCHITECTURE.md 一致
@@ -268,7 +268,7 @@ design.md 文件路径 + 自审结果
 ### 操作
 1. 展示 design.md 摘要给用户
 2. 请用户选择：✅ 确认 / ✏️ 修改 / ❌ 推翻重来
-3. 确认后，在 \`.sillyspec/changes/<变更名>/\` 下生成所有规范文件：
+3. 确认后，在 \`.sillyspec/changes/<change-name>/\` 下生成所有规范文件：
    - **design.md**：架构决策、文件变更清单、数据模型、API 设计、兼容策略、风险登记、自审
    - **proposal.md**：动机、关键问题（为什么现有方案不够）、变更范围、不在范围内（显式清单）、成功标准（可验证条件）
    - **requirements.md**：角色表 + FR 编号需求 + Given/When/Then 行为规格 + 非功能需求

package/src/stages/plan.js

@@ -132,7 +132,7 @@ task-01 → task-03（最长路径，决定最短交付周期）
 6. 生成 Mermaid 依赖关系图
 7. 标注关键路径
 8. 评估是否需要 Spike 前置验证
-9. 保存到 \`.sillyspec/changes/<变更名>/plan.md\`
+9. 保存到变更目录下的 plan.md（路径格式：\`.sillyspec/changes/<change-name>/plan.md\`，其中 <change-name> 是变更目录名，直接使用，不加子目录。正确路径示例：\`.sillyspec/changes/2026-05-28-agent-log-streaming/plan.md\`）
 
 ### 输出
 plan.md 总览内容`,
@@ -217,7 +217,7 @@ function buildTaskPrompt(taskNum, taskName, changeDir) {
 ${taskName}
 
 ### 文件路径
-\`.sillyspec/changes/<变更名>/tasks/task-${num}.md\`
+\`.sillyspec/changes/<change-name>/tasks/task-${num}.md\`
 
 ### 格式要求（必须严格遵守）
 \`\`\`markdown

package/src/stages/propose.js

@@ -69,7 +69,9 @@ export const definition = {
     },
     {
       name: '生成规范文件',
-      prompt: `在 \`.sillyspec/changes/<变更名>/\` 下生成四个文件。
+      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 格式要求
 - **动机**：为什么做、解决什么核心问题

package/src/stages/quick.js

@@ -14,7 +14,7 @@ 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/<变更名>/design.md 2>/dev/null\`（理解设计意图）
+6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<change-name>/design.md 2>/dev/null\`（理解设计意图）
 7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
 
 ### 创建任务记录（必须执行）
@@ -26,7 +26,7 @@ export const definition = {
    状态：进行中
    文件：<预估要改的文件>
    \`\`\`
-3. 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加未勾选的 task
+3. 有 \`--change\`：在 \`.sillyspec/changes/<change-name>/tasks.md\` 追加未勾选的 task
 
 这样 Gate 检测到 \.sillyspec/\` 下有变更，就不会拦截后续的代码修改。
 

package/src/stages/verify.js

@@ -155,7 +155,7 @@ grep -rl "<关键词>" <源码目录>/ --include="*.java" --include="*.js" --inc
 
 ### 操作
 1. 汇总以上所有检查结果
-2. 生成 verification.md 文件，保存到 \`.sillyspec/changes/<变更名>/verification.md\`
+2. 生成 verification.md 文件，保存到 \`.sillyspec/changes/<change-name>/verification.md\`
 3. 给出结论：PASS / PASS WITH NOTES / FAIL
 
 ### verification.md 格式