speccore 6.82.0 → 6.89.0

package/dist/commands/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAkDA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA8lC3E"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AA4DA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA8lC3E"}

package/dist/commands/analyze.js

@@ -65,6 +65,9 @@ const change_detection_1 = require("../core/change-detection");
 const streaming_analyzer_1 = require("../core/streaming-analyzer");
 // v6.80.0+: 需求澄清模块
 const requirement_clarifier_1 = require("../core/requirement-clarifier");
+// v6.83.0+: 专业 AI 角色定义
+// v6.84.0+: 迁移到规范数据库 (.speccore/AGENTS/)，保留向后兼容
+const agents_1 = require("../core/agents");
 async function analyzeCommand(options) {
     // ── --full / --phase 模式: 委托给 synthesizeCommand（原 synthesize 命令） ──
     if (options.full || options.phase) {
@@ -2996,17 +2999,56 @@ async function buildClarifyPhasePrompt(iteration) {
     if (qualityReports.length > 0) {
         await (0, requirement_clarifier_1.writeClarifyReport)(iterDir, qualityReports);
     }
-    // 构建 Clarify Prompt
-    let prompt = `\n# 任务: 需求专业化（Phase 0: 需求澄清）\n\n`;
-    prompt += `## 你的角色\n`;
-    prompt += `你是资深产品经理 + 领域专家。请将迭代 "${iteration}" 的需求文档整理为专业的 PRD 级需求规格说明书。\n\n`;
-    prompt += `## 质量评价摘要\n\n`;
+    // v6.84.0+: 从 AGENTS 规范数据库动态加载角色
+    let prompt = `\n# 任务: 需求专业化（Phase 0: 需求澄清，v6.84.0+)\n\n`;
+    const projectRoot = (0, task_utils_1.findProjectRoot)() || process.cwd();
+    const agentContext = {
+        iteration,
+        iterationDir: iterDir,
+    };
+    try {
+        const resolvedAgents = await (0, agents_1.resolveAgentsForPhase)('analyze', 'clarify', agentContext, projectRoot);
+        if (resolvedAgents.length > 0) {
+            // 动态注入角色定义
+            for (const ra of resolvedAgents) {
+                prompt += ra.definition.rolePrompt;
+                prompt += '\n\n';
+            }
+        }
+        else {
+            // 回退到硬编码角色（向后兼容）
+            prompt += agents_1.PRODUCT_ANALYST_ROLE;
+            prompt += '\n\n';
+            prompt += agents_1.INTERACTION_DESIGNER_ROLE;
+            prompt += '\n\n';
+        }
+    }
+    catch {
+        // 回退到硬编码角色（向后兼容）
+        prompt += agents_1.PRODUCT_ANALYST_ROLE;
+        prompt += '\n\n';
+        prompt += agents_1.INTERACTION_DESIGNER_ROLE;
+        prompt += '\n\n';
+    }
+    prompt += `## 质量评价摘要（7维度）\n\n`;
     for (const r of qualityReports) {
         const name = r.filePath.split('/').pop() || '-';
-        prompt += `- **${name}**: 评分 ${r.overallScore}/100 (${r.level.toUpperCase()})\n`;
+        prompt += `### ${name} — 综合评分 ${r.overallScore}/100 (${r.level.toUpperCase()})\n\n`;
+        prompt += `| 维度 | 评分 | 问题数 | 状态 |\n`;
+        prompt += `| :--- | :--- | :--- | :--- |\n`;
+        for (const dim of r.dimensions) {
+            const badge = dim.score >= 80 ? '🟢' : dim.score >= 50 ? '🟡' : '🔴';
+            prompt += `| ${badge} ${dim.name} | ${dim.score}/100 | ${dim.issues.length} | ${dim.issues.length === 0 ? '✅' : '⚠️ 需改进'} |\n`;
+        }
+        prompt += '\n';
+        // 详细问题（只列出问题项）
         for (const dim of r.dimensions) {
             if (dim.issues.length > 0) {
-                prompt += `  - ${dim.name}: ${dim.score}分 — ${dim.issues.join('、')}\n`;
+                prompt += `**${dim.name}** 需改进：\n`;
+                for (let i = 0; i < dim.issues.length; i++) {
+                    prompt += `- ${dim.issues[i]} → ${dim.suggestions[i] || '请优化'}\n`;
+                }
+                prompt += '\n';
             }
         }
     }
@@ -3017,35 +3059,108 @@ async function buildClarifyPhasePrompt(iteration) {
     prompt += `3. \`010-requirements/converted/*.md\` — 已转换文档\n`;
     prompt += `4. \`010-requirements/features/*/README.md\` — 功能级补充\n`;
     prompt += `5. \`010-requirements/prototypes/\` — 原型文件\n\n`;
-    prompt += `## 整理要求\n\n`;
+    prompt += `---\n\n`;
+    prompt += `# 📋 五步迭代澄清流程\n\n`;
+    prompt += `> 本阶段要求你先以专业角色深度分析，再生成改写版，与用户反复迭代确认，最终写入。\n\n`;
+    prompt += `## Step 1: 深度专业分析\n\n`;
+    prompt += `对每份需求文档，分别以 **产品分析师** 和 **交互设计师** 两个角色进行深度审查：\n\n`;
+    prompt += `**产品分析师审查清单**：\n`;
+    prompt += `- [ ] 每条业务流程是否有明确的起点、步骤、分支、终点\n`;
+    prompt += `- [ ] 状态流转是否闭环（所有状态都有进入和退出条件）\n`;
+    prompt += `- [ ] 是否遗漏了异常分支（网络失败、权限不足、数据为空、超时）\n`;
+    prompt += `- [ ] 是否遗漏了逆向流程（取消、退款、退货、撤销）\n`;
+    prompt += `- [ ] 关键状态变化是否有通知机制（站内信/推送/邮件/短信）\n`;
+    prompt += `- [ ] 并发场景是否有处理（重复提交、幂等性）\n`;
+    prompt += `- [ ] 术语是否统一（同一概念不能有两个名称）\n\n`;
+    prompt += `**交互设计师审查清单**：\n`;
+    prompt += `- [ ] 每个页面/组件是否有 Loading 状态定义\n`;
+    prompt += `- [ ] 每个列表/表格是否有 Empty State 定义\n`;
+    prompt += `- [ ] 每个操作是否有 Error State 定义\n`;
+    prompt += `- [ ] 列表/表格是否有分页/筛选/排序逻辑\n`;
+    prompt += `- [ ] 不可逆操作是否有二次确认\n`;
+    prompt += `- [ ] 表单是否有完整的校验规则\n`;
+    prompt += `- [ ] 不同角色的权限控制是否明确\n`;
+    prompt += `- [ ] 前后端校验规则是否一致\n`;
+    prompt += `- [ ] 数据刷新策略是什么（实时/手动/轮询/WebSocket）\n\n`;
+    prompt += `**输出**：输出一份《深度审查报告》，列出所有发现的问题和修改建议。\n\n`;
+    prompt += `## Step 2: 生成改写版（Draft v1）\n\n`;
+    prompt += `基于 Step 1 的审查报告，生成一份 **完整的专业 PRD 文档**，要求：\n\n`;
     prompt += `### 必须包含的章节\n`;
-    prompt += `1. **背景与目标**：为什么要做这个功能，解决什么问题\n`;
-    prompt += `2. **用户故事**：作为 [角色]，我希望 [目标]，以便 [价值]\n`;
-    prompt += `3. **功能规格**：功能清单、详细描述、业务规则、异常场景\n`;
-    prompt += `4. **验收标准（AC）**：可测试的、具体的验收条件，每条用 \`[ ]\` 标记\n`;
-    prompt += `5. **非功能需求**：性能、安全、兼容性等（如适用）\n`;
-    prompt += `6. **依赖与约束**：依赖的其他系统/模块\n`;
-    prompt += `7. **功能边界**：明确「做什么」和「不做什么」\n\n`;
+    prompt += `1. **背景与目标**：为什么要做这个功能，解决什么问题，预期收益\n`;
+    prompt += `2. **术语表（Glossary）**：文档中所有专业术语的统一表述\n`;
+    prompt += `3. **用户故事**：作为 [角色]，我希望 [目标]，以便 [价值]（每个功能一个）\n`;
+    prompt += `4. **功能规格**（按模块组织）：\n`;
+    prompt += `   - 功能清单（带唯一需求编号 R-01, R-02...）\n`;
+    prompt += `   - 每个功能的详细描述（输入、处理、输出）\n`;
+    prompt += `   - 业务流程（正常流程 + 异常分支 + 状态流转图）\n`;
+    prompt += `   - 页面交互逻辑（页面结构、用户操作、反馈机制、权限控制）\n`;
+    prompt += `   - 业务规则（校验、约束、状态流转条件）\n`;
+    prompt += `   - 异常场景和边界条件（网络失败、权限不足、数据为空、超时）\n`;
+    prompt += `5. **验收标准（AC）**：可测试的、具体的验收条件，每条用 \`[ ]\` 标记，必须量化\n`;
+    prompt += `6. **非功能需求**：性能、安全、兼容性、可访问性等\n`;
+    prompt += `7. **依赖与约束**：依赖的其他系统/模块，技术/业务约束\n`;
+    prompt += `8. **功能边界**：明确「做什么」和「不做什么」\n`;
+    prompt += `9. **待确认事项**：标注需要用户确认的内容（不要编造）\n\n`;
     prompt += `### 质量要求\n`;
-    prompt += `- 为每个功能点分配唯一需求编号（如 R-01, R-02）\n`;
-    prompt += `- 统一术语表述，不要同一概念用不同词汇\n`;
+    prompt += `- 统一术语，建立术语表\n`;
     prompt += `- 验收标准必须量化（如响应时间<200ms，成功率>99%）\n`;
-    prompt += `- 如果原始描述不完整，标注「待补充」而不是编造\n`;
-    prompt += `- 不要添加文档中未提及的功能\n\n`;
-    prompt += `## 输出格式\n\n`;
-    prompt += `直接输出整理后的 Markdown PRD 文档。\n`;
-    prompt += `文档末尾附加「原始输入」章节。\n\n`;
-    prompt += `## 写入方式\n\n`;
+    prompt += `- 业务流程必须包含异常分支\n`;
+    prompt += `- 前端交互必须包含 Loading/Empty/Error 状态\n`;
+    prompt += `- 不要添加文档中未提及的功能\n`;
+    prompt += `- 如果原始描述不完整，标注「待确认」而不是编造\n\n`;
+    prompt += `**输出**：将 Draft v1 的内容暂存，进入 Step 3。\n\n`;
+    prompt += `## Step 3: 生成对比视图\n\n`;
+    prompt += `生成一份 **原文档 vs 改写版（Draft v1）的对比报告**，格式如下：\n\n`;
+    prompt += `\`\`\`\n`;
+    prompt += `## 需求澄清对比报告\n\n`;
+    prompt += `### 重大改进（原文缺失 → 改写版补充）\n`;
+    prompt += `| 改进项 | 原文状态 | 改写版补充 | 影响 |\n`;
+    prompt += `| :--- | :--- | :--- | :--- |\n`;
+    prompt += `| 示例：订单状态流转 | ❌ 未定义 | ✅ 定义了 5 种状态及转换条件 | 避免状态不一致 bug |\n\n`;
+    prompt += `### 交互完善（原文模糊 → 改写版明确）\n`;
+    prompt += `| 改进项 | 原文描述 | 改写版描述 |\n`;
+    prompt += `| :--- | :--- | :--- |\n`;
+    prompt += `| 示例：提交按钮 | 「点击提交」 | 「点击后显示 Loading，成功后跳转，失败后显示错误信息」 |\n\n`;
+    prompt += `### 待确认事项\n`;
+    prompt += `- [ ] 事项 1：需要用户确认的业务规则\n`;
+    prompt += `- [ ] 事项 2：需要用户补充的边界条件\n\n`;
+    prompt += `### 建议取舍\n`;
+    prompt += `- 建议保留改写版的改进（原因）\n`;
+    prompt += `- 建议保留原文的表述（原因）\n`;
+    prompt += `\`\`\`\n\n`;
+    prompt += `**输出**：将对比报告展示给用户，进入 Step 4。\n\n`;
+    prompt += `## Step 4: 迭代确认（多轮对话）\n\n`;
+    prompt += `将 **对比报告** 和 **Draft v1** 一起展示给用户，然后：\n\n`;
+    prompt += `1. **询问用户意见**：\n`;
+    prompt += `   - "以上是我对需求文档的专业分析和改写，请检查是否有以下问题："\n`;
+    prompt += `   - "业务流程是否正确？"\n`;
+    prompt += `   - "交互逻辑是否完整？"\n`;
+    prompt += `   - "是否有遗漏的功能点？"\n`;
+    prompt += `   - "是否有不需要的功能？"\n\n`;
+    prompt += `2. **接收用户反馈**：\n`;
+    prompt += `   - 如果用户提出修改意见 → 生成 **Draft v2** → 重新生成对比 → 回到步骤 1 询问\n`;
+    prompt += `   - 可以迭代多轮（v1 → v2 → v3 ...），直到用户满意\n`;
+    prompt += `   - 每轮迭代都要生成新的对比报告，标注本轮修改\n\n`;
+    prompt += `3. **迭代原则**：\n`;
+    prompt += `   - 尊重用户决策：用户说保留原文的，保留原文\n`;
+    prompt += `   - 专业建议：用户遗漏的，以「建议补充」形式提出，不强加\n`;
+    prompt += `   - 记录取舍：每轮迭代记录「采纳/拒绝/待确认」的决策\n\n`;
+    prompt += `## Step 5: 确认写入\n\n`;
+    prompt += `当用户确认 "满意，可以写入" 后：\n\n`;
+    prompt += `1. 将最终版 PRD 写入 \`010-requirements/converted/clarified-{源文件名}-{日期}.md\`\n`;
+    prompt += `2. 同时生成 \`010-requirements/converted/clarified-{源文件名}-{日期}-diff.md\` 保存最终对比报告\n`;
+    prompt += `3. 使用以下命令写入：\n\n`;
     prompt += `\`\`\`bash\n`;
-    prompt += `speccore analyze --apply '{"010-requirements/converted/clarified-xxx.md":"..."}' -I ${iteration}\n`;
+    prompt += `speccore analyze --apply '{"010-requirements/converted/clarified-xxx.md":"...","010-requirements/converted/clarified-xxx-diff.md":"..."}' -I ${iteration}\n`;
     prompt += `\`\`\`\n\n`;
-    prompt += `> 注意：写入 clarified-*.md 后，CLI 会自动推进到需求确认阶段。\n`;
+    prompt += `> 注意：写入后 CLI 会自动推进到需求确认阶段。\n`;
     return prompt;
 }
 async function buildConfirmCheckPrompt(iteration) {
     const iterDir = await (0, context_1.getIterationDir)(iteration);
     const reportPath = (0, path_1.join)(iterDir, '010-requirements', 'CLARIFY_REPORT.md');
-    let prompt = `\n# 任务: 需求确认（Phase 0: 确认检查）\n\n`;
+    const convertedDir = (0, path_1.join)(iterDir, '010-requirements', 'converted');
+    let prompt = `\n# 任务: 需求确认（Phase 0: 确认检查，v6.83.0+）\n\n`;
     if (await (0, fs_extra_1.pathExists)(reportPath)) {
         const report = await (0, fs_extra_2.readFile)(reportPath, 'utf-8');
         prompt += `## 需求澄清报告\n\n`;
@@ -3054,17 +3169,46 @@ async function buildConfirmCheckPrompt(iteration) {
             prompt += `\n\n... (报告共 ${report.length} 字符，已截断)\n`;
         }
     }
-    prompt += `\n## 确认要求\n\n`;
-    prompt += `1. 检查 clarified-*.md 是否已写入 \`010-requirements/converted/\`\n`;
-    prompt += `2. 确认验收标准是否可测试、可量化\n`;
-    prompt += `3. 确认功能边界是否明确（不做什么）\n`;
-    prompt += `4. 如有「待补充」项，确认是否已解决\n\n`;
-    prompt += `## 操作\n\n`;
-    prompt += `如果确认无误，直接执行以下命令进入技术方案生成阶段：\n\n`;
+    // v6.83.0+: 检查是否有 diff 文件
+    let diffFiles = [];
+    if (await (0, fs_extra_1.pathExists)(convertedDir)) {
+        try {
+            const entries = await (0, fs_extra_2.readdir)(convertedDir);
+            diffFiles = entries.filter(f => f.includes('-diff.md'));
+        }
+        catch { /* ignore */ }
+    }
+    if (diffFiles.length > 0) {
+        prompt += `\n## 已生成的对比报告\n\n`;
+        for (const f of diffFiles) {
+            prompt += `- \`converted/${f}\` — 需求澄清对比记录\n`;
+        }
+        prompt += '\n';
+    }
+    prompt += `## 确认检查清单\n\n`;
+    prompt += `请逐项确认：\n\n`;
+    prompt += `- [ ] clarified-*.md 已写入 \`010-requirements/converted/\`\n`;
+    prompt += `- [ ] 验收标准可测试、可量化\n`;
+    prompt += `- [ ] 功能边界明确（不做什么）\n`;
+    prompt += `- [ ] 业务流程完整（含异常分支）\n`;
+    prompt += `- [ ] 交互逻辑完整（Loading/Empty/Error 状态）\n`;
+    prompt += `- [ ] 术语统一（已建立术语表）\n`;
+    prompt += `- [ ] 所有「待确认」事项已解决\n\n`;
+    prompt += `## 操作选项\n\n`;
+    prompt += `**选项 A：确认通过，进入技术方案生成**\n`;
     prompt += `\`\`\`bash\n`;
     prompt += `speccore analyze --prompt -I ${iteration} --pipeline\n`;
     prompt += `\`\`\`\n\n`;
-    prompt += `> 当前是 Pipeline 模式，确认后 CLI 会自动推进到 Phase 1。\n`;
+    prompt += `**选项 B：需要重新澄清（返回迭代）**\n`;
+    prompt += `如果对需求文档不满意，可以返回重新澄清：\n`;
+    prompt += `\`\`\`bash\n`;
+    prompt += `speccore analyze --prompt -I ${iteration} --pipeline --skip-clarify=false\n`;
+    prompt += `\`\`\`\n`;
+    prompt += `> 重新进入 clarify-prompt 阶段，AI 会基于已有 draft 继续迭代。\n\n`;
+    prompt += `**选项 C：跳过确认，直接进入分析（风险自负）**\n`;
+    prompt += `\`\`\`bash\n`;
+    prompt += `speccore analyze --prompt -I ${iteration} --pipeline --skip-clarify\n`;
+    prompt += `\`\`\`\n`;
     return prompt;
 }
 //# sourceMappingURL=analyze.js.map