sillyspec 3.10.5 → 3.10.7

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

@@ -3,6 +3,10 @@ name: sillyspec:archive
 description: 归档变更 — 规范沉淀，可追溯
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:brainstorm
 description: 需求探索 — 结构化头脑风暴，含技术方案输出（创建性工作前必用）
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -13,6 +13,10 @@ description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
    - 给出安装命令：`npm install -g sillyspec`
    - 停止，不要继续后续步骤
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **CLI 可用后，使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:execute
 description: 波次执行 — 子代理并行 + 强制 TDD + 两阶段审查
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -17,6 +17,10 @@ description: 自由思考模式 — 讨论、画图、调研，不写代码
 ## 话题
 $ARGUMENTS
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须先使用 exec 工具（shell）执行以下命令读取统一 CLI prompt：**

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

@@ -3,6 +3,10 @@ name: sillyspec:plan
 description: 编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:propose
 description: 生成结构化规范 — proposal + design + tasks
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:quick
 description: 快速任务 — 跳过完整流程，直接做
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:scan
 description: 代码扫描 — 分析项目结构、约定和架构
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:status
 description: 查看项目进度和状态
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -3,6 +3,10 @@ name: sillyspec:verify
 description: 验证实现 — 对照规范检查 + 测试套件
 ---
 
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

package/package.json

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

package/src/index.js

@@ -136,9 +136,13 @@ async function main() {
       break;
     case 'progress': {
       const pm = new ProgressManager();
+      pm._migrateIfNeeded(dir);
       const subCommand = filteredArgs[1];
       const stageIdx = filteredArgs.indexOf('--stage');
       const stage = stageIdx >= 0 && filteredArgs[stageIdx + 1] ? filteredArgs[stageIdx + 1] : null;
+      // 解析 --change 参数
+      const progChangeIdx = args.indexOf('--change');
+      const progChangeName = progChangeIdx >= 0 && args[progChangeIdx + 1] ? args[progChangeIdx + 1] : null;
 
       switch (subCommand) {
         case 'init':
@@ -146,49 +150,48 @@ async function main() {
           break;
         case 'status':
         case 'show':
-          pm.show(dir);
+          pm.show(dir, progChangeName);
           break;
         case 'validate':
-          await pm.validate(dir);
+          await pm.validate(dir, progChangeName);
           break;
         case 'reset':
-          pm.reset(dir, stage);
+          pm.reset(dir, stage, progChangeName);
           break;
         case 'set-stage': {
           const setStageName = filteredArgs[2];
-          if (!setStageName) { console.log('❌ 用法: sillyspec progress set-stage <stage>'); break; }
-          pm.setStage(dir, setStageName);
+          if (!setStageName) { console.log('❌ 用法: sillyspec progress set-stage <stage> [--change <name>]'); break; }
+          pm.setStage(dir, setStageName, progChangeName);
           break;
         }
         case 'add-step': {
           const addStepStage = filteredArgs[2];
           const addStepName = filteredArgs[3];
-          if (!addStepStage || !addStepName) { console.log('❌ 用法: sillyspec progress add-step <stage> <step-name>'); break; }
-          pm.addStep(dir, addStepStage, addStepName);
+          if (!addStepStage || !addStepName) { console.log('❌ 用法: sillyspec progress add-step <stage> <step-name> [--change <name>]'); break; }
+          pm.addStep(dir, addStepStage, addStepName, progChangeName);
           break;
         }
         case 'update-step': {
           const updStepStage = filteredArgs[2];
           const updStepName = filteredArgs[3];
-          if (!updStepStage || !updStepName) { console.log('❌ 用法: sillyspec progress update-step <stage> <step-name> --status <status> [--output <text>]'); break; }
-          // Parse --status and --output from args
+          if (!updStepStage || !updStepName) { console.log('❌ 用法: sillyspec progress update-step <stage> <step-name> --status <status> [--output <text>] [--change <name>]'); break; }
           let updStatus = null, updOutput = undefined;
           for (let ai = 0; ai < args.length; ai++) {
             if (args[ai] === '--status' && args[ai + 1]) { updStatus = args[ai + 1]; ai++; }
             if (args[ai] === '--output' && args[ai + 1]) { updOutput = args[ai + 1]; ai++; }
           }
-          pm.updateStep(dir, updStepStage, updStepName, { status: updStatus, output: updOutput });
+          pm.updateStep(dir, updStepStage, updStepName, { status: updStatus, output: updOutput }, progChangeName);
           break;
         }
         case 'complete-stage': {
           const compStageName = filteredArgs[2];
           if (!compStageName) { console.log('❌ 用法: sillyspec progress complete-stage <stage>'); break; }
-          pm.completeStage(dir, compStageName);
+          pm.completeStage(dir, compStageName, progChangeName);
           break;
         }
         case 'batch': {
           if (filteredArgs.includes('--status')) {
-            const bp = pm.readBatchProgress(dir);
+            const bp = pm.readBatchProgress(dir, progChangeName);
             if (!bp) { console.log('📭 无批量进度数据'); break; }
             const line = pm._renderBatchProgress(bp);
             console.log(line || '📭 无批量进度数据');
@@ -207,7 +210,7 @@ async function main() {
               console.log('     sillyspec progress batch --status');
               break;
             }
-            pm.updateBatchProgress(dir, batchData);
+            pm.updateBatchProgress(dir, batchData, progChangeName);
             console.log('✅ 批量进度已更新');
           }
           break;

package/src/init.js

@@ -56,7 +56,7 @@ const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
 - 遵循 \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\` 中的代码风格
 
 ### 工作流程
-- 读取 \`.sillyspec/.runtime/progress.json\` 确认当前阶段（使用 \`sillyspec progress show\`）
+- 读取当前变更的 progress.json 确认当前阶段（使用 \`sillyspec progress show\`）
 - 各阶段产出文件位于 \`.sillyspec/changes/<变更名>/\` 下
 `;
 
@@ -141,18 +141,15 @@ async function doInstall(projectDir, tools, subprojects = []) {
     writeFileSync(uncatPath, `# 未分类知识\n\n> execute/quick 执行中发现的坑暂存于此，用户审阅后归类到对应文件并更新 INDEX.md。\n`);
   }
 
-  // 创建 .sillyspec/.runtime/ 目录结构
+  // 创建 .sillyspec/.runtime/ 目录结构（全局状态）
   const runtimeDir = join(projectDir, '.sillyspec', '.runtime');
   for (const sub of ['artifacts', 'history', 'logs', 'templates']) {
     mkdirSync(join(runtimeDir, sub), { recursive: true });
   }
 
-  // 创建初始 progress.json
-  const progressPath = join(runtimeDir, 'progress.json');
-  if (!existsSync(progressPath)) {
-    const pm = new ProgressManager();
-    pm.init(projectDir);
-  }
+  // 创建全局状态文件
+  const pm = new ProgressManager();
+  pm.init(projectDir);
 
   // 创建初始 user-inputs.md
   const inputsPath = join(runtimeDir, 'user-inputs.md');