speccore 6.82.0 → 6.89.0

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"}

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

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * AGENTS 引擎 — 加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/AGENTS/ 目录下的角色定义
+ * 2. 解析 Markdown 文件为 AgentDefinition
+ * 3. 解析 _INDEX.md 注册表
+ * 4. 根据 platform/industry 解析特化版本
+ * 5. 条件过滤和优先级排序
+ *
+ * v6.84.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAgentName = resolveAgentName;
+exports.loadAllAgents = loadAllAgents;
+exports.loadRegistry = loadRegistry;
+exports.resolveAgentsForPhase = resolveAgentsForPhase;
+exports.loadAgentDefinition = loadAgentDefinition;
+exports.getBuiltinAgentContents = getBuiltinAgentContents;
+exports.getBuiltinRegistryContent = getBuiltinRegistryContent;
+exports.getBuiltinTemplateContent = getBuiltinTemplateContent;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_AGENTS_DIR = (0, path_1.join)(__dirname, '..', 'defaults');
+// ============================================================
+// 1. Markdown 解析
+// ============================================================
+function parseAgentMarkdown(content, source) {
+    const name = extractHeading(content) || 'unknown';
+    const description = extractSection(content, '职责') || extractSection(content, 'Description') || '';
+    const responsibilities = extractListItems(content, '职责') || extractListItems(content, 'Responsibilities') || [];
+    const inputSpec = extractSection(content, '输入') || extractSection(content, 'Input') || '';
+    const checkList = extractCheckboxItems(content) || [];
+    const outputFormat = extractSection(content, '输出格式') || extractSection(content, 'Output Format') || '';
+    const activations = parseSelfDescribedActivations(content);
+    // rolePrompt = 整个文档内容（作为 AI 的 system prompt 注入）
+    const rolePrompt = content;
+    return {
+        name,
+        description,
+        responsibilities,
+        inputSpec,
+        checkList,
+        outputFormat,
+        rolePrompt,
+        source,
+        activations,
+    };
+}
+/**
+ * 解析 Agent 自描述激活规则
+ * 从 Markdown 中的 "## 激活规则" 或 "## Activations" 部分提取
+ *
+ * 支持格式：
+ * | 命令 | 阶段 | 优先级 | 条件 |
+ * | :--- | :--- | :--- | :--- |
+ * | analyze | clarify | 60 | project.industry == 'finance' |
+ */
+function parseSelfDescribedActivations(content) {
+    const section = extractSection(content, '激活规则') || extractSection(content, 'Activations');
+    if (!section)
+        return [];
+    const activations = [];
+    const lines = section.split('\n').filter(l => l.trim().startsWith('|') && !l.trim().match(/^\|[\s-:]+\|/));
+    for (const line of lines) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 3) {
+            activations.push({
+                command: cells[0],
+                phase: cells[1],
+                priority: parseInt(cells[2], 10) || 50,
+                condition: cells[3] && cells[3] !== '—' && cells[3] !== '-' ? cells[3] : undefined,
+            });
+        }
+    }
+    return activations;
+}
+function extractHeading(content) {
+    const m = content.match(/^#\s+Agent:\s*(.+)$/m);
+    return m?.[1].trim();
+}
+function extractSection(content, sectionName) {
+    const regex = new RegExp(`^##\\s+${sectionName}\\s*\\n(.*?)(?=\\n##\\s|$)`, 'ms');
+    const m = content.match(regex);
+    return m?.[1].trim();
+}
+function extractListItems(content, sectionName) {
+    const section = extractSection(content, sectionName);
+    if (!section)
+        return undefined;
+    const items = [];
+    for (const line of section.split('\n')) {
+        const m = line.match(/^\s*[-*]\s+(.+)$/);
+        if (m)
+            items.push(m[1].trim());
+    }
+    return items.length > 0 ? items : undefined;
+}
+function extractCheckboxItems(content) {
+    const items = [];
+    const matches = content.match(/^\s*-\s*\[[ x]\]\s*(.+)$/gm);
+    if (matches) {
+        for (const m of matches) {
+            const item = m.replace(/^\s*-\s*\[[ x]\]\s*/, '').trim();
+            if (item)
+                items.push(item);
+        }
+    }
+    return items.length > 0 ? items : undefined;
+}
+// ============================================================
+// 2. 注册表解析
+// ============================================================
+function parseRegistryMarkdown(content) {
+    const phases = {};
+    const phaseMatches = content.matchAll(/^##\s+(.+?)\s*\/\s*(.+?)\s*\n([\s\S]*?)(?=\n##\s|$)/gm);
+    for (const match of phaseMatches) {
+        const command = match[1].trim();
+        const phase = match[2].trim();
+        const phaseKey = `${command}/${phase}`;
+        const tableContent = match[3];
+        phases[phaseKey] = parseRegistryTable(tableContent);
+    }
+    return { phases };
+}
+function parseRegistryTable(content) {
+    const entries = [];
+    const lines = content.split('\n').filter(l => l.trim().startsWith('|') && !l.trim().match(/^\|[\s-:]+\|/));
+    for (const line of lines) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 2) {
+            entries.push({
+                agent: cells[0],
+                priority: parseInt(cells[1], 10) || 50,
+                condition: cells[2] && cells[2] !== '—' && cells[2] !== '-' ? cells[2] : undefined,
+                description: cells[3],
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================
+// 3. 条件表达式求值（简单实现）
+// ============================================================
+function evaluateCondition(condition, context) {
+    if (!condition)
+        return true;
+    try {
+        // 支持的格式：
+        // project.industry == 'finance'
+        // project.securityLevel > 2
+        // platform == 'backend'
+        const eqMatch = condition.match(/^(.+?)\s*==\s*['"](.+?)['"]$/);
+        if (eqMatch) {
+            const path = eqMatch[1].trim();
+            const expected = eqMatch[2];
+            const actual = getContextValue(context, path);
+            return String(actual) === expected;
+        }
+        const gtMatch = condition.match(/^(.+?)\s*>\s*(\d+)$/);
+        if (gtMatch) {
+            const path = gtMatch[1].trim();
+            const expected = parseInt(gtMatch[2], 10);
+            const actual = getContextValue(context, path);
+            return Number(actual) > expected;
+        }
+        const gteMatch = condition.match(/^(.+?)\s*>=\s*(\d+)$/);
+        if (gteMatch) {
+            const path = gteMatch[1].trim();
+            const expected = parseInt(gteMatch[2], 10);
+            const actual = getContextValue(context, path);
+            return Number(actual) >= expected;
+        }
+        // 简单布尔：存在即真
+        const path = condition.trim();
+        const actual = getContextValue(context, path);
+        return actual !== undefined && actual !== null && actual !== false;
+    }
+    catch {
+        return true; // 条件解析失败，默认通过
+    }
+}
+function getContextValue(context, path) {
+    const parts = path.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+// ============================================================
+// 4. Agent 扫描与加载
+// ============================================================
+/**
+ * 扫描指定目录下的所有 Agent 定义文件
+ */
+async function scanAgentFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const agents = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue; // _INDEX.md, _TEMPLATE.md 跳过
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        agents.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+            source: dir === BUILTIN_AGENTS_DIR ? 'builtin' : 'user-defined',
+        });
+    }
+    return agents;
+}
+// ============================================================
+// 5. 特化版本解析
+// ============================================================
+/**
+ * 根据 platform/industry 解析特化版本的 Agent 名称
+ *
+ * 优先级：platform-specific > industry-specific > generic
+ */
+function resolveAgentName(baseAgent, context, availableAgents) {
+    const platform = context.platform;
+    const industry = context.project?.industry;
+    // 1. 尝试 platform-specific: product-analyst-backend
+    if (platform) {
+        const platformSpecific = `${baseAgent}-${platform}`;
+        if (availableAgents.has(platformSpecific))
+            return platformSpecific;
+    }
+    // 2. 尝试 industry-specific: security-reviewer-finance
+    if (industry) {
+        const industrySpecific = `${baseAgent}-${industry}`;
+        if (availableAgents.has(industrySpecific))
+            return industrySpecific;
+    }
+    // 3. 回退到通用版
+    return baseAgent;
+}
+// ============================================================
+// 6. 主 API
+// ============================================================
+/**
+ * 加载所有可用的 Agent 定义
+ * 优先读取用户自定义，回退到内置默认
+ */
+async function loadAllAgents(projectRoot) {
+    const agents = new Map();
+    const userAgentsDir = (0, path_1.join)(projectRoot, '.speccore', 'AGENTS');
+    // 1. 先加载内置默认
+    const builtinFiles = await scanAgentFiles(BUILTIN_AGENTS_DIR);
+    for (const f of builtinFiles) {
+        const def = parseAgentMarkdown(f.content, 'builtin');
+        agents.set(f.name, def);
+    }
+    // 2. 用户自定义覆盖（同名覆盖）
+    const userFiles = await scanAgentFiles(userAgentsDir);
+    for (const f of userFiles) {
+        const def = parseAgentMarkdown(f.content, 'user-defined');
+        agents.set(f.name, def);
+    }
+    return agents;
+}
+/**
+ * 加载注册表
+ * 优先读取用户自定义，回退到内置默认
+ */
+async function loadRegistry(projectRoot) {
+    const userIndex = (0, path_1.join)(projectRoot, '.speccore', 'AGENTS', '_INDEX.md');
+    const builtinIndex = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_INDEX.md');
+    let content = '';
+    if (await (0, fs_extra_1.pathExists)(userIndex)) {
+        content = await (0, fs_extra_1.readFile)(userIndex, 'utf-8');
+    }
+    else if (await (0, fs_extra_1.pathExists)(builtinIndex)) {
+        content = await (0, fs_extra_1.readFile)(builtinIndex, 'utf-8');
+    }
+    if (!content)
+        return { phases: {} };
+    return parseRegistryMarkdown(content);
+}
+/**
+ * 获取指定命令/阶段下需要激活的 Agent 列表
+ * 返回按优先级排序的 ResolvedAgent 数组
+ *
+ * 混合模式：
+ * 1. 注册表中的核心角色（显式配置，优先）
+ * 2. 用户自定义角色的自描述激活规则（扩展）
+ */
+async function resolveAgentsForPhase(command, phase, context, projectRoot) {
+    const phaseKey = `${command}/${phase}`;
+    // 1. 加载注册表和 Agent 定义
+    const registry = await loadRegistry(projectRoot);
+    const allAgents = await loadAllAgents(projectRoot);
+    const availableNames = new Set(allAgents.keys());
+    // 2. 收集注册表中的角色
+    const registryEntries = registry.phases[phaseKey] || [];
+    const resolvedMap = new Map();
+    for (const entry of registryEntries) {
+        if (!evaluateCondition(entry.condition, context))
+            continue;
+        const resolvedName = resolveAgentName(entry.agent, context, availableNames);
+        const def = allAgents.get(resolvedName);
+        if (!def)
+            continue;
+        resolvedMap.set(resolvedName, {
+            name: resolvedName,
+            definition: def,
+            priority: entry.priority,
+        });
+    }
+    // 3. 扫描用户自定义角色的自描述激活规则（扩展角色）
+    for (const [agentName, def] of allAgents) {
+        // 只扫描用户自定义的角色（内置角色不扫描自描述规则）
+        if (def.source !== 'user-defined')
+            continue;
+        // 已在注册表中的跳过（注册表优先）
+        if (resolvedMap.has(agentName))
+            continue;
+        for (const act of def.activations) {
+            if (act.command === command && act.phase === phase) {
+                if (evaluateCondition(act.condition, context)) {
+                    resolvedMap.set(agentName, {
+                        name: agentName,
+                        definition: def,
+                        priority: act.priority,
+                    });
+                }
+                break; // 匹配到一个就够了
+            }
+        }
+    }
+    // 4. 按优先级排序（高优先级在前）
+    const resolved = Array.from(resolvedMap.values());
+    resolved.sort((a, b) => b.priority - a.priority);
+    return resolved;
+}
+/**
+ * 获取单个 Agent 的定义
+ */
+async function loadAgentDefinition(agentName, projectRoot) {
+    const allAgents = await loadAllAgents(projectRoot);
+    return allAgents.get(agentName);
+}
+/**
+ * 获取内置 Agent 的原始 Markdown 内容（用于 init 时复制到项目）
+ */
+async function getBuiltinAgentContents() {
+    const files = await scanAgentFiles(BUILTIN_AGENTS_DIR);
+    return files.map(f => ({ name: f.name, content: f.content }));
+}
+/**
+ * 获取内置注册表内容（用于 init 时复制到项目）
+ */
+async function getBuiltinRegistryContent() {
+    const path = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_INDEX.md');
+    if (await (0, fs_extra_1.pathExists)(path)) {
+        return (0, fs_extra_1.readFile)(path, 'utf-8');
+    }
+    return undefined;
+}
+/**
+ * 获取内置模板内容（用于 init 时复制到项目）
+ */
+async function getBuiltinTemplateContent() {
+    const path = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_TEMPLATE.md');
+    if (await (0, fs_extra_1.pathExists)(path)) {
+        return (0, fs_extra_1.readFile)(path, 'utf-8');
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-loader.js.map