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

package/bin/archive-change.js

@@ -118,132 +118,6 @@ function countTaskCompletion(tasksPath) {
   return { completed, total };
 }
 
-function generateArchiveSummary(archivedPath, changeId) {
-  const proposalPath = path.join(archivedPath, 'proposal.md');
-  const designPath = path.join(archivedPath, 'design.md');
-  const tasksPath = path.join(archivedPath, 'tasks.md');
-  const checklistPath = path.join(archivedPath, 'checklist.md');
-  const specMdPath = path.join(archivedPath, 'spec.md');
-
-  // 提取标题
-  let title = changeId;
-  if (fs.existsSync(proposalPath)) {
-    const content = fs.readFileSync(proposalPath, 'utf8');
-    const titleMatch = content.match(/^#\s+(.+)$/m);
-    if (titleMatch) title = titleMatch[1].trim();
-  }
-
-  // 提取业务目标（从 proposal）
-  let businessGoal = '';
-  if (fs.existsSync(proposalPath)) {
-    const content = fs.readFileSync(proposalPath, 'utf8');
-    // 找“业务目标”或“目标”部分
-    const goalMatch = content.match(/(?:业务目标|目标|## Goal)[^#]*?([\s\S]*?)(?=#|$)/i);
-    if (goalMatch) businessGoal = goalMatch[1].trim().slice(0, 300);
-  }
-
-  // 提取任务完成情况
-  const taskStats = countTaskCompletion(tasksPath);
-
-  // 提取关键设计决策（从 design）
-  let designDecisions = '';
-  if (fs.existsSync(designPath)) {
-    const content = fs.readFileSync(designPath, 'utf8');
-    const decisionMatch = content.match(/(?:设计决策|关键决策|技术方案|## Decision)[^#]*?([\s\S]*?)(?=##|$)/i);
-    if (decisionMatch) designDecisions = decisionMatch[1].trim().slice(0, 200);
-  }
-
-  // 提取验收结论（从 checklist）
-  let acceptance = '';
-  if (fs.existsSync(checklistPath)) {
-    const content = fs.readFileSync(checklistPath, 'utf8');
-    // 先匹配 ## 结论 / ## Conclusion 二级标题，再回退匹配 # 验收 / # 结论 一级标题
-    const conclusionMatch = content.match(/## (?:结论|Conclusion)[^#]*?([\s\S]*?)(?=##?\s|$)/i)
-      || content.match(/# (?:验收|结论)[^#]*?([\s\S]*?)(?=##?\s|$)/i);
-    if (conclusionMatch) acceptance = conclusionMatch[1].trim().slice(0, 200);
-  }
-
-  // 提取规格（从 spec.md 或 specs/ 目录）
-  let specSummary = '';
-  if (fs.existsSync(specMdPath)) {
-    specSummary = fs.readFileSync(specMdPath, 'utf8').trim().slice(0, 300);
-  }
-
-  const now = new Date().toISOString().slice(0, 10);
-  const summary = [
-    `# ${title}`,
-    '',
-    `> 归档日期：${now}  |  任务完成：${taskStats.completed}/${taskStats.total}`,
-    '',
-    businessGoal ? `## 业务目标\n\n${businessGoal}\n` : '',
-    specSummary ? `## 需求规格\n\n${specSummary}\n` : '',
-    designDecisions ? `## 设计决策\n\n${designDecisions}\n` : '',
-    acceptance ? `## 验收结论\n\n${acceptance}\n` : '',
-  ].filter(Boolean).join('\n');
-
-  const summaryPath = path.join(archivedPath, 'summary.md');
-  fs.writeFileSync(summaryPath, summary, 'utf8');
-  return summaryPath;
-}
-
-function cleanupProcessFiles(archivedPath) {
-  const processFiles = ['proposal.md', 'design.md', 'tasks.md', 'checklist.md', 'iterations.md', 'spec.md'];
-  const removed = [];
-  for (const file of processFiles) {
-    const filePath = path.join(archivedPath, file);
-    if (fs.existsSync(filePath)) {
-      fs.unlinkSync(filePath);
-      removed.push(file);
-    }
-  }
-  return removed;
-}
-
-function normalizeMarkdown(content) {
-  return String(content || '').replace(/\r\n/g, '\n').trim();
-}
-
-function normalizeSpecsArtifactPath(relPath) {
-  const value = String(relPath || '').trim();
-  if (!value) {
-    return null;
-  }
-
-  const normalized = value.replace(/[\\/]+$/, '');
-  if (/[\\/]specs$/.test(normalized)) {
-    return normalized;
-  }
-
-  const match = normalized.match(/^(.*[\\/]specs)(?:[\\/].+)?$/);
-  return match ? match[1] : normalized;
-}
-
-function mergeSpecFile(targetPath, incomingContent, changeId) {
-  if (!fs.existsSync(targetPath)) {
-    fs.writeFileSync(targetPath, `${incomingContent.trim()}\n`, 'utf8');
-    return 'added';
-  }
-
-  const existingContent = fs.readFileSync(targetPath, 'utf8');
-  const normalizedExisting = normalizeMarkdown(existingContent);
-  const normalizedIncoming = normalizeMarkdown(incomingContent);
-
-  if (!normalizedIncoming || normalizedExisting === normalizedIncoming || normalizedExisting.includes(normalizedIncoming)) {
-    return 'unchanged';
-  }
-
-  const merged = [
-    existingContent.trimEnd(),
-    '',
-    `<!-- merged from change: ${changeId} -->`,
-    '',
-    normalizedIncoming,
-    '',
-  ].join('\n');
-  fs.writeFileSync(targetPath, merged, 'utf8');
-  return 'updated';
-}
-
 function resolveChangeId(targetDir, explicitChangeId) {
   if (explicitChangeId) {
     return explicitChangeId;
@@ -253,68 +127,28 @@ function resolveChangeId(targetDir, explicitChangeId) {
   return currentRun?.task?.change_id || currentRun?.anchor?.task?.change_id || null;
 }
 
-function buildArchiveDestination(baseArchiveDir, changeId, now = new Date()) {
-  const day = now.toISOString().slice(0, 10);
-  const baseName = `${day}-${changeId}`;
-  let candidate = path.join(baseArchiveDir, baseName);
-  let suffix = 1;
-
-  while (fs.existsSync(candidate)) {
-    suffix += 1;
-    candidate = path.join(baseArchiveDir, `${baseName}-${suffix}`);
-  }
-
-  return candidate;
-}
-
 function buildAlreadyArchivedResult(targetDir, changeId) {
-  const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
-  const proposalPath = currentRun?.artifacts?.proposal
-    ? path.join(targetDir, currentRun.artifacts.proposal)
-    : null;
-  const specsPath = currentRun?.artifacts?.specs
-    ? path.join(targetDir, normalizeSpecsArtifactPath(currentRun.artifacts.specs))
-    : null;
-  const designPath = currentRun?.artifacts?.design
-    ? path.join(targetDir, currentRun.artifacts.design)
-    : null;
-
-  if (!proposalPath || !specsPath || !designPath) {
-    return null;
-  }
-  if (!proposalPath.includes(`${path.sep}openspec${path.sep}changes${path.sep}archive${path.sep}`)) {
-    return null;
-  }
-  if (!fs.existsSync(proposalPath) || !fs.existsSync(specsPath) || !fs.existsSync(designPath)) {
+  // 检查 specs 是否已存储到 openspec/specs/{changeId}.md
+  const specFile = path.join(targetDir, 'openspec', 'specs', `${changeId}.md`);
+  if (!fs.existsSync(specFile)) {
     return null;
   }
+  const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
   if ((currentRun?.task?.change_id || currentRun?.anchor?.task?.change_id || null) !== changeId) {
     return null;
   }
 
-  const archivedDir = path.dirname(proposalPath);
-  const archivedRel = path.relative(targetDir, archivedDir);
   return {
     kind: 'archive-change-result',
     status: 'success',
     target: targetDir,
     change_id: changeId,
-    archived_to: archivedRel,
-    archived_artifacts: {
-      proposal: path.relative(targetDir, proposalPath),
-      specs: path.relative(targetDir, specsPath),
-      design: path.relative(targetDir, designPath),
-      tasks: currentRun?.artifacts?.tasks || null,
-      checklist: currentRun?.artifacts?.checklist || null,
-      iterations: currentRun?.artifacts?.iterations || null,
-    },
-    merged: {
-      added_domains: [],
+    specs_stored_at: path.relative(targetDir, specFile),
+    archived: {
       added_specs: [],
-      updated_specs: [],
-      unchanged_specs: [],
+      updated_specs: [path.relative(targetDir, specFile)],
     },
-    task_completion: countTaskCompletion(path.join(archivedDir, 'tasks.md')),
+    task_completion: { completed: 0, total: 0 },
     already_archived: true,
   };
 }
@@ -360,8 +194,10 @@ function completeRunAfterArchive(targetDir, archiveResult) {
     fromRole: currentRun.current_role || 'archive-change',
     toRole: 'archive-change',
     status: 'success',
-    message: '归档完成，增量规范已合并并已写入归档目录。',
-    artifactsData: archiveResult.archived_artifacts,
+    message: '归档完成，规范已存储到 openspec/specs/。',
+    artifactsData: {
+      specs: archiveResult.specs_stored_at,
+    },
     skipArtifactCheck: true,
     clearPendingGate: true,
   });
@@ -373,25 +209,6 @@ function completeRunAfterArchive(targetDir, archiveResult) {
   };
 }
 
-function buildArchivedAdditionalArtifacts(currentArtifacts, changeId, archivedRelBase) {
-  const currentAdditional = Array.isArray(currentArtifacts?.additional) ? currentArtifacts.additional : [];
-  if (currentAdditional.length === 0) {
-    return [];
-  }
-
-  const activeBase = `openspec/changes/${changeId}`;
-  return currentAdditional
-    .map((item) => String(item || '').trim())
-    .filter(Boolean)
-    .map((item) => item.replace(/[\\/]+$/, ''))
-    .map((item) => {
-      if (item === activeBase || item.startsWith(`${activeBase}/`)) {
-        return item.replace(activeBase, archivedRelBase);
-      }
-      return item;
-    });
-}
-
 function archiveChange(options = {}) {
   const targetDir = path.resolve(options.target || '.');
   const changeId = resolveChangeId(targetDir, options.changeId);
@@ -413,7 +230,6 @@ function archiveChange(options = {}) {
 
   const proposalPath = path.join(changeDir, 'proposal.md');
   const tasksPath = path.join(changeDir, 'tasks.md');
-  const designPath = path.join(changeDir, 'design.md');
   const checklistPath = path.join(changeDir, 'checklist.md');
   const iterationsPath = path.join(changeDir, 'iterations.md');
   const specsDir = path.join(changeDir, 'specs');
@@ -424,63 +240,37 @@ function archiveChange(options = {}) {
   if (!fs.existsSync(tasksPath)) {
     throw new Error(`tasks.md is missing for change ${changeId}`);
   }
-  if (!fs.existsSync(designPath)) {
-    throw new Error(`design.md is missing for change ${changeId}`);
-  }
   if (!fs.existsSync(specsDir)) {
     throw new Error(`specs/ is missing for change ${changeId}`);
   }
 
-  const targetSpecsDir = path.join(targetDir, 'openspec', 'specs');
-  ensureDir(targetSpecsDir);
+  // 先统计任务完成情况（在清理之前）
+  const taskCompletionStats = countTaskCompletion(path.join(changeDir, 'tasks.md'));
+
+  // 合并所有 spec 文件为单个文件
+  const targetSpecFile = path.join(targetDir, 'openspec', 'specs', `${changeId}.md`);
+  ensureDir(path.dirname(targetSpecFile));
+
+  const sourceSpecFiles = listFilesRecursive(specsDir);
+  const specContents = sourceSpecFiles.map((f) => fs.readFileSync(f, 'utf8').trim()).filter(Boolean);
+  const mergedContent = specContents.join('\n\n---\n\n');
 
-  const merged = {
-    added_domains: [],
+  const archived = {
     added_specs: [],
     updated_specs: [],
-    unchanged_specs: [],
   };
-  const seenDomains = new Set();
-  const sourceSpecFiles = listFilesRecursive(specsDir);
-  for (const sourceFile of sourceSpecFiles) {
-    const relFromSpecs = path.relative(specsDir, sourceFile);
-    const domain = relFromSpecs.split(path.sep)[0] || null;
-    const targetFile = path.join(targetSpecsDir, relFromSpecs);
-    const targetDomainDir = path.dirname(targetFile);
-    const domainRel = domain ? path.join('openspec', 'specs', domain) : null;
-
-    if (domainRel && !fs.existsSync(targetDomainDir) && !seenDomains.has(domainRel)) {
-      ensureDir(targetDomainDir);
-      merged.added_domains.push(domainRel);
-      seenDomains.add(domainRel);
-    } else {
-      ensureDir(targetDomainDir);
-    }
 
-    const mergeStatus = mergeSpecFile(targetFile, fs.readFileSync(sourceFile, 'utf8'), changeId);
-    const relTargetFile = path.relative(targetDir, targetFile);
-    if (mergeStatus === 'added') {
-      merged.added_specs.push(relTargetFile);
-    } else if (mergeStatus === 'updated') {
-      merged.updated_specs.push(relTargetFile);
-    } else {
-      merged.unchanged_specs.push(relTargetFile);
-    }
+  if (fs.existsSync(targetSpecFile)) {
+    fs.writeFileSync(targetSpecFile, mergedContent, 'utf8');
+    archived.updated_specs.push(path.relative(targetDir, targetSpecFile));
+  } else {
+    fs.writeFileSync(targetSpecFile, mergedContent, 'utf8');
+    archived.added_specs.push(path.relative(targetDir, targetSpecFile));
   }
 
-  const archiveRoot = path.join(targetDir, 'openspec', 'changes', 'archive');
-  ensureDir(archiveRoot);
-  const archivedPath = buildArchiveDestination(archiveRoot, changeId, options.now || new Date());
-  fs.renameSync(changeDir, archivedPath);
+  // 清理变更目录（不保留归档）
+  fs.rmSync(changeDir, { recursive: true, force: true });
 
-  // 先统计任务完成情况（在清理之前）
-  const taskCompletionStats = countTaskCompletion(path.join(archivedPath, 'tasks.md'));
-
-  // 生成精简 summary 并清理过程文件
-  const summaryPath = generateArchiveSummary(archivedPath, changeId);
-  const removedFiles = cleanupProcessFiles(archivedPath);
-
-  const archivedRelBase = path.relative(targetDir, archivedPath);
   const currentRun = readJsonIfExists(path.join(targetDir, '.ai-spec', 'current-run.json'));
 
   const result = {
@@ -488,17 +278,8 @@ function archiveChange(options = {}) {
     status: 'success',
     target: targetDir,
     change_id: changeId,
-    archived_to: archivedRelBase,
-    summary: path.relative(targetDir, summaryPath),
-    removed_process_files: removedFiles,
-    archived_artifacts: {
-      summary: path.relative(targetDir, summaryPath),
-      specs: fs.existsSync(path.join(archivedPath, 'specs'))
-        ? path.relative(targetDir, path.join(archivedPath, 'specs'))
-        : null,
-      additional: buildArchivedAdditionalArtifacts(currentRun?.artifacts || null, changeId, archivedRelBase),
-    },
-    merged,
+    specs_stored_at: path.relative(targetDir, targetSpecFile),
+    archived,
     task_completion: taskCompletionStats,
   };
 
@@ -515,13 +296,10 @@ function printPretty(result) {
   console.log('archive-change');
   console.log(`  target: ${result.target}`);
   console.log(`  change_id: ${result.change_id}`);
-  console.log(`  archived_to: ${result.archived_to}`);
-  console.log(`  summary: ${result.summary}`);
-  console.log(`  cleaned: ${result.removed_process_files.join(', ') || '(none)'}`);
-  console.log(`  added_domains: ${result.merged.added_domains.length}`);
-  console.log(`  added_specs: ${result.merged.added_specs.length}`);
-  console.log(`  updated_specs: ${result.merged.updated_specs.length}`);
-  console.log(`  unchanged_specs: ${result.merged.unchanged_specs.length}`);
+  console.log(`  specs_stored_at: ${result.specs_stored_at}`);
+  console.log(`  added_specs: ${result.archived.added_specs.length}`);
+  console.log(`  updated_specs: ${result.archived.updated_specs.length}`);
+  console.log(`  task_completion: ${result.task_completion.completed}/${result.task_completion.total}`);
   if (result.runtime_transition?.state?.status) {
     console.log(`  run_status: ${result.runtime_transition.state.status}`);
   }

package/bin/cli.js

@@ -154,6 +154,11 @@ function shouldUseIntegrityCommand(args, cwd) {
       process.exit(await repairCommand.main(args.slice(1)));
     }
 
+    if (args[0] === 'refresh') {
+      const refreshCommand = require('./refresh-command');
+      process.exit(refreshCommand.main(args.slice(1)));
+    }
+
     if (args[0] === 'report') {
       const reportCommand = require('./report-command');
       process.exit(await reportCommand.main(args.slice(1)));

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);