@gong-ym/ai-spec-auto 0.2.15 → 0.2.17

package/bin/demo-runtime-smoke.js

@@ -189,7 +189,6 @@ function createBootstrapPayload(runId, userInput, changeId) {
       artifacts: [
         `openspec/changes/${changeId}/proposal.md`,
         `openspec/changes/${changeId}/specs/`,
-        `openspec/changes/${changeId}/design.md`,
         `openspec/changes/${changeId}/tasks.md`,
         'code',
         `openspec/changes/${changeId}/checklist.md`,
@@ -235,13 +234,11 @@ function createBootstrapPayload(runId, userInput, changeId) {
       artifacts: {
         proposal: `openspec/changes/${changeId}/proposal.md`,
         specs: `openspec/changes/${changeId}/specs/`,
-        design: `openspec/changes/${changeId}/design.md`,
         tasks: `openspec/changes/${changeId}/tasks.md`,
       },
       expected_output: [
         '补齐 proposal',
         '输出 specs',
-        '输出 design',
         '输出 tasks',
         '列出缺失输入',
       ],
@@ -279,7 +276,7 @@ function writeRequirementArtifacts(targetDir, changeId) {
     '- 新增一个商品 mock 页面，用于验证 expert-delivery 主链可运行。',
     '',
     '### 工程目标',
-    '- 验证 proposal、design、tasks、checklist、iterations 这组模板化产物可以支撑主链闭环。',
+    '- 验证 proposal、tasks、checklist、iterations 这组模板化产物可以支撑主链闭环。',
     '',
     '### 变更对象与入口',
     '- 页面入口：`src/views/products/mock/index.vue`',
@@ -298,7 +295,7 @@ function writeRequirementArtifacts(targetDir, changeId) {
     '- 新增商品 mock 页面。',
     '- 新增最小路由模块。',
     '- 新增最小 mock 数据。',
-    '- 输出结构化的 design、tasks、checklist 和 iterations。',
+    '- 输出结构化的 tasks、checklist 和 iterations。',
     '',
     '### Out of Scope(排除范围)',
     '- 不接真实 API(接口)。',
@@ -346,70 +343,11 @@ function writeRequirementArtifacts(targetDir, changeId) {
     '- **则** 只读取本地 mock 模块，不调用远程 API',
   ].join('\n'));
 
-  writeFile(targetDir, `openspec/changes/${changeId}/design.md`, [
-    '# 技术设计',
-    '',
-    '## 方案概览',
-    '- 在现有 Vue 目录约定下落一个最小商品页面、路由模块和 mock 数据文件。',
-    '- 通过结构化的 proposal、design、tasks、checklist、iterations 验证模板增强后的主链产物。',
-    '',
-    '## 仓库对齐',
-    '',
-    '### 页面与路由落点',
-    '- 页面落在 `src/views/products/mock/index.vue`',
-    '- 路由落在 `src/router/modules/products.ts`',
-    '',
-    '### 接口与数据落点',
-    '- mock 数据落在 `src/mock/products.ts`',
-    '- 当前示例不新增真实 API(接口) 封装',
-    '',
-    '### 状态与样式落点',
-    '- 页面使用局部静态数据，不引入额外状态管理',
-    '- 样式直接放在页面 SFC(单文件组件) 内，保持最小实现',
-    '',
-    '### 测试与组件库落点',
-    '- 由 runtime smoke 和模板回归用例验证产物结构',
-    '- 当前示例不额外接入组件库，只复用仓库现有目录约定',
-    '',
-    '## 关键决策',
-    '',
-    '### 信息结构',
-    '- 页面只保留标题和商品列表，用最小信息结构证明页面可交付。',
-    '',
-    '### 状态管理方案',
-    '- 商品数据直接从本地 mock 文件导入，避免在示例里引入无关状态层。',
-    '',
-    '### 组件复用策略',
-    '- 优先复用现有 Vue 页面、路由和 mock 组织方式，不额外封装新组件。',
-    '',
-    '### 禁止重复实现的能力',
-    '- 不重复实现路由基础设施、构建配置和全局状态容器。',
-    '',
-    '### 组件缺口',
-    '- 当前示例未识别必须补齐的组件缺口，真实业务接入时再补充。',
-    '',
-    '## 数据与接口变更',
-    '- 页面只读取本地 `productMock` 数据，不新增请求或响应契约。',
-    '- 不引入新的 props(属性)、事件或跨模块状态同步。',
-    '',
-    '## 验证说明',
-    '',
-    '### 本地验证',
-    '- 通过 runtime smoke 命令推进主链，确认产物、代码和归档目录都能落盘。',
-    '',
-    '### 浏览器验证',
-    '- 当前示例不接真实浏览器脚本，以页面文件、路由文件和 mock 文件的落盘作为最小替代证据。',
-    '',
-    '### 关键验收路径',
-    '- 生成 proposal、specs、design、tasks 后进入实现专家。',
-    '- 页面、路由、mock 文件落盘后补齐 checklist 和 iterations，再完成归档。',
-  ].join('\n'));
-
   writeFile(targetDir, `openspec/changes/${changeId}/tasks.md`, [
     '# 实施任务',
     '',
     '## 执行总原则',
-    '- [ ] 任务必须限定在 proposal.md、design.md 和 specs 已批准范围内',
+    '- [ ] 任务必须限定在 proposal.md 和 specs 已批准范围内',
     '- [ ] 每个子任务都要写明目标、输入、输出、验证点和依赖或前置条件',
     '- [ ] 未完成验证前不得宣称任务完成或继续交接',
     '',
@@ -420,18 +358,18 @@ function writeRequirementArtifacts(targetDir, changeId) {
     '- [ ] 输入：proposal.md、specs/ui/spec.md、现有 `src/views` 目录约定',
     '- [ ] 输出：`src/views/products/mock/index.vue`',
     '- [ ] 验证点：页面文件存在，能引用本地 mock 数据并展示列表',
-    '- [ ] 依赖或前置条件：requirement-analyst 已产出 proposal、specs、design',
+    '- [ ] 依赖或前置条件：requirement-analyst 已产出 proposal、specs',
     '',
     '### 子任务 2',
     '- [ ] 目标：补齐路由模块和 mock 数据文件',
-    '- [ ] 输入：design.md、现有 `src/router/modules` 与 `src/mock` 目录约定',
+    '- [ ] 输入：proposal.md、现有 `src/router/modules` 与 `src/mock` 目录约定',
     '- [ ] 输出：`src/router/modules/products.ts`、`src/mock/products.ts`',
     '- [ ] 验证点：路由指向商品 mock 页面，mock 数据文件可被页面导入',
     '- [ ] 依赖或前置条件：子任务 1 的页面路径已确定',
     '',
     '### 子任务 3',
     '- [ ] 目标：补齐 checklist 和 iterations，完成交付闭环',
-    '- [ ] 输入：实现结果、proposal.md、design.md、tasks.md',
+    '- [ ] 输入：实现结果、proposal.md、tasks.md',
     '- [ ] 输出：`checklist.md`、`iterations.md`',
     '- [ ] 验证点：检查结论、验证摘要、残留风险和交接提醒都已记录',
     '- [ ] 依赖或前置条件：页面、路由和 mock 数据文件已落盘',
@@ -493,7 +431,7 @@ function writeGuardianArtifacts(targetDir, changeId) {
     '# 检查清单',
     '',
     '## 通过项',
-    '- [x] proposal、specs、design 与实现结果保持一致',
+    '- [x] proposal、specs 与实现结果保持一致',
     '- [x] 已完成任务已真实反映在代码和配套文件中',
     '- [x] 项目的目录、路由、接口、样式、测试等规则已满足当前示例边界',
     '',
@@ -509,7 +447,7 @@ function writeGuardianArtifacts(targetDir, changeId) {
     '- [x] console(控制台) 检查：通过，当前示例未引入浏览器脚本报错',
     '',
     '### 范围一致性',
-    '- [x] 当前实现未超出 proposal、design、tasks 已批准范围',
+    '- [x] 当前实现未超出 proposal、tasks 已批准范围',
     '',
     '### 组件复用检查',
     '- [x] 已记录当前示例优先复用仓库既有目录约定，暂无额外组件库缺口',
@@ -534,7 +472,7 @@ function writeGuardianArtifacts(targetDir, changeId) {
     '- 关联证据：checklist.md、`.ai-spec/current-run.json` 和归档后的 `openspec/changes/archive/` 目录。',
     '',
     '## 修正动作',
-    '- [x] 已补齐 proposal、design、tasks、checklist、iterations 的结构化示例内容。',
+    '- [x] 已补齐 proposal、tasks、checklist、iterations 的结构化示例内容。',
     '- 已完成动作：新增页面、路由、mock 数据，并补录验证摘要和交付结论。',
     '- 待跟进动作：后续可替换为真实业务页面或真实 AI IDE 执行回合。',
     '',
@@ -542,7 +480,7 @@ function writeGuardianArtifacts(targetDir, changeId) {
     '- [ ] 真实浏览器验证、真实 API 和更严格的组件复用约束尚未纳入本次示例。',
     '- 风险说明：如果直接把该示例当成业务实现模板，仍需补真实业务约束和验证脚本。',
     '- 触发条件：进入真实业务项目、引入真实接口或涉及复杂状态管理时。',
-    '- 建议缓解方式：在业务项目中补齐 design、checklist 和浏览器验证证据，再推进归档。',
+    '- 建议缓解方式：在业务项目中补齐 checklist 和浏览器验证证据，再推进归档。',
     '',
     '## 下轮提醒',
     '- [ ] 下一轮可将最小示例替换成真实页面或真实 AI IDE 执行输入。',
@@ -704,8 +642,7 @@ function runDemoRuntimeSmoke(options = {}) {
     },
     outputs: [
       '.ai-spec/current-run.json',
-      'openspec/specs/ui/spec.md',
-      'openspec/specs/api/spec.md',
+      'openspec/specs/runtime-smoke-demo.md',
       'src/views/products/mock/index.vue',
       'src/router/modules/products.ts',
       'src/mock/products.ts',

package/bin/execution-semantics.js

@@ -112,13 +112,13 @@ const ROLE_OPENSPEC_ACTIONS = {
 };
 
 const ROLE_REQUIRED_INPUTS = {
-  'frontend-implementer': ['proposal', 'specs', 'design', 'tasks'],
-  'code-guardian': ['proposal', 'specs', 'design', 'tasks'],
-  'archive-change': ['proposal', 'specs', 'design', 'tasks', 'checklist', 'iterations'],
+  'frontend-implementer': ['proposal', 'specs', 'tasks'],
+  'code-guardian': ['proposal', 'specs', 'tasks'],
+  'archive-change': ['proposal', 'specs', 'tasks', 'checklist', 'iterations'],
 };
 
 const ROLE_REQUIRED_OUTPUTS = {
-  'requirement-analyst': ['proposal', 'specs', 'design', 'tasks'],
+  'requirement-analyst': ['proposal', 'specs', 'tasks'],
   'code-guardian': ['checklist', 'iterations'],
 };
 
@@ -489,9 +489,6 @@ function validatePreImplementationGate(targetDir, currentRun, executionPayload)
   const specsPath = currentRun.artifacts?.specs
     ? path.join(targetDir, runtimeState.normalizeSpecsArtifactPath(currentRun.artifacts.specs))
     : null;
-  const designPath = currentRun.artifacts?.design
-    ? path.join(targetDir, currentRun.artifacts.design)
-    : null;
   const tasksPath = currentRun.artifacts?.tasks
     ? path.join(targetDir, currentRun.artifacts.tasks)
     : null;
@@ -503,9 +500,6 @@ function validatePreImplementationGate(targetDir, currentRun, executionPayload)
   if (!specsPath || !fs.existsSync(specsPath)) {
     reasons.push('specs/ 缺失');
   }
-  if (!designPath || !fs.existsSync(designPath)) {
-    reasons.push('design.md 缺失');
-  }
   if (!tasksPath || !fs.existsSync(tasksPath)) {
     reasons.push('tasks.md 缺失');
   }
@@ -516,7 +510,6 @@ function validatePreImplementationGate(targetDir, currentRun, executionPayload)
 
   const proposalContent = fs.readFileSync(proposalPath, 'utf8').trim();
   const specsArtifact = readMarkdownArtifactContent(specsPath);
-  const designContent = fs.readFileSync(designPath, 'utf8').trim();
   const tasksContent = fs.readFileSync(tasksPath, 'utf8').trim();
   const taskItems = listMarkdownBullets(tasksContent);
 
@@ -549,9 +542,6 @@ function validatePreImplementationGate(targetDir, currentRun, executionPayload)
     if (specsArtifact.content.length < 40) {
       reasons.push('specs/ 过短，未达到 compact 最小信息量');
     }
-    if (designContent.length < 40) {
-      reasons.push('design.md 过短，未达到 compact 最小信息量');
-    }
     if (taskItems.length < 3) {
       reasons.push('tasks.md 任务条目不足 3 条');
     }
@@ -566,9 +556,6 @@ function validatePreImplementationGate(targetDir, currentRun, executionPayload)
     if (specsArtifact.content.length < 80) {
       reasons.push('specs/ 过短，未达到 standard 最小信息量');
     }
-    if (designContent.length < 80) {
-      reasons.push('design.md 过短，未达到 standard 最小信息量');
-    }
     if (headingCount < 2) {
       reasons.push('proposal.md 缺少足够的小节结构');
     }

package/bin/expert-executor.js

@@ -272,7 +272,6 @@ function buildExecutionArtifactMap(changeId, artifacts = {}, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: artifacts.bugfix || `${historyDir}/bugfix.md`,
       implementation_notes: implementationNotes || `${historyDir}/implementation-notes.md`,
@@ -285,7 +284,6 @@ function buildExecutionArtifactMap(changeId, artifacts = {}, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: artifacts.bugfix || null,
       implementation_notes: implementationNotes,
@@ -298,7 +296,6 @@ function buildExecutionArtifactMap(changeId, artifacts = {}, options = {}) {
   return {
     proposal: artifacts.proposal || `${baseDir}/proposal.md`,
     specs: runtimeState.normalizeSpecsArtifactPath(artifacts.specs || `${baseDir}/specs`),
-    design: artifacts.design || `${baseDir}/design.md`,
     tasks: artifacts.tasks || `${baseDir}/tasks.md`,
     bugfix: artifacts.bugfix || null,
     implementation_notes: implementationNotes,
@@ -818,8 +815,8 @@ function applyExecution(options) {
   if (shouldAdvanceRuntime(options)) {
     const runtimeActionPayload = buildAutoRuntimeAction(targetDir, payload);
     if (runtimeActionPayload) {
-      if (archive_result?.archived_artifacts) {
-        runtimeActionPayload.artifacts = archive_result.archived_artifacts;
+      if (archive_result?.specs_stored_at) {
+        runtimeActionPayload.artifacts = { specs: archive_result.specs_stored_at };
         runtimeActionPayload.skip_artifact_check = true;
       }
       const runtimePayload = normalizeRuntimeActionPayload(runtimeActionPayload);
@@ -875,8 +872,8 @@ function applyExecutionData(options) {
   if (shouldAdvanceRuntime(options)) {
     const runtimeActionPayload = buildAutoRuntimeAction(targetDir, payload);
     if (runtimeActionPayload) {
-      if (archive_result?.archived_artifacts) {
-        runtimeActionPayload.artifacts = archive_result.archived_artifacts;
+      if (archive_result?.specs_stored_at) {
+        runtimeActionPayload.artifacts = { specs: archive_result.specs_stored_at };
         runtimeActionPayload.skip_artifact_check = true;
       }
       const runtimePayload = normalizeRuntimeActionPayload(runtimeActionPayload);

package/bin/protocol-workflow.js

@@ -348,7 +348,7 @@ function printUpdate(result) {
     console.log(`  action: ${result.fast_path.action || '(none)'}`);
     console.log(`  run_status: ${result.fast_path.run_status || '(none)'}`);
     console.log(`  current_role: ${result.fast_path.current_role || '(none)'}`);
-    console.log(`  archived_to: ${result.fast_path.archived_to || '(none)'}`);
+    console.log(`  specs_stored_at: ${result.fast_path.specs_stored_at || '(none)'}`);
     console.log(`  requires_followup_turn: ${result.fast_path.requires_followup_turn ? 'yes' : 'no'}`);
   }
   console.log('turn:');

package/bin/refresh-command.js

@@ -0,0 +1,212 @@
+const path = require('path');
+const fs = require('fs');
+
+function parseArgs(argv) {
+  const options = {
+    target: '.',
+    json: false,
+    help: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--json') {
+      options.json = true;
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (!arg.startsWith('-')) {
+      options.target = arg;
+    } else {
+      throw new Error(`未知 refresh 参数：${arg}`);
+    }
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log(`ai-spec-auto refresh [目录] [--json]
+
+说明：
+  轻量更新命令。仅同步流程编排相关资产（commands、flows、orchestration、registry、templates）。
+  不覆盖项目已定制的 rules、skills、roles。
+  不重新扫描项目、不重建 manifest、不触发交互确认。
+
+选项：
+  --json    以 JSON 格式输出
+
+示例：
+  npx @gong-ym/ai-spec-auto@latest refresh
+  npx @gong-ym/ai-spec-auto@latest refresh .
+  npx @gong-ym/ai-spec-auto@latest refresh /path/to/project`);
+}
+
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function refresh(targetDir, pkgRoot) {
+  const agentsDir = path.join(targetDir, '.agents');
+  if (!fs.existsSync(agentsDir)) {
+    throw new Error(`${targetDir} 未找到 .agents/，请先运行 init`);
+  }
+
+  const sourceDir = pkgRoot;
+  const sourceAgentsDir = path.join(sourceDir, '.agents');
+  const updated = [];
+  const skipped = [];
+
+  if (!fs.existsSync(sourceAgentsDir)) {
+    throw new Error(`包内 .agents/ 源目录不存在：${sourceAgentsDir}`);
+  }
+
+  // 1. 同步流程编排相关目录（不覆盖项目已定制的 rules/skills/roles）
+  const flowDirs = ['commands', 'flows', 'orchestration', 'registry', 'templates'];
+  for (const dir of flowDirs) {
+    const srcDir = path.join(sourceAgentsDir, dir);
+    const destDir = path.join(agentsDir, dir);
+    if (!fs.existsSync(srcDir)) continue;
+
+    try {
+      if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+      }
+      copyDirSync(srcDir, destDir);
+      updated.push(`.agents/${dir}/`);
+    } catch (error) {
+      skipped.push({ path: `.agents/${dir}/`, reason: error.message });
+    }
+  }
+
+  // 2. 同步 openspec 模板
+  const sourceTemplates = path.join(sourceDir, 'openspec', 'schemas', 'expert-delivery', 'templates');
+  const targetTemplates = path.join(targetDir, 'openspec', 'schemas', 'expert-delivery', 'templates');
+  if (fs.existsSync(sourceTemplates) && fs.existsSync(targetTemplates)) {
+    try {
+      const templateFiles = fs.readdirSync(sourceTemplates);
+      for (const file of templateFiles) {
+        const srcFile = path.join(sourceTemplates, file);
+        const destFile = path.join(targetTemplates, file);
+        if (fs.statSync(srcFile).isFile()) {
+          fs.copyFileSync(srcFile, destFile);
+        }
+      }
+      updated.push('openspec/schemas/expert-delivery/templates/');
+    } catch (error) {
+      skipped.push({ path: 'openspec/schemas/expert-delivery/templates/', reason: error.message });
+    }
+  }
+
+  // 3. 同步 openspec/config.yaml.template
+  const sourceConfig = path.join(sourceDir, 'openspec', 'config.yaml.template');
+  const targetConfig = path.join(targetDir, 'openspec', 'config.yaml.template');
+  if (fs.existsSync(sourceConfig) && fs.existsSync(targetConfig)) {
+    fs.copyFileSync(sourceConfig, targetConfig);
+    updated.push('openspec/config.yaml.template');
+  }
+
+  // 4. 同步 IDE 命令文件
+  const ides = ['cursor', 'claude', 'qoder', 'trae', 'opencode'];
+  for (const ide of ides) {
+    const sourceIdeDir = path.join(sourceDir, `.${ide}`);
+    const targetIdeDir = path.join(targetDir, `.${ide}`);
+    if (!fs.existsSync(sourceIdeDir) || !fs.existsSync(targetIdeDir)) continue;
+
+    // 同步 commands
+    const srcCmdDir = path.join(sourceIdeDir, 'commands');
+    const destCmdDir = path.join(targetIdeDir, 'commands');
+    if (fs.existsSync(srcCmdDir)) {
+      try {
+        if (fs.existsSync(destCmdDir)) {
+          fs.rmSync(destCmdDir, { recursive: true, force: true });
+        }
+        copyDirSync(srcCmdDir, destCmdDir);
+        updated.push(`.${ide}/commands/`);
+      } catch (error) {
+        skipped.push({ path: `.${ide}/commands/`, reason: error.message });
+      }
+    }
+
+    // 同步 rules（如果是实际文件而非 symlink）
+    const srcRulesDir = path.join(sourceIdeDir, 'rules');
+    const destRulesDir = path.join(targetIdeDir, 'rules');
+    if (fs.existsSync(srcRulesDir) && !isSymlink(destRulesDir)) {
+      try {
+        if (fs.existsSync(destRulesDir)) {
+          fs.rmSync(destRulesDir, { recursive: true, force: true });
+        }
+        copyDirSync(srcRulesDir, destRulesDir);
+        updated.push(`.${ide}/rules/`);
+      } catch (error) {
+        skipped.push({ path: `.${ide}/rules/`, reason: error.message });
+      }
+    }
+
+    // 同步 skills
+    const srcSkillsDir = path.join(sourceIdeDir, 'skills');
+    const destSkillsDir = path.join(targetIdeDir, 'skills');
+    if (fs.existsSync(srcSkillsDir)) {
+      try {
+        if (fs.existsSync(destSkillsDir)) {
+          fs.rmSync(destSkillsDir, { recursive: true, force: true });
+        }
+        copyDirSync(srcSkillsDir, destSkillsDir);
+        updated.push(`.${ide}/skills/`);
+      } catch (error) {
+        skipped.push({ path: `.${ide}/skills/`, reason: error.message });
+      }
+    }
+  }
+
+  return { updated, skipped };
+}
+
+function isSymlink(p) {
+  try {
+    return fs.lstatSync(p).isSymbolicLink();
+  } catch (_) {
+    return false;
+  }
+}
+
+function main(argv = process.argv.slice(2)) {
+  const options = parseArgs(argv);
+  if (options.help) {
+    printUsage();
+    return 0;
+  }
+
+  const targetDir = path.resolve(process.cwd(), options.target);
+  const pkgRoot = path.join(__dirname, '..');
+  const result = refresh(targetDir, pkgRoot);
+
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log('refresh 完成');
+    console.log(`  更新 ${result.updated.length} 项：`);
+    for (const item of result.updated) {
+      console.log(`    ✓ ${item}`);
+    }
+    if (result.skipped.length > 0) {
+      console.log(`  跳过 ${result.skipped.length} 项：`);
+      for (const item of result.skipped) {
+        console.log(`    ✗ ${item.path} (${item.reason})`);
+      }
+    }
+  }
+
+  return result.skipped.length > 0 ? 1 : 0;
+}
+
+module.exports = { main, parseArgs, refresh };

package/bin/runtime-state.js

@@ -683,6 +683,17 @@ function normalizeSpecsArtifactPath(relPath) {
     return null;
   }
 
+  // 新格式: openspec/specs/{changeId}.md 直接返回
+  if (/openspec[/\\]specs[/\\][^/\\]+\.md$/.test(value)) {
+    return value.replace(/[\\/]+$/, '');
+  }
+
+  // 兼容旧目录格式: openspec/specs/{changeId} 或 openspec/specs/{changeId}/...
+  if (/openspec[/\\]specs[/\\][^/\\]+$/.test(value)) {
+    return value.replace(/[\\/]+$/, '');
+  }
+
+  // 旧格式兼容: 提取 openspec/specs 部分
   const normalized = value.replace(/[\\/]+$/, '');
   if (/[\\/]specs$/.test(normalized)) {
     return normalized;
@@ -702,7 +713,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: `${historyDir}/bugfix.md`,
       implementation_notes: `${historyDir}/implementation-notes.md`,
@@ -716,7 +726,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
     return {
       proposal: null,
       specs: null,
-      design: null,
       tasks: null,
       bugfix: null,
       implementation_notes: null,
@@ -730,7 +739,6 @@ function buildDefaultArtifacts(changeId, options = {}) {
   return {
     proposal: `${baseDir}/proposal.md`,
     specs: `${baseDir}/specs`,
-    design: `${baseDir}/design.md`,
     tasks: `${baseDir}/tasks.md`,
     bugfix: null,
     implementation_notes: null,
@@ -743,14 +751,14 @@ function buildDefaultArtifacts(changeId, options = {}) {
 function mergeArtifacts(baseArtifacts, inferredArtifacts) {
   const proposal = inferredArtifacts?.proposal || baseArtifacts?.proposal || null;
   const specs = normalizeSpecsArtifactPath(inferredArtifacts?.specs || baseArtifacts?.specs || null);
-  const design = inferredArtifacts?.design || baseArtifacts?.design || null;
   const tasks = inferredArtifacts?.tasks || baseArtifacts?.tasks || null;
   const bugfix = inferredArtifacts?.bugfix || baseArtifacts?.bugfix || null;
   const implementationNotes = inferredArtifacts?.implementation_notes || baseArtifacts?.implementation_notes || null;
   const checklist = inferredArtifacts?.checklist || baseArtifacts?.checklist || null;
   const iterations = inferredArtifacts?.iterations || baseArtifacts?.iterations || null;
+  const summary = inferredArtifacts?.summary || baseArtifacts?.summary || null;
   const primaryArtifacts = new Set(
-    [proposal, specs, design, tasks, bugfix, implementationNotes, checklist, iterations]
+    [proposal, specs, tasks, bugfix, implementationNotes, checklist, iterations, summary]
       .map((item) => (typeof item === 'string' ? item.trim().replace(/[\\/]+$/, '') : null))
       .filter(Boolean),
   );
@@ -766,12 +774,12 @@ function mergeArtifacts(baseArtifacts, inferredArtifacts) {
   const merged = {
     proposal,
     specs,
-    design,
     tasks,
     bugfix,
     implementation_notes: implementationNotes,
     checklist,
     iterations,
+    summary,
     additional: Array.from(new Set(additional.filter(Boolean))),
   };
 
@@ -786,12 +794,12 @@ function inferArtifacts(artifacts) {
   const normalized = {
     proposal: null,
     specs: null,
-    design: null,
     tasks: null,
     bugfix: null,
     implementation_notes: null,
     checklist: null,
     iterations: null,
+    summary: null,
     additional: [],
   };
 
@@ -800,7 +808,7 @@ function inferArtifacts(artifacts) {
   }
 
   if (artifacts && typeof artifacts === 'object' && !Array.isArray(artifacts)) {
-    const directKeys = ['proposal', 'specs', 'design', 'tasks', 'bugfix', 'implementation_notes', 'checklist', 'iterations'];
+    const directKeys = ['proposal', 'specs', 'tasks', 'bugfix', 'implementation_notes', 'checklist', 'iterations', 'summary'];
     for (const key of directKeys) {
       if (typeof artifacts[key] === 'string' && artifacts[key].trim()) {
         normalized[key] = key === 'specs'
@@ -839,10 +847,6 @@ function inferArtifacts(artifacts) {
       normalized.specs = normalizeSpecsArtifactPath(item);
       continue;
     }
-    if (item.endsWith('/design.md')) {
-      normalized.design = item;
-      continue;
-    }
     if (item.endsWith('/tasks.md')) {
       normalized.tasks = item;
       continue;
@@ -1134,9 +1138,9 @@ function assertRequiredOpenSpecArtifacts(targetDir, state, action, toRole) {
 
   let requiredArtifacts = [];
   if (action === 'handoff' && toRole === 'frontend-implementer') {
-    requiredArtifacts = ['proposal', 'specs', 'design', 'tasks'];
+    requiredArtifacts = ['proposal', 'specs', 'tasks'];
   } else if (action === 'complete') {
-    requiredArtifacts = ['proposal', 'specs', 'design', 'tasks', 'checklist', 'iterations'];
+    requiredArtifacts = ['proposal', 'specs', 'tasks', 'checklist', 'iterations'];
   }
 
   if (requiredArtifacts.length === 0) {

package/bin/task-orchestrator-runner.js

@@ -940,8 +940,8 @@ function advanceRunner(options) {
     };
     const autoRuntimeAction = buildAutoRuntimeAction(targetDir, recorded.execution.payload);
     if (autoRuntimeAction) {
-      if (recorded.execution.archive_result?.archived_artifacts) {
-        autoRuntimeAction.artifacts = recorded.execution.archive_result.archived_artifacts;
+      if (recorded.execution.archive_result?.specs_stored_at) {
+        autoRuntimeAction.artifacts = { specs: recorded.execution.archive_result.specs_stored_at };
         autoRuntimeAction.skip_artifact_check = true;
       }
       recorded.runtime_action = {