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

package/internal/ai-protocol-workflow.js

@@ -171,10 +171,10 @@ const FALLBACK_ROLE_SKILL_PRIORITY = {
 };
 
 const FALLBACK_ROLE_OPENSPEC_RULE_SECTIONS = {
-  'requirement-analyst': ['proposal', 'specs', 'design', 'tasks'],
-  'frontend-implementer': ['specs', 'tasks', 'design'],
-  'code-guardian': ['tasks', 'specs', 'design', 'checklist', 'iterations'],
-  'archive-change': ['specs', 'design', 'checklist', 'iterations'],
+  'requirement-analyst': ['proposal', 'specs', 'tasks'],
+  'frontend-implementer': ['specs', 'tasks'],
+  'code-guardian': ['tasks', 'specs', 'checklist', 'iterations'],
+  'archive-change': ['specs', 'checklist', 'iterations'],
 };
 
 const DEFAULT_FLOW_ID = 'prd-to-delivery';
@@ -186,7 +186,7 @@ const REVIEW_POLICIES = new Set(['none', 'main-flow-blocking']);
 const DEFAULT_FLOW_CONSTRAINTS = {
   required_roles: ['requirement-analyst', 'frontend-implementer', 'code-guardian'],
   approval_gates: [],
-  required_artifacts: ['proposal.md', 'specs', 'design.md', 'tasks.md', 'checklist.md', 'iterations.md'],
+  required_artifacts: ['proposal.md', 'specs', 'tasks.md', 'checklist.md', 'iterations.md'],
 };
 
 const DEFAULT_HANDOFF_GATE_POLICY = {
@@ -266,11 +266,10 @@ const MICRO_ROLE_EXTRAS = {
     ],
   },
   'requirement-analyst': {
-    goal: '用短版 proposal.md、specs/、design.md 和 tasks.md 收敛需求，不写实现代码。',
+    goal: '用短版 proposal.md、specs/ 和 tasks.md 收敛需求，不写实现代码。',
     must_do: [
       'proposal.md 只保留目标、范围、默认假设、风险四块',
       'specs/<domain>/spec.md 只保留当前变更需要的增量规范和场景',
-      'design.md 只保留真实实现落点和关键约束',
       'tasks.md 保持 3-5 条可执行任务，覆盖实现与验收',
     ],
     must_not: [
@@ -278,7 +277,7 @@ const MICRO_ROLE_EXTRAS = {
     ],
   },
   'frontend-implementer': {
-    goal: '基于短版 proposal/specs/design/tasks 做最小必要实现，优先复用现有结构。',
+    goal: '基于短版 proposal/specs/tasks 做最小必要实现，优先复用现有结构。',
     must_do: [
       '保持改动最小化，优先就地复用现有页面、组件、样式变量和 mock 约定',
       '实现说明只保留当前变更、验证结果和残留风险',
@@ -310,17 +309,13 @@ const MICRO_OPENSPEC_RULES = {
     '每条任务都要可落盘、可验证，避免空标题。',
     '保持改动最小化，聚焦本次请求。'
   ],
-  design: [
-    '只保留当前实现真正需要的结构与样式约束。',
-    '继续使用主题变量和既有目录结构。'
-  ],
   specs: [
     '只记录当前变更真正需要的增量规范和关键验收场景。',
     '保留可测试的结论，不展开无关背景说明。'
   ],
   checklist: [
     'checklist.md 只保留关键检查项、阻断项和最终放行结论。',
-    '检查项必须能回指 proposal/specs/design/tasks 或实现证据。'
+    '检查项必须能回指 proposal/specs/tasks 或实现证据。'
   ],
   iterations: [
     'iterations.md 只记录问题、修正动作和残留风险。',
@@ -338,25 +333,25 @@ const ROLE_GUIDANCE = {
     ],
     must_not: [
       '不要越权替代 requirement-analyst、frontend-implementer 或 code-guardian 的职责',
-      '不要在 proposal/specs/design/tasks/checklist/iterations 缺失时跳过门禁直接推进',
+      '不要在 proposal/specs/tasks/checklist/iterations 缺失时跳过门禁直接推进',
     ],
   },
   'requirement-analyst': {
-    goal: '把需求收敛成可执行的 proposal.md、specs/、design.md 和 tasks.md，不写实现代码。',
+    goal: '把需求收敛成可执行的 proposal.md、specs/ 和 tasks.md，不写实现代码。',
     must_do: [
       '先明确目标、范围、非目标、关键假设和风险',
-      'proposal.md、specs/ 和 design.md 需要能支撑后续实现和验收',
+      'proposal.md 和 specs/ 需要能支撑后续实现和验收',
       'tasks.md 必须是可执行任务清单，而不是空标题模板',
     ],
     must_not: [
       '不要直接开始写 Vue/TS/CSS 代码',
-      '不要在 proposal.md、specs/、design.md 和 tasks.md 未落盘前宣称本阶段完成',
+      '不要在 proposal.md、specs/ 和 tasks.md 未落盘前宣称本阶段完成',
     ],
   },
   'frontend-implementer': {
-    goal: '基于 proposal.md、specs/、design.md 和 tasks.md 完成当前范围内的前端实现。',
+    goal: '基于 proposal.md、specs/ 和 tasks.md 完成当前范围内的前端实现。',
     must_do: [
-      '先读 proposal.md、specs/、design.md 和 tasks.md 再改代码',
+      '先读 proposal.md、specs/ 和 tasks.md 再改代码',
       '严格在当前变更范围内实现，不顺手扩 scope',
       '遵守最小改动原则，只修改与当前任务直接相关的文件',
       '实现完成后写 expert-execution 回执并等待下一轮编排',
@@ -367,7 +362,7 @@ const ROLE_GUIDANCE = {
     ],
   },
   'code-guardian': {
-    goal: '基于 proposal、specs、design、tasks 和实现结果做交付前检查，产出 checklist.md 和 iterations.md。',
+    goal: '基于 proposal、specs、tasks 和实现结果做交付前检查，产出 checklist.md 和 iterations.md。',
     must_do: [
       '明确区分阻断项和非阻断项',
       'checklist.md 记录检查项和结论',
@@ -381,7 +376,7 @@ const ROLE_GUIDANCE = {
   'archive-change': {
     goal: '在归档批准后先完成 preflight，再通过 archive-change 命令做规范合并、目录归档和运行收尾。',
     must_do: [
-      '先确认 proposal/specs/design/tasks/checklist/iterations 已齐备',
+      '先确认 proposal/specs/tasks/checklist/iterations 已齐备',
       '归档摘要要说明合并的 spec、归档位置、残留风险和后续 patch 的回退阶段',
       '优先执行 archive-change 内置命令，不手工搬运目录',
     ],
@@ -423,7 +418,7 @@ const ROLE_GUIDANCE = {
   'verification-reviewer': {
     goal: '从验收视角补强验证结论，确保交付不是“代码完成但验证不足”。',
     must_do: [
-      '对照 proposal/specs/design/tasks 检查验收口径是否闭环',
+      '对照 proposal/specs/tasks 检查验收口径是否闭环',
       '明确哪些验证已完成、哪些仍需补充',
     ],
     must_not: [
@@ -443,7 +438,7 @@ const ROLE_GUIDANCE = {
 };
 
 const SKILL_GUIDANCE = {
-  'create-proposal': '用于快速形成 proposal/specs/design/tasks 的结构和变更说明。',
+  'create-proposal': '用于快速形成 proposal/specs/tasks 的结构和变更说明。',
   'design-analysis': '用于整理页面结构、信息层级和交互要点。',
   'ui-ux-pro-max': '用于设计协作阶段的 Figma 解析、标注提取和 UI/UX 设计决策收口。',
   'create-view': '用于创建或调整 Vue 页面文件与页面目录结构。',
@@ -471,8 +466,8 @@ const FALLBACK_ROLE_RULE_CONSTRAINT_PROFILES = {
     },
     'requirement-analyst': {
       must_follow: [
-        '先把项目定位、目录落点、路由/API/样式约定吸收到 proposal/specs/design/tasks，不要把规范已明确的信息重复写成 missing_inputs。',
-        '需求收敛必须同时落到 specs/ 与 design.md，不能只写 tasks 而缺实现落点。',
+        '先把项目定位、目录落点、路由/API/样式约定吸收到 proposal/specs/tasks，不要把规范已明确的信息重复写成 missing_inputs。',
+        '需求收敛必须同时落到 specs/，不能只写 tasks 而缺实现落点。',
         '需求收敛必须落到当前仓库可实施的页面、路由、接口或 mock 落点，而不是抽象方案。',
       ],
       blocked_when: [
@@ -482,16 +477,16 @@ const FALLBACK_ROLE_RULE_CONSTRAINT_PROFILES = {
     'frontend-implementer': {
       must_follow: [
         '优先复用现有目录、路由、请求封装、状态管理和样式变量约定。',
-        '实现前先对齐 proposal/specs/design/tasks 的范围与落点，不要自行扩 scope。',
+        '实现前先对齐 proposal/specs/tasks 的范围与落点，不要自行扩 scope。',
         '坚持最小 patch，避免顺手重构无关模块或扩大改动面。',
       ],
       blocked_when: [
-        'proposal/specs/design/tasks 未落盘或仍处于 before-implementation 审批门禁时，禁止改业务代码。',
+        'proposal/specs/tasks 未落盘或仍处于 before-implementation 审批门禁时，禁止改业务代码。',
       ],
     },
     'code-guardian': {
       must_follow: [
-        '以 proposal/specs/design/tasks 和项目规则为准检查实现，而不是只做泛化 lint。',
+        '以 proposal/specs/tasks 和项目规则为准检查实现，而不是只做泛化 lint。',
         '必须给出阻断项、非阻断项和交付建议，不能写成模糊建议列表。',
       ],
       blocked_when: [
@@ -528,7 +523,7 @@ const FALLBACK_ROLE_RULE_CONSTRAINT_PROFILES = {
         '核查页面是否落在 src/views、路由是否落在 src/router/modules，并保持动态导入。',
         '核查 API 是否通过 src/api 封装、类型是否放在 src/api/types，页面中未直接调 request。',
         '核查样式是否使用主题变量、scoped 或 CSS Modules，而不是硬编码全局样式。',
-        '核查 Pinia/store、mock 与 proposal/specs/design/tasks 的边界是否一致，避免“演示页写成生产页”。',
+        '核查 Pinia/store、mock 与 proposal/specs/tasks 的边界是否一致，避免“演示页写成生产页”。',
       ],
     },
   },
@@ -545,7 +540,7 @@ const ROLE_RULE_REPO_SPECIFIC = {
     },
     'requirement-analyst': {
       repo_specific: (facts) => [
-        facts.routeModulesDir ? `当前仓库已有路由模块目录 ${facts.routeModulesDir}，proposal/specs/design/tasks 需要按该目录组织。` : '若项目尚未接入 vue-router，需要在 proposal/specs/design/tasks 明确是补路由还是保持占位入口。',
+        facts.routeModulesDir ? `当前仓库已有路由模块目录 ${facts.routeModulesDir}，proposal/specs/tasks 需要按该目录组织。` : '若项目尚未接入 vue-router，需要在 proposal/specs/tasks 明确是补路由还是保持占位入口。',
         facts.viewsDir ? `页面目录以 ${facts.viewsDir} 为准，任务拆解要写清页面落点。` : null,
       ].filter(Boolean),
     },
@@ -878,7 +873,7 @@ function inferRoutingStrategy(repoConventions, rawInput) {
       : `复用现有路由入口 ${repoConventions.routeEntry}`;
   }
   if (/页面|列表|详情|欢迎|登录|路由|router|page/i.test(text)) {
-    return '仓库未检测到显式路由入口；页面类任务需先补路由骨架或在 proposal/specs/design/tasks 中明确占位入口方案';
+    return '仓库未检测到显式路由入口；页面类任务需先补路由骨架或在 proposal/specs/tasks 中明确占位入口方案';
   }
   return '当前任务不强依赖新增路由，优先保持现有入口结构';
 }
@@ -892,7 +887,7 @@ function inferApiStrategy(repoConventions, rawInput) {
     return `沿用 ${repoConventions.apiDir}${repoConventions.apiTypesDir ? ` + ${repoConventions.apiTypesDir}` : ''} 进行接口与类型拆分`;
   }
   if (/接口|api|请求|分页|搜索|筛选|状态|重试|支付|订单|用户/i.test(text)) {
-    return '仓库尚未检测到稳定 API 封装入口；真实接口任务需先建立请求层或在 proposal/specs/design/tasks 中明确占位方案';
+    return '仓库尚未检测到稳定 API 封装入口；真实接口任务需先建立请求层或在 proposal/specs/tasks 中明确占位方案';
   }
   return '当前任务不强依赖真实接口，优先保持最小数据流';
 }
@@ -905,7 +900,7 @@ function inferMockStrategy(repoConventions, rawInput) {
       : `${repoConventions.mockDir} 可作为 mock-first 兜底方案`;
   }
   if (/mock|演示|占位/i.test(text)) {
-    return '仓库未检测到独立 mock 目录；若采用演示版，需要在 proposal/specs/design/tasks 中明确本地 mock 或页面内占位方案';
+    return '仓库未检测到独立 mock 目录；若采用演示版，需要在 proposal/specs/tasks 中明确本地 mock 或页面内占位方案';
   }
   return '未显式声明 mock-first，按真实接口交付评估';
 }
@@ -1777,15 +1772,15 @@ function inferChangeImpactTargetRole(currentRole, changeImpact, latestInput) {
 function inferArtifactsToUpdate(changeImpact) {
   switch (changeImpact) {
     case 'scope-delta':
-      return ['proposal.md', 'specs/', 'design.md', 'tasks.md', 'checklist.md', 'iterations.md'];
+      return ['proposal.md', 'specs/', 'tasks.md', 'checklist.md', 'iterations.md'];
     case 'archive-fix':
-      return ['tasks.md', 'design.md', 'checklist.md', 'iterations.md', 'code'];
+      return ['tasks.md', 'checklist.md', 'iterations.md', 'code'];
     case 'followup-patch':
-      return ['proposal.md', 'specs/', 'design.md', 'tasks.md', 'checklist.md', 'iterations.md', 'code'];
+      return ['proposal.md', 'specs/', 'tasks.md', 'checklist.md', 'iterations.md', 'code'];
     case 'patch':
-      return ['tasks.md', 'design.md', 'checklist.md', 'iterations.md', 'code'];
+      return ['tasks.md', 'checklist.md', 'iterations.md', 'code'];
     case 're-scope':
-      return ['proposal.md', 'specs/', 'design.md', 'tasks.md'];
+      return ['proposal.md', 'specs/', 'tasks.md'];
     default:
       return [];
   }
@@ -2418,13 +2413,12 @@ function collectChangeArtifactIntentText(targetDir, changeId, currentRun) {
   if (artifactBase) {
     candidates.push(
       path.join(artifactBase, 'proposal.md'),
-      path.join(artifactBase, 'design.md'),
       path.join(artifactBase, 'tasks.md'),
     );
   }
 
   if (currentRun?.artifacts && typeof currentRun.artifacts === 'object') {
-    for (const key of ['proposal', 'design', 'tasks']) {
+    for (const key of ['proposal', 'tasks']) {
       if (typeof currentRun.artifacts[key] === 'string') {
         candidates.push(path.join(targetDir, currentRun.artifacts[key]));
       }
@@ -2697,7 +2691,7 @@ function buildArtifactContract(roleId, roleRuleContract, roleSkillContract, flow
         done_when: '每个增量 spec 都能回指接口、路由或样式约束，并至少包含一个可验证场景。',
       },
       {
-        artifact: 'design.md',
+        artifact: 'tasks.md',
         required_rules: ruleIds.filter((id) => ['project-structure', 'component-standard', 'route-standard', 'api-standard', 'style-standard'].includes(id)),
         preferred_skills: primarySkills.filter((id) => ['create-proposal', 'design-analysis'].includes(id)),
         done_when: '页面、组件、路由、API、mock、状态和样式落点都已对齐到当前仓库结构。',
@@ -2779,7 +2773,7 @@ function buildSkillSelectionPolicy(roleId, roleSkillContract, flowId = DEFAULT_F
     return {
       primary_order: primaryOrder,
       use_when: [
-        { when: '生成 proposal/specs/design/tasks', skills: ['create-proposal'] },
+        { when: '生成 proposal/specs/tasks', skills: ['create-proposal'] },
         { when: '输入包含设计稿、视觉还原或复杂交互', skills: ['design-analysis'] },
       ],
       fallback_rule: ruleFirst,
@@ -2907,7 +2901,7 @@ function buildHandoffChecklist(roleId, repoConventions, flowId = DEFAULT_FLOW_ID
 
   if (roleId === 'requirement-analyst') {
     return [
-      '页面、路由、API、mock、状态和样式落点已写入 design.md 或 tasks.md。',
+      '页面、路由、API、mock、状态和样式落点已写入 tasks.md。',
       '真实接口与 mock-first 边界已写清，未把未确认契约伪装成已定事实。',
       '待确认项已区分阻断问题还是默认假设，必要时保留 before-implementation 门禁。',
     ];
@@ -2997,7 +2991,6 @@ function buildArchivePreflight(targetDir, changeId, currentRun) {
   const items = [
     { artifact: 'proposal.md', rel_path: path.join(artifactBase, 'proposal.md'), ready: fs.existsSync(path.join(targetDir, artifactBase, 'proposal.md')), source_stage: 'requirement-analyst' },
     { artifact: 'specs/', rel_path: path.join(artifactBase, 'specs'), ready: fs.existsSync(path.join(targetDir, artifactBase, 'specs')), source_stage: 'requirement-analyst' },
-    { artifact: 'design.md', rel_path: path.join(artifactBase, 'design.md'), ready: fs.existsSync(path.join(targetDir, artifactBase, 'design.md')), source_stage: 'requirement-analyst' },
     { artifact: 'tasks.md', rel_path: path.join(artifactBase, 'tasks.md'), ready: fs.existsSync(path.join(targetDir, artifactBase, 'tasks.md')), source_stage: 'requirement-analyst' },
     { artifact: 'code', rel_path: null, ready: hasFrontendDelivery, source_stage: 'frontend-implementer' },
     { artifact: 'implementation-notes', rel_path: null, ready: hasFrontendDelivery, source_stage: 'frontend-implementer' },
@@ -3009,7 +3002,7 @@ function buildArchivePreflight(targetDir, changeId, currentRun) {
   return {
     ready: missingArtifacts.length === 0,
     summary: missingArtifacts.length === 0
-      ? 'proposal/specs/design/tasks/code/implementation-notes/checklist/iterations 已齐备，可以执行归档命令。'
+      ? 'proposal/specs/tasks/code/implementation-notes/checklist/iterations 已齐备，可以执行归档命令。'
       : `仍缺少 ${missingArtifacts.join('、')}，当前不允许执行归档命令。`,
     missing_artifacts: missingArtifacts,
     items,
@@ -3099,7 +3092,7 @@ function buildRoleSpecificContract(
       ],
       blocking_checks: [
         '是否新增真实 API、路由、全局状态、权限/支付/风控/合规逻辑；若是，立即阻断 quick-fix。',
-        '是否出现跨模块范围扩张、验收口径变化或需要补 proposal/specs/design/tasks 的情况。',
+        '是否出现跨模块范围扩张、验收口径变化或需要补 proposal/specs/tasks 的情况。',
         'checklist.md 是否明确写出通过 / 未通过 / 阻断项 / 证据 / 是否放行。',
       ],
       verification_expectations: verificationExpectations,
@@ -3176,11 +3169,11 @@ function buildRoleSpecificContract(
   if (roleId === 'requirement-analyst') {
     return {
       ...base,
-      summary: '先按项目规则把需求收敛成 proposal/specs/design/tasks，再把高风险缺口转成门禁或待确认项。',
-      expected_outputs: ['proposal.md', 'specs/', 'design.md', 'tasks.md'],
+      summary: '先按项目规则把需求收敛成 proposal/specs/tasks，再把高风险缺口转成门禁或待确认项。',
+      expected_outputs: ['proposal.md', 'specs/', 'tasks.md'],
       must_resolve: [
         '页面/路由/API/mock/样式落点需和仓库约定一致',
-        '至少产出一个 specs/<domain>/spec.md，并在 design.md 说明实现落点',
+        '至少产出一个 specs/<domain>/spec.md，并在 tasks.md 说明实现落点',
         '能从项目规则与代码推断的信息优先转成 assumptions',
         '在 tasks.md 中把关键规则约束转成可执行任务项，而不是保留成抽象建议',
       ],
@@ -3190,7 +3183,7 @@ function buildRoleSpecificContract(
   if (roleId === 'frontend-implementer') {
     return {
       ...base,
-      summary: '按 proposal/specs/design/tasks 与项目目录、路由、API、样式约定完成实现，不擅自扩 scope。',
+      summary: '按 proposal/specs/tasks 与项目目录、路由、API、样式约定完成实现，不擅自扩 scope。',
       implementation_focus: [
         repoConventions.viewsDir ? `页面落点优先对齐 ${repoConventions.viewsDir}` : '页面落点需与仓库 views 约定一致',
         repoConventions.routeModulesDir ? `路由修改优先对齐 ${repoConventions.routeModulesDir}` : '若新增路由，需先确认路由入口与模块组织方式',
@@ -3212,10 +3205,10 @@ function buildRoleSpecificContract(
 
     return {
       ...base,
-      summary: '按 proposal/specs/design/tasks 和项目规范核查目录落点、路由/API/样式/Test 合规性，再给交付结论。',
+      summary: '按 proposal/specs/tasks 和项目规范核查目录落点、路由/API/样式/Test 合规性，再给交付结论。',
       review_focus: [
         '页面/组件/路由/API/mock/store 是否落到正确目录',
-        '实现边界是否仍符合 proposal/specs/design/tasks 与审批限制',
+        '实现边界是否仍符合 proposal/specs/tasks 与审批限制',
         '样式是否继续使用主题变量与作用域样式',
       ],
       evidence_targets: evidenceTargets,
@@ -3227,10 +3220,10 @@ function buildRoleSpecificContract(
         '审计结论是否按 14-审计汇报规范给出读取记录、操作记录、规范对齐、技能状态与偏差披露',
         repoConventions.styleEntry ? `样式是否沿用 ${repoConventions.styleEntry} 及主题变量，不存在硬编码颜色或全局污染` : '样式是否继续使用主题变量和作用域样式',
         '是否出现与本次任务无关的扩改、顺手重构或越权补功能',
-        '实现是否越过 proposal/specs/design/tasks 或审批约束，把演示页扩成生产能力',
+        '实现是否越过 proposal/specs/tasks 或审批约束，把演示页扩成生产能力',
       ],
       scope_guard: [
-        '只按 proposal/specs/design/tasks 与已批准范围审查，不接受静默扩 scope',
+        '只按 proposal/specs/tasks 与已批准范围审查，不接受静默扩 scope',
         '高风险领域未批准的真实支付、敏感采集、风控/权限逻辑必须继续阻断',
         'mock / 占位实现不得伪装成可直接上线的真实交付',
       ],
@@ -3284,7 +3277,7 @@ function buildRoleSpecificContract(
       summary: '从验收视角检查验证链路是否闭环，并补强交付前的验证结论。',
       expected_outputs: ['verification-review-notes', 'acceptance-risks'],
       must_resolve: [
-        'proposal/specs/design/tasks 的关键验收项是否已有对应验证',
+        'proposal/specs/tasks 的关键验收项是否已有对应验证',
         '指出仍需补充的验证动作或残留风险',
       ],
     };
@@ -3579,24 +3572,10 @@ function findArchivedChangeDir(targetDir, changeId) {
   if (fs.existsSync(activeDir) && fs.existsSync(path.join(activeDir, 'proposal.md'))) {
     return { dir: activeDir, status: 'active' };
   }
-  // 2. 扫描归档目录
-  const archiveRoot = path.join(targetDir, 'openspec', 'changes', 'archive');
-  if (!fs.existsSync(archiveRoot)) {
-    return null;
-  }
-  const entries = fs.readdirSync(archiveRoot, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    // 归档目录格式: YYYY-MM-DD-{changeId} 或 YYYY-MM-DD-{changeId}-{suffix}
-    const match = entry.name.match(/^\d{4}-\d{2}-\d{2}-(.+)$/);
-    if (!match) continue;
-    const archivedId = match[1].replace(/-\d+$/, ''); // 去掉末尾的冲突后缀
-    if (archivedId === changeId || entry.name.endsWith(`-${changeId}`) || entry.name === changeId) {
-      const dir = path.join(archiveRoot, entry.name);
-      if (fs.existsSync(path.join(dir, 'proposal.md')) || fs.existsSync(path.join(dir, 'tasks.md'))) {
-        return { dir, status: 'archived', archiveName: entry.name };
-      }
-    }
+  // 2. 检查 openspec/specs/{changeId}.md 是否已归档
+  const specFile = path.join(targetDir, 'openspec', 'specs', `${changeId}.md`);
+  if (fs.existsSync(specFile)) {
+    return { dir: path.dirname(specFile), status: 'archived', specFile };
   }
   return null;
 }
@@ -3604,53 +3583,42 @@ function findArchivedChangeDir(targetDir, changeId) {
 function matchArchivedChanges(targetDir, userInput) {
   const path = require('path');
   const fs = require('fs');
-  const archiveRoot = path.join(targetDir, 'openspec', 'changes', 'archive');
-  if (!fs.existsSync(archiveRoot)) {
+  const specsDir = path.join(targetDir, 'openspec', 'specs');
+  if (!fs.existsSync(specsDir)) {
     return [];
   }
   const text = String(userInput || '').trim().toLowerCase();
   if (!text) return [];
 
-  const entries = fs.readdirSync(archiveRoot, { withFileTypes: true });
+  const files = fs.readdirSync(specsDir, { withFileTypes: true });
   const candidates = [];
 
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const match = entry.name.match(/^(\d{4}-\d{2}-\d{2})-(.+)$/);
-    if (!match) continue;
-
-    const archiveDate = match[1];
-    const rawId = match[2].replace(/-\d+$/, ''); // 去掉冲突后缀
-    const dir = path.join(archiveRoot, entry.name);
+  for (const entry of files) {
+    if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+    const rawId = entry.name.replace(/\.md$/, '');
+    const filePath = path.join(specsDir, entry.name);
 
-    // 读 proposal.md 提取标题和摘要
-    const proposalPath = path.join(dir, 'proposal.md');
+    // 读 spec 文件提取标题和摘要
     let title = rawId;
     let summary = '';
-    if (fs.existsSync(proposalPath)) {
-      const content = fs.readFileSync(proposalPath, 'utf8');
-      const titleMatch = content.match(/^#\s+(.+)$/m);
-      if (titleMatch) title = titleMatch[1].trim();
-      summary = content.slice(0, 200).replace(/\n/g, ' ').trim();
-    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const titleMatch = content.match(/^#\s+(.+)$/m);
+    if (titleMatch) title = titleMatch[1].trim();
+    summary = content.slice(0, 200).replace(/\n/g, ' ').trim();
 
-    // 双向子串匹配：检查用户输入是否包含标题/ID，或标题/ID是否包含用户输入中的关键词
+    // 双向子串匹配
     let score = 0;
     const rawIdLower = rawId.toLowerCase().replace(/-/g, '');
     const titleLower = title.toLowerCase();
     const summaryLower = summary.toLowerCase();
 
-    // 用户输入包含标题
     if (titleLower.length >= 2 && text.includes(titleLower)) score += 5;
-    // 用户输入包含 change-id
     if (rawIdLower.length >= 3 && text.includes(rawIdLower)) score += 4;
-    // 标题包含用户输入中的2-4字中文片段
     const chineseSegments = text.match(/[\u4e00-\u9fa5]{2,4}/g) || [];
     for (const seg of chineseSegments) {
       if (titleLower.includes(seg)) score += 2;
       else if (summaryLower.includes(seg)) score += 1;
     }
-    // 英文单词匹配
     const englishWords = text.match(/[a-z][a-z0-9-]{2,}/g) || [];
     for (const word of englishWords) {
       const wordNorm = word.replace(/-/g, '');
@@ -3662,8 +3630,7 @@ function matchArchivedChanges(targetDir, userInput) {
     if (score > 0) {
       candidates.push({
         change_id: rawId,
-        archive_dir: entry.name,
-        archive_date: archiveDate,
+        spec_file: entry.name,
         title,
         summary: summary.slice(0, 100),
         score,
@@ -3787,7 +3754,7 @@ function buildExecutionExamplePayload(dispatch, roleDefinition) {
     : {};
   const examples = {
     'requirement-analyst': {
-      summary: '已完成 proposal/specs/design/tasks，并标记实现前审批关注点。',
+      summary: '已完成 proposal/specs/tasks，并标记实现前审批关注点。',
       next_action: '执行 protocol-advance，进入 before-implementation 审批。',
       assumptions: ['默认沿用当前仓库的 mock-first 与目录落点约定。'],
     },
@@ -3895,7 +3862,6 @@ function buildExpertExpectedOutput(dispatch, writes, runtimePaths, deliveryProfi
   if (dispatch.role?.id === 'requirement-analyst') {
     outputs.push(deliveryProfile === 'micro' ? '完成短版 openspec proposal.md' : '完成 openspec proposal.md');
     outputs.push(deliveryProfile === 'micro' ? '完成短版 openspec specs/<domain>/spec.md（可多份）' : '完成 openspec specs/<domain>/spec.md（可多份）');
-    outputs.push(deliveryProfile === 'micro' ? '完成短版 openspec design.md' : '完成 openspec design.md');
     outputs.push(deliveryProfile === 'micro' ? '完成短版 openspec tasks.md' : '完成 openspec tasks.md');
   } else if (dispatch.role?.id === 'frontend-implementer') {
     outputs.push('完成当前范围内的代码实现');
@@ -4618,11 +4584,6 @@ function buildApprovalGateTurn(targetDir, status, currentArtifacts, snapshot = n
       label: 'specs for approval review',
     }));
   }
-  if (!useCompactArchiveGate && currentArtifacts.run?.artifacts?.design) {
-    reads.push(buildReadableTarget(targetDir, currentArtifacts.run.artifacts.design, {
-      label: 'design for approval review',
-    }));
-  }
   if (pendingGate === 'before-archive') {
     if (currentArtifacts.run?.artifacts?.checklist) {
       reads.push(buildReadableTarget(targetDir, currentArtifacts.run.artifacts.checklist, {
@@ -4849,7 +4810,7 @@ function buildUpdateReviewTurn(targetDir, status, currentArtifacts, snapshot = n
         target_role: changeDecision?.target_role || null,
         handoff_gate: changeDecision?.handoff_gate || null,
         delta_rules: [
-          'proposal/specs/design/tasks/checklist/iterations 只改受影响章节，不整份重写',
+          'proposal/specs/tasks/checklist/iterations 只改受影响章节，不整份重写',
           '优先在同一 change 内吸收 patch / scope-delta / archive-fix',
           '只有明显跨范围时才建议新建 change',
         ],
@@ -5362,7 +5323,7 @@ function tryApplyBeforeArchiveFastPath(targetDir, userInput) {
       action: 'complete-without-archive',
       updated,
       final_state: completed.state,
-      archived_to: null,
+      specs_stored_at: null,
     };
   }
 
@@ -5385,7 +5346,7 @@ function tryApplyBeforeArchiveFastPath(targetDir, userInput) {
     action: 'archive-approved',
     updated,
     final_state: archiveResult.runtime_transition?.state || approved.state,
-    archived_to: archiveResult.archived_to || null,
+    specs_stored_at: archiveResult.specs_stored_at || null,
   };
 }
 
@@ -5534,7 +5495,7 @@ function updateProtocolInput(options = {}) {
   if (explicitChangeId) {
     const archived = findArchivedChangeDir(targetDir, explicitChangeId);
     if (!archived) {
-      throw new Error(`找不到变更 ${explicitChangeId}：未找到 openspec/changes/${explicitChangeId} 或 openspec/changes/archive/ 中对应目录`);
+      throw new Error(`找不到变更 ${explicitChangeId}：未找到 openspec/changes/${explicitChangeId} 或 openspec/specs/${explicitChangeId}.md`);
     }
     const patchChangeId = createFollowupPatchChangeId(explicitChangeId, userInput);
     const flowDefinition = loadFlowDefinition(targetDir, DEFAULT_FLOW_ID);
@@ -5603,7 +5564,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: 'followup-patch-opened',
-        archived_to: null,
+        specs_stored_at: null,
         run_status: bootstrap.state?.status || null,
         current_role: bootstrap.state?.current_role || null,
         requires_followup_turn: true,
@@ -5631,14 +5592,14 @@ function updateProtocolInput(options = {}) {
         fast_path: {
           executed: true,
           action: 'archived-changes-matched',
-          archived_to: null,
+          specs_stored_at: null,
           run_status: null,
           current_role: null,
           requires_followup_turn: false,
           candidates: candidates.map((c) => ({
             change_id: c.change_id,
             title: c.title,
-            archive_date: c.archive_date,
+            spec_file: c.spec_file,
             summary: c.summary,
           })),
           hint: '请使用 --change-id <change_id> 确认要对哪个需求做增量修改',
@@ -5662,7 +5623,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: 'resume-paused-run',
-        archived_to: null,
+        specs_stored_at: null,
         run_status: resumed.state?.status || null,
         current_role: resumed.state?.current_role || null,
         requires_followup_turn: true,
@@ -5691,7 +5652,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: 'confirm-resume',
-        archived_to: null,
+        specs_stored_at: null,
         run_status: resumed.state?.status || null,
         current_role: resumed.state?.current_role || null,
         requires_followup_turn: true,
@@ -5713,7 +5674,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: approvalGateFastPath.action,
-        archived_to: null,
+        specs_stored_at: null,
         run_status: approvalGateFastPath.final_state?.status || null,
         current_role: approvalGateFastPath.final_state?.current_role || null,
         requires_followup_turn: true,
@@ -5735,7 +5696,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: fastPath.action,
-        archived_to: fastPath.archived_to,
+        specs_stored_at: fastPath.specs_stored_at,
         run_status: fastPath.final_state?.status || null,
         current_role: fastPath.final_state?.current_role || null,
         requires_followup_turn: false,
@@ -5757,7 +5718,7 @@ function updateProtocolInput(options = {}) {
       fast_path: {
         executed: true,
         action: followupPatch.action,
-        archived_to: null,
+        specs_stored_at: null,
         run_status: followupPatch.bootstrap.state?.status || null,
         current_role: followupPatch.bootstrap.state?.current_role || null,
         requires_followup_turn: true,
@@ -5795,7 +5756,7 @@ function updateProtocolInput(options = {}) {
     fast_path: {
       executed: false,
       action: null,
-      archived_to: null,
+      specs_stored_at: null,
       run_status: updated.state?.status || null,
       current_role: updated.state?.current_role || null,
       requires_followup_turn: true,

package/openspec/config.yaml.template

@@ -21,10 +21,9 @@ context: |
 
 rules:
   proposal:
-    - "先收敛目标、范围、非目标项、默认假设和风险，再进入实现。"
-    - "能从项目规则和代码推断的内容，优先写入 assumptions，不重复标记为缺失输入。"
+    - "先收敛目标、范围和风险，再进入实现。"
     - "涉及页面、路由、接口、状态、样式时，必须对齐项目既有落点。"
-    - "proposal.md 需要写清业务目标、工程目标、组件复用策略、设计链接和变更入口。"
+    - "proposal.md 写清业务与工程目标、纳入/排除范围、约束与风险。"
   specs:
     - "需求必须落为可测试的增量规范和场景。"
     - "涉及 UI 时，验收场景应覆盖关键布局、状态和交互。"
@@ -36,17 +35,9 @@ rules:
     - "涉及 UI 时必须明确验收方式；涉及接口时必须明确封装方式。"
     - "保持改动最小化，聚焦于请求的变更。"
     - "涉及安装、路径、runtime、归档或 IDE 适配时，必须包含跨平台验证任务。"
-    - "tasks.md 中每个子任务都必须写明目标、输入、输出、验证点和依赖或前置条件。"
-  design:
-    - "技术方案必须对齐项目目录、路由、API、状态、样式和测试约定。"
-    - "新增能力优先复用现有结构，不因单次变更引入无关重构。"
-    - "涉及路径处理时，必须使用跨平台路径能力，不硬编码路径分隔符。"
-    - "优先复用现有 registry、常量和显式映射，不引入启发式检测、模糊匹配或正则猜测。"
-    - "design.md 需要补齐信息结构、状态管理、组件复用策略和验收路径。"
+    - "tasks.md 每个子任务写明做什么和怎么验。"
   checklist:
-    - "必须明确通过项、未通过项、阻断项和是否建议放行。"
-    - "检查结论必须基于 proposal/tasks、项目规则和实现证据。"
-    - "checklist.md 需要沉淀本地验证、浏览器验证、范围一致性和组件复用检查摘要。"
+    - "检查结论必须基于 specs/tasks、项目规则和实现证据。"
+    - "checklist.md 沉淀通过项、验证结果、未通过/阻断项和建议。"
   iterations:
-    - "必须记录问题、修正动作、残留风险和下轮提醒。"
-    - "iterations.md 需要记录问题来源、修正动作、残留风险和下轮提醒。"
+    - "iterations.md 记录问题与修正、残留风险与下轮提醒。"