speccore 6.83.0 → 6.89.0

package/dist/core/agents/engine/agent-executor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * AGENTS 引擎 — 执行器
+ *
+ * 负责：
+ * 1. 构建 Agent 专用 Prompt（角色定义 + 检查清单 + 输入上下文）
+ * 2. 执行 Agent 分析（生成 prompt 字符串，供外层 AI 调用）
+ * 3. 结果解析与聚合
+ *
+ * v6.84.0+
+ */
+import { AgentDefinition, AgentContext, AgentResult } from './types';
+/**
+ * 为指定 Agent 构建完整的分析 Prompt
+ *
+ * 将 Agent 的角色定义与当前上下文组合，生成可直接发给 AI 的 prompt 字符串
+ */
+export declare function buildAgentPrompt(agent: AgentDefinition, context: AgentContext): string;
+/**
+ * 模拟执行 Agent 任务
+ *
+ * 注意：此函数不直接调用 AI API，而是构建 prompt 并返回给外层调用者。
+ * 外层调用者（如 analyze.ts）将 prompt 发送给 AI，然后将 AI 的响应传回给 parseAgentResponse。
+ *
+ * 返回 { prompt: string, metadata: { agent, context } }
+ */
+export declare function prepareAgentTask(agent: AgentDefinition, context: AgentContext): {
+    prompt: string;
+    metadata: {
+        agentName: string;
+        agentDefinition: AgentDefinition;
+        context: AgentContext;
+    };
+};
+/**
+ * 解析 Agent 的 AI 响应为结构化结果
+ *
+ * 这是一个启发式解析器，从 AI 返回的 Markdown 文本中提取结构化信息。
+ */
+export declare function parseAgentResponse(agentName: string, response: string, duration?: number): AgentResult;
+/**
+ * 将多个 Agent 的结果聚合为统一报告
+ */
+export declare function mergeAgentResults(results: AgentResult[]): {
+    allPassed: boolean;
+    totalFindings: number;
+    criticalCount: number;
+    majorCount: number;
+    report: string;
+};
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/core/agents/engine/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/engine/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAa,WAAW,EAAgB,MAAM,SAAS,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAsFtF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;CAC1F,CAUA;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAU,GACnB,WAAW,CA6Db;AAUD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAmCA"}

package/dist/core/agents/engine/agent-executor.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * AGENTS 引擎 — 执行器
+ *
+ * 负责：
+ * 1. 构建 Agent 专用 Prompt（角色定义 + 检查清单 + 输入上下文）
+ * 2. 执行 Agent 分析（生成 prompt 字符串，供外层 AI 调用）
+ * 3. 结果解析与聚合
+ *
+ * v6.84.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentPrompt = buildAgentPrompt;
+exports.prepareAgentTask = prepareAgentTask;
+exports.parseAgentResponse = parseAgentResponse;
+exports.mergeAgentResults = mergeAgentResults;
+/**
+ * 为指定 Agent 构建完整的分析 Prompt
+ *
+ * 将 Agent 的角色定义与当前上下文组合，生成可直接发给 AI 的 prompt 字符串
+ */
+function buildAgentPrompt(agent, context) {
+    const sections = [];
+    // 1. 角色注入
+    sections.push(agent.rolePrompt);
+    sections.push('');
+    // 2. 输入上下文
+    sections.push('---');
+    sections.push('# 输入上下文');
+    sections.push('');
+    if (context.iteration) {
+        sections.push(`- 迭代: ${context.iteration}`);
+    }
+    if (context.platform) {
+        sections.push(`- 端: ${context.platform}`);
+    }
+    if (context.project?.industry) {
+        sections.push(`- 行业: ${context.project.industry}`);
+    }
+    sections.push('');
+    // 3. 任务特定输入
+    if (context.docContent) {
+        sections.push('## 需求文档内容');
+        sections.push('');
+        sections.push('```');
+        const content = String(context.docContent);
+        sections.push(content.slice(0, 8000));
+        if (content.length > 8000) {
+            sections.push('\n... (文档过长，已截断，请继续读取完整文档)');
+        }
+        sections.push('```');
+        sections.push('');
+    }
+    if (context.qualityIssues && Array.isArray(context.qualityIssues) && context.qualityIssues.length > 0) {
+        sections.push('## 已识别的质量问题');
+        sections.push('');
+        for (const issue of context.qualityIssues) {
+            sections.push(`- ${issue}`);
+        }
+        sections.push('');
+    }
+    if (context.codeContent) {
+        sections.push('## 代码内容');
+        sections.push('');
+        sections.push('```');
+        const code = String(context.codeContent);
+        sections.push(code.slice(0, 6000));
+        if (code.length > 6000) {
+            sections.push('\n... (代码过长，已截断)');
+        }
+        sections.push('```');
+        sections.push('');
+    }
+    // 4. 输出格式要求
+    if (agent.outputFormat) {
+        sections.push('---');
+        sections.push('# 输出要求');
+        sections.push('');
+        sections.push(agent.outputFormat);
+        sections.push('');
+    }
+    // 5. 通用输出格式（结构化）
+    sections.push('---');
+    sections.push('# 输出格式（必须严格遵守）');
+    sections.push('');
+    sections.push('请以以下结构输出分析结果：');
+    sections.push('');
+    sections.push('## 总体评估');
+    sections.push('通过 / 不通过');
+    sections.push('');
+    sections.push('## 发现的问题');
+    sections.push('对每个问题，按以下格式：');
+    sections.push('- [严重级别] [类别]: [问题描述] → [修改建议]');
+    sections.push('');
+    sections.push('## 改进建议');
+    sections.push('（可选）具体的修改方案');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * 模拟执行 Agent 任务
+ *
+ * 注意：此函数不直接调用 AI API，而是构建 prompt 并返回给外层调用者。
+ * 外层调用者（如 analyze.ts）将 prompt 发送给 AI，然后将 AI 的响应传回给 parseAgentResponse。
+ *
+ * 返回 { prompt: string, metadata: { agent, context } }
+ */
+function prepareAgentTask(agent, context) {
+    const prompt = buildAgentPrompt(agent, context);
+    return {
+        prompt,
+        metadata: {
+            agentName: agent.name,
+            agentDefinition: agent,
+            context,
+        },
+    };
+}
+/**
+ * 解析 Agent 的 AI 响应为结构化结果
+ *
+ * 这是一个启发式解析器，从 AI 返回的 Markdown 文本中提取结构化信息。
+ */
+function parseAgentResponse(agentName, response, duration = 0) {
+    const findings = [];
+    let passed = true;
+    // 1. 解析总体评估
+    const overallMatch = response.match(/##\s+总体评估\s*\n\s*(通过|不通过|PASS|FAIL|✅|❌)/i);
+    if (overallMatch) {
+        const verdict = overallMatch[1].toLowerCase();
+        passed = !verdict.includes('不') && !verdict.includes('fail') && !verdict.includes('❌');
+    }
+    // 2. 解析问题列表
+    // 格式: - [严重级别] [类别]: [问题描述] → [修改建议]
+    const issuePattern = /^\s*[-*]\s*\[?(critical|major|minor|info|严重|重要|一般|提示)\]?\s*\[?([^\]]+)\]?\s*[:：]\s*(.+?)(?:→|->|\s-\s)(.+)$/gim;
+    let m;
+    while ((m = issuePattern.exec(response)) !== null) {
+        const severity = mapSeverity(m[1]);
+        findings.push({
+            severity,
+            category: m[2].trim(),
+            message: m[3].trim(),
+            suggestion: m[4].trim(),
+        });
+        if (severity === 'critical' || severity === 'major') {
+            passed = false;
+        }
+    }
+    // 3. 备用解析：简单列表项
+    if (findings.length === 0) {
+        const listPattern = /^\s*[-*]\s*(.+)$/gm;
+        while ((m = listPattern.exec(response)) !== null) {
+            const text = m[1].trim();
+            if (text.length < 5)
+                continue;
+            if (text.startsWith('[') && text.includes(']:'))
+                continue; // 跳过已解析的
+            // 尝试推断严重级别
+            let severity = 'info';
+            if (/critical|严重|致命|阻塞/i.test(text))
+                severity = 'critical';
+            else if (/major|重要|严重/i.test(text))
+                severity = 'major';
+            else if (/minor|一般|轻微/i.test(text))
+                severity = 'minor';
+            findings.push({
+                severity,
+                category: 'general',
+                message: text,
+            });
+            if (severity === 'critical' || severity === 'major') {
+                passed = false;
+            }
+        }
+    }
+    return {
+        agent: agentName,
+        passed,
+        findings,
+        duration,
+        output: response,
+    };
+}
+function mapSeverity(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes('critical') || lower.includes('严重') || lower.includes('致命'))
+        return 'critical';
+    if (lower.includes('major') || lower.includes('重要'))
+        return 'major';
+    if (lower.includes('minor') || lower.includes('一般') || lower.includes('轻微'))
+        return 'minor';
+    return 'info';
+}
+/**
+ * 将多个 Agent 的结果聚合为统一报告
+ */
+function mergeAgentResults(results) {
+    const allPassed = results.every(r => r.passed);
+    const totalFindings = results.reduce((s, r) => s + r.findings.length, 0);
+    const criticalCount = results.reduce((s, r) => s + r.findings.filter(f => f.severity === 'critical').length, 0);
+    const majorCount = results.reduce((s, r) => s + r.findings.filter(f => f.severity === 'major').length, 0);
+    let report = `# Multi-Agent 审查报告\n\n`;
+    report += `| Agent | 结果 | 发现数 | 耗时 |\n`;
+    report += `| :--- | :--- | :--- | :--- |\n`;
+    for (const r of results) {
+        const icon = r.passed ? '✅' : '❌';
+        report += `| ${r.agent} | ${icon} ${r.passed ? '通过' : '不通过'} | ${r.findings.length} | ${(r.duration / 1000).toFixed(1)}s |\n`;
+    }
+    report += '\n';
+    for (const r of results) {
+        if (r.findings.length === 0)
+            continue;
+        report += `## ${r.agent}\n\n`;
+        for (const f of r.findings) {
+            const icon = f.severity === 'critical' ? '🔴' : f.severity === 'major' ? '🟠' : f.severity === 'minor' ? '🟡' : '🔵';
+            report += `- ${icon} **[${f.severity.toUpperCase()}]** ${f.category}: ${f.message}\n`;
+            if (f.suggestion) {
+                report += `  → ${f.suggestion}\n`;
+            }
+        }
+        report += '\n';
+    }
+    return { allPassed, totalFindings, criticalCount, majorCount, report };
+}
+//# sourceMappingURL=agent-executor.js.map

package/dist/core/agents/engine/agent-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.js","sourceRoot":"","sources":["../../../../src/core/agents/engine/agent-executor.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/engine/agent-loader.d.ts

@@ -0,0 +1,58 @@
+/**
+ * AGENTS 引擎 — 加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/AGENTS/ 目录下的角色定义
+ * 2. 解析 Markdown 文件为 AgentDefinition
+ * 3. 解析 _INDEX.md 注册表
+ * 4. 根据 platform/industry 解析特化版本
+ * 5. 条件过滤和优先级排序
+ *
+ * v6.84.0+
+ */
+import { AgentDefinition, AgentRegistry, AgentContext, ResolvedAgent } from './types';
+/**
+ * 根据 platform/industry 解析特化版本的 Agent 名称
+ *
+ * 优先级：platform-specific > industry-specific > generic
+ */
+export declare function resolveAgentName(baseAgent: string, context: AgentContext, availableAgents: Set<string>): string;
+/**
+ * 加载所有可用的 Agent 定义
+ * 优先读取用户自定义，回退到内置默认
+ */
+export declare function loadAllAgents(projectRoot: string): Promise<Map<string, AgentDefinition>>;
+/**
+ * 加载注册表
+ * 优先读取用户自定义，回退到内置默认
+ */
+export declare function loadRegistry(projectRoot: string): Promise<AgentRegistry>;
+/**
+ * 获取指定命令/阶段下需要激活的 Agent 列表
+ * 返回按优先级排序的 ResolvedAgent 数组
+ *
+ * 混合模式：
+ * 1. 注册表中的核心角色（显式配置，优先）
+ * 2. 用户自定义角色的自描述激活规则（扩展）
+ */
+export declare function resolveAgentsForPhase(command: string, phase: string, context: AgentContext, projectRoot: string): Promise<ResolvedAgent[]>;
+/**
+ * 获取单个 Agent 的定义
+ */
+export declare function loadAgentDefinition(agentName: string, projectRoot: string): Promise<AgentDefinition | undefined>;
+/**
+ * 获取内置 Agent 的原始 Markdown 内容（用于 init 时复制到项目）
+ */
+export declare function getBuiltinAgentContents(): Promise<{
+    name: string;
+    content: string;
+}[]>;
+/**
+ * 获取内置注册表内容（用于 init 时复制到项目）
+ */
+export declare function getBuiltinRegistryContent(): Promise<string | undefined>;
+/**
+ * 获取内置模板内容（用于 init 时复制到项目）
+ */
+export declare function getBuiltinTemplateContent(): Promise<string | undefined>;
+//# sourceMappingURL=agent-loader.d.ts.map

package/dist/core/agents/engine/agent-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loader.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/engine/agent-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,eAAe,EAEf,aAAa,EAEb,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAiOjB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,MAAM,CAkBR;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAmB9F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAa9E;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAoD1B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAGtC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAG5F;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7E;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7E"}