sillyspec 3.11.0 → 3.11.2

package/.claude/skills/sillyspec-archive/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:archive
-description: 归档变更 — 规范沉淀，可追溯
+description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:brainstorm
-description: 需求探索 — 结构化头脑风暴，含技术方案输出（创建性工作前必用）
+description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案，但不直接写代码。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-doctor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:doctor
-description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复 progress.json 与实际产出不匹配的问题。
 ---
 
 ## 前置检查

package/.claude/skills/sillyspec-execute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:execute
-description: 波次执行 — 子代理并行 + 强制 TDD + 两阶段审查
+description: 用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-explore/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:explore
-description: 自由思考模式 — 讨论、画图、调研，不写代码
+description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图、澄清问题。适合用户说"分析下、讨论下、看看怎么设计、先别写代码、调研一下、画个结构图、帮我再分析下"。只读，不修改文件，不实现功能。
 ---
 
 ## 交互规范

package/.claude/skills/sillyspec-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:plan
-description: 编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码
+description: 用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-quick/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:quick
-description: 快速任务 — 跳过完整流程，直接做
+description: 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-scan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:scan
-description: 代码扫描 — 分析项目结构、约定和架构
+description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-status/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:status
-description: 查看项目进度和状态
+description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
 ---
 
 ## 多变更说明

package/.claude/skills/sillyspec-verify/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:verify
-description: 验证实现 — 对照规范检查 + 测试套件
+description: 用于验证代码实现是否符合 design 和模块文档。适合用户说"验证下、检查下、跑 verify"。对照 design.md + 模块文档检查任务完成度、设计一致性、运行测试。
 ---
 
 ## 多变更说明

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.11.0",
+  "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 格式