speccore 8.3.158 → 8.3.160

package/dist/core/agent-adapter.js

@@ -0,0 +1,425 @@
+"use strict";
+/**
+ * AgentAdapter — 子 Agent 统一适配层
+ *
+ * v8.3.160+: 实现子 Agent 隔离，解决上下文漂移问题。
+ * 每个 Pipeline 步骤可以指定 subagent，由适配层负责：
+ *   1. 准备该 subagent 所需的紧凑上下文
+ *   2. 控制上下文大小（Token 预算）
+ *   3. 输出子 Agent 激活标记和指令
+ *
+ * 适配模式:
+ *   - Headless: 基于文件/状态机模拟子 Agent（默认，无需 SDK）
+ *   - QoderSdk: 通过 Qoder SDK API 创建独立子 Agent（预留接口）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAdapter = exports.QoderSdkAdapter = exports.HeadlessAdapter = void 0;
+exports.createAgentAdapter = createAgentAdapter;
+const logger_1 = require("../utils/logger");
+// ── 全局子 Agent 注册表 ──
+const subagentRegistry = new Map();
+// ── 默认子 Agent 配置（以 _INDEX.md 角色定义为准） ──
+const DEFAULT_SUBAGENTS = [
+    // analyze / clarify 阶段
+    {
+        name: 'product-analyst',
+        description: '产品分析师：业务流程完整性、遗漏识别、术语统一',
+        systemPrompt: '你是 SpecCore 产品分析师。你的职责是审查业务流程完整性、识别需求遗漏、检查术语统一性。输出格式：Markdown 产品分析报告。',
+        defaultContextType: 'full',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/product-analyst.md'],
+    },
+    {
+        name: 'interaction-designer',
+        description: '交互设计师：信息架构、状态矩阵、前后端一致性',
+        systemPrompt: '你是 SpecCore 交互设计师。你的职责是设计页面信息架构、定义交互状态矩阵、检查前后端交互一致性。输出格式：Markdown 交互审查报告。',
+        defaultContextType: 'full',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/interaction-designer.md'],
+    },
+    {
+        name: 'security-reviewer',
+        description: '安全审查员：认证授权、输入验证、数据保护',
+        systemPrompt: '你是 SpecCore 安全审查员。你的职责是识别需求/代码中的安全风险，检查认证、授权、输入验证、数据保护。输出格式：安全问题列表。',
+        defaultContextType: 'full',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/security-reviewer.md'],
+    },
+    // analyze 阶段
+    {
+        name: 'spec-analyzer',
+        description: '需求分析专家：逐端分析、架构设计、技术方案',
+        systemPrompt: '你是 SpecCore 需求分析专家。你的职责是根据需求文档和契约，为指定端生成完整的技术规格。必须遵循 CONSTITUTION.md 中的命名规范和端名标准。输出格式：Markdown 技术文档。',
+        defaultContextType: 'platform-only',
+        // v8.3.160+: 配合按需加载优化，降至 10K
+        defaultContextBudget: 10000,
+        skills: ['.speccore/AGENTS/product-analyst-backend.md', '.speccore/AGENTS/product-analyst-frontend.md'],
+    },
+    // execute 阶段
+    {
+        name: 'spec-executor',
+        description: '代码生成专家：读取规格、生成代码、遵循规范',
+        systemPrompt: '你是 SpecCore 代码生成专家。你的职责是根据 TASK.md 和技术规格，生成符合项目规范的代码实现。必须遵循 CONSTITUTION.md 的命名规范、端名标准和错误码体系。输出格式：JSON 文件列表。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 10000,
+        skills: ['.speccore/SKILLS/execute.md'],
+    },
+    // execute / quality-gate 阶段
+    // v8.3.160+: compiler 合并 test-engineer 职责（quality-gate-build）
+    {
+        name: 'compiler',
+        description: '构建质量检查员：编译检查 + 测试覆盖',
+        systemPrompt: '你是 SpecCore 构建质量检查员。你的职责是：1) 检查代码编译可行性，识别语法错误和类型错误；2) 检查单元测试和集成测试覆盖率，确保新增代码有配套测试。输出格式：构建质量报告（含编译结果 + 测试覆盖）。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 8000,
+        skills: ['.speccore/AGENTS/compiler.md', '.speccore/AGENTS/test-engineer.md'],
+    },
+    // v8.3.160+: security-reviewer 合并 performance-expert 职责（quality-gate-nfr）
+    {
+        name: 'security-reviewer',
+        description: '非功能质量检查员：安全审查 + 性能检测',
+        systemPrompt: '你是 SpecCore 非功能质量检查员。你的职责是：1) 识别代码中的安全风险（认证、授权、输入验证、数据保护）；2) 检查性能瓶颈（N+1 查询、内存泄漏、不必要的重渲染）。输出格式：非功能质量报告（含安全 + 性能）。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 6000,
+        skills: ['.speccore/AGENTS/security-reviewer.md', '.speccore/AGENTS/performance-expert.md'],
+    },
+    {
+        name: 'doc-sync-agent',
+        description: '文档同步检查员：代码与文档一致性',
+        systemPrompt: '你是 SpecCore 文档同步检查员。你的职责是检查代码与文档的一致性，确保 API 文档与实际接口匹配，注释和文档未过时。输出格式：文档同步报告。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 3000,
+        skills: ['.speccore/AGENTS/doc-sync-agent.md'],
+    },
+    // split 阶段
+    {
+        name: 'task-decomposer',
+        description: '任务拆分专家：功能模块拆分为原子级开发任务',
+        systemPrompt: '你是 SpecCore 任务拆分专家。你的职责是将功能模块拆分为原子级开发任务，确保每个任务可独立执行、可验收，工时控制在 2h-8h。输出格式：任务列表。',
+        defaultContextType: 'full',
+        defaultContextBudget: 8000,
+        skills: ['.speccore/AGENTS/task-decomposer.md'],
+    },
+    {
+        name: 'dependency-analyst',
+        description: '依赖关系分析师：任务间依赖、循环依赖检测',
+        systemPrompt: '你是 SpecCore 依赖关系分析师。你的职责是识别任务间的依赖关系，构建任务依赖图，发现循环依赖，推荐任务执行顺序。输出格式：依赖分析报告。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 5000,
+        skills: ['.speccore/AGENTS/dependency-analyst.md'],
+    },
+    {
+        name: 'effort-estimator',
+        description: '工时估算专家：任务工时估算',
+        systemPrompt: '你是 SpecCore 工时估算专家。你的职责是根据任务复杂度和历史数据，为每个任务估算工时。输出格式：工时估算表。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 4000,
+        skills: [],
+    },
+    // global-analyze 阶段
+    {
+        name: 'spec-global-analyzer',
+        description: '全局分析专家：跨迭代依赖、全局架构、一致性检查',
+        systemPrompt: '你是 SpecCore 全局分析专家。你的职责是分析跨迭代的依赖关系、全局架构一致性和技术债务。必须识别所有跨端关联和重复实现。输出格式：Markdown 全局报告。',
+        defaultContextType: 'full',
+        // v8.3.160+: 配合按需加载优化，降至 10K
+        defaultContextBudget: 10000,
+        skills: ['.speccore/SKILLS/global-analyze.md'],
+    },
+    // plan 阶段（预留）
+    {
+        name: 'schedule-planner',
+        description: '排期规划专家：任务排期、资源分配',
+        systemPrompt: '你是 SpecCore 排期规划专家。你的职责是根据任务列表和人员配置，生成执行计划，识别可并行的任务批次。输出格式：执行计划。',
+        defaultContextType: 'full',
+        defaultContextBudget: 6000,
+        skills: ['.speccore/AGENTS/schedule-planner.md'],
+    },
+    {
+        name: 'risk-assessor',
+        description: '风险评估专家：技术风险、依赖风险识别',
+        systemPrompt: '你是 SpecCore 风险评估专家。你的职责是评估任务执行中的技术风险和依赖风险，参考 RISK.md 和 .issues.md。输出格式：风险评估报告。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/risk-assessor.md'],
+    },
+    // change 阶段（预留）
+    {
+        name: 'impact-analyst',
+        description: '影响范围分析师：变更影响分析',
+        systemPrompt: '你是 SpecCore 影响范围分析师。你的职责是分析变更对现有代码、文档、测试的影响范围，识别需要同步修改的关联模块。输出格式：影响范围分析报告。',
+        defaultContextType: 'full',
+        defaultContextBudget: 6000,
+        skills: ['.speccore/AGENTS/impact-analyst.md'],
+    },
+    {
+        name: 'regression-tester',
+        description: '回归测试专家：回归测试范围确定',
+        systemPrompt: '你是 SpecCore 回归测试专家。你的职责是根据变更内容确定回归测试范围，确保变更不会破坏已有功能。输出格式：回归测试计划。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/regression-tester.md'],
+    },
+    // pr 阶段（预留）
+    {
+        name: 'code-reviewer',
+        description: '代码审查员：代码质量、可读性、可维护性',
+        systemPrompt: '你是 SpecCore 代码审查员。你的职责是审查代码质量、可读性、可维护性，检查是否符合项目编码规范。输出格式：代码审查报告。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 6000,
+        skills: ['.speccore/AGENTS/code-reviewer.md'],
+    },
+    {
+        name: 'test-reviewer',
+        description: '测试审查员：测试完整性审查',
+        systemPrompt: '你是 SpecCore 测试审查员。你的职责是审查测试代码的完整性和有效性，确保测试覆盖所有场景。输出格式：测试审查报告。',
+        defaultContextType: 'incremental',
+        defaultContextBudget: 4000,
+        skills: ['.speccore/AGENTS/test-reviewer.md'],
+    },
+];
+// ═══════════════════════════════════════════════════════════
+// HeadlessAdapter — 基于文件/状态机的子 Agent 模拟
+// ═══════════════════════════════════════════════════════════
+class HeadlessAdapter {
+    constructor() {
+        this.registry = new Map(subagentRegistry);
+        // 注册默认子 Agent
+        for (const config of DEFAULT_SUBAGENTS) {
+            if (!this.registry.has(config.name)) {
+                this.registry.set(config.name, config);
+            }
+        }
+    }
+    getMode() {
+        return 'headless';
+    }
+    registerSubagent(name, config) {
+        this.registry.set(name, config);
+        logger_1.logger.debug(`[AgentAdapter] 注册子 Agent: ${name}`);
+    }
+    getSubagentConfig(name) {
+        return this.registry.get(name);
+    }
+    /** 准备子 Agent 的紧凑上下文 */
+    async prepareContext(ctx) {
+        const config = this.registry.get(ctx.subagent);
+        const lines = [];
+        // 1. 子 Agent 角色定义
+        if (config) {
+            lines.push(`## 🤖 子 Agent: ${config.name}`);
+            lines.push(`> ${config.description}`);
+            lines.push('');
+            lines.push('### 角色定义');
+            lines.push(config.systemPrompt);
+            lines.push('');
+        }
+        // 2. 上下文预算提醒
+        lines.push(`### 上下文预算`);
+        lines.push(`- 可用 Token: ~${ctx.contextBudget}`);
+        lines.push(`- 加载模式: ${ctx.contextType}`);
+        lines.push('');
+        // 3. 根据 contextType 加载不同范围的上下文
+        if (ctx.contextSnapshot) {
+            lines.push('### 已完成步骤');
+            for (const step of ctx.contextSnapshot.completedSteps) {
+                lines.push(`- ✅ ${step}`);
+            }
+            lines.push('');
+            if (ctx.contextSnapshot.completedOutputs.length > 0) {
+                lines.push('### 已完成产出（文件路径）');
+                for (const output of ctx.contextSnapshot.completedOutputs) {
+                    lines.push(`- 📄 ${output}`);
+                }
+                lines.push('');
+            }
+        }
+        // 4. 增量模式下只加载路径引用
+        if (ctx.contextType === 'incremental') {
+            lines.push('> 💡 增量模式：已完成的产出文件已在上方列出，需要时按需 Read，不要全文加载到上下文中。');
+            lines.push('');
+        }
+        // 5. platform-only 模式下提示只加载当前端
+        if (ctx.contextType === 'platform-only' && ctx.platform) {
+            lines.push(`> 💡 平台隔离模式：只加载 ${ctx.platform} 端的规格，其他端的内容通过文件路径引用。`);
+            lines.push('');
+        }
+        // 6. contract-only 模式下提示只加载契约
+        if (ctx.contextType === 'contract-only') {
+            lines.push('> 💡 契约模式：只加载跨端 API 契约，不涉及具体实现细节。');
+            lines.push('');
+        }
+        // 7. v8.3.160+: 按角色裁剪上下文 —— 告诉 AI 哪些文件需要全文读取，哪些只需路径引用
+        lines.push('### 上下文裁剪策略');
+        const roleHints = {
+            'product-analyst': [
+                '📖 **全文读取**：迭代目录 010-requirements/ 下的所有需求文档',
+                '📖 **全文读取**：已有的 CLARIFY_REPORT.md（如有）',
+                '🔗 **路径引用**：020-specs/ 下的已有规格（按需 Read）',
+                '❌ **不加载**：代码实现、构建配置、测试用例',
+            ],
+            'interaction-designer': [
+                '📖 **全文读取**：需求文档中的交互流程、页面描述',
+                '📖 **全文读取**：原型图文件（010-requirements/prototypes/）',
+                '🔗 **路径引用**：技术栈交互约束（.speccore/RULES/frontend-*.md）',
+                '❌ **不加载**：后端 API 实现细节、数据库设计',
+            ],
+            'security-reviewer': [
+                '📖 **全文读取**：安全规则（.speccore/RULES/security.md）',
+                ctx.contextType === 'incremental'
+                    ? '📖 **全文读取**：当前代码实现（重点检查输入验证、认证授权）'
+                    : '📖 **全文读取**：需求文档中的安全相关描述',
+                '🔗 **路径引用**：OWASP 检查清单',
+            ],
+            'compiler': [
+                '📖 **全文读取**：新生成的代码文件',
+                '📖 **全文读取**：构建配置文件（tsconfig.json / pom.xml / build.gradle 等）',
+                '🔗 **路径引用**：技术栈编译规则（.speccore/RULES/{技术栈}.md）',
+                '❌ **不加载**：需求文档、测试用例',
+            ],
+            'test-engineer': [
+                '📖 **全文读取**：代码实现（重点检查可测试性）',
+                '📖 **全文读取**：TEST.md 中的测试用例',
+                '📖 **全文读取**：覆盖率报告（如有）',
+                '🔗 **路径引用**：技术栈测试规范',
+            ],
+            'performance-expert': [
+                '📖 **全文读取**：代码实现（重点检查数据库查询、循环、渲染）',
+                '📖 **全文读取**：性能基准数据（如有）',
+                '🔗 **路径引用**：技术栈性能规范',
+                '❌ **不加载**：需求文档全文',
+            ],
+            'doc-sync-agent': [
+                '📖 **全文读取**：代码中的 API 定义、注释',
+                '📖 **全文读取**：文档中的 API 规格',
+                '🔗 **路径引用**：技术栈文档格式规范',
+                '❌ **不加载**：测试用例、性能数据',
+            ],
+            'spec-analyzer': [
+                '📖 **全文读取**：需求文档、跨端契约',
+                '📖 **全文读取**：CONSTITUTION.md（命名规范、端名标准）',
+                '🔗 **路径引用**：已有端的规格（参考但不全文加载）',
+            ],
+            'spec-executor': [
+                '📖 **全文读取**：TASK.md、TECH.md',
+                '📖 **全文读取**：结构化代码事实卡片（匹配相关部分）',
+                '🔗 **路径引用**：已有代码文件（按需 Read，不全文加载）',
+            ],
+            'task-decomposer': [
+                '📖 **全文读取**：需求文档全文（010-requirements/）',
+                '📖 **全文读取**：功能模块清单',
+                '🔗 **路径引用**：端列表（CONSTITUTION.md）',
+            ],
+            'dependency-analyst': [
+                '📖 **全文读取**：任务列表、需求文档中的依赖描述',
+                '🔗 **路径引用**：已有代码的模块结构',
+            ],
+            'code-reviewer': [
+                '📖 **全文读取**：代码变更（diff）',
+                '📖 **全文读取**：编码规范（.speccore/RULES/{技术栈}.md）',
+                '🔗 **路径引用**：需求文档（按需确认）',
+            ],
+            'test-reviewer': [
+                '📖 **全文读取**：测试代码',
+                '📖 **全文读取**：测试规范（.speccore/RULES/testing.md）',
+                '🔗 **路径引用**：被测代码文件',
+            ],
+            'impact-analyst': [
+                '📖 **全文读取**：变更内容、依赖图谱',
+                '🔗 **路径引用**：模块结构文档',
+            ],
+            'regression-tester': [
+                '📖 **全文读取**：变更内容、测试策略',
+                '🔗 **路径引用**：已有测试用例',
+            ],
+        };
+        const hints = roleHints[ctx.subagent];
+        if (hints) {
+            for (const hint of hints) {
+                lines.push(`- ${hint}`);
+            }
+        }
+        else {
+            lines.push('- 按上下文类型默认加载');
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    /** 构建子 Agent 激活标记 */
+    buildActivationPrompt(ctx, nextPrompt) {
+        const config = this.registry.get(ctx.subagent);
+        const lines = [];
+        lines.push(`[SPECCORE_SUBAGENT: ${ctx.subagent}]`);
+        if (config) {
+            lines.push(`[SPECCORE_SUBAGENT_DESC: ${config.description}]`);
+        }
+        lines.push(`[SPECCORE_CONTEXT_BUDGET: ${ctx.contextBudget}]`);
+        lines.push(`[SPECCORE_CONTEXT_TYPE: ${ctx.contextType}]`);
+        lines.push('');
+        lines.push('--- 子 Agent 上下文 ---');
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+exports.HeadlessAdapter = HeadlessAdapter;
+// ═══════════════════════════════════════════════════════════
+// QoderSdkAdapter — Qoder SDK 深度集成（预留接口）
+// ═══════════════════════════════════════════════════════════
+class QoderSdkAdapter {
+    // private sdkClient: any; // Qoder SDK 客户端（运行时动态加载）
+    constructor() {
+        this.registry = new Map(subagentRegistry);
+        for (const config of DEFAULT_SUBAGENTS) {
+            if (!this.registry.has(config.name)) {
+                this.registry.set(config.name, config);
+            }
+        }
+    }
+    getMode() {
+        return 'qoder-sdk';
+    }
+    registerSubagent(name, config) {
+        this.registry.set(name, config);
+    }
+    getSubagentConfig(name) {
+        return this.registry.get(name);
+    }
+    async prepareContext(ctx) {
+        // TODO: 通过 Qoder SDK 创建子 Agent，传递 systemPrompt 和上下文
+        // 当前回退到 Headless 实现
+        logger_1.logger.warn('[QoderSdkAdapter] SDK 未初始化，回退到 Headless 模式');
+        const headless = new HeadlessAdapter();
+        return headless.prepareContext(ctx);
+    }
+    buildActivationPrompt(ctx, nextPrompt) {
+        // TODO: 调用 Qoder SDK 创建子 Agent 并触发执行
+        // 当前回退到 Headless 实现
+        const headless = new HeadlessAdapter();
+        return headless.buildActivationPrompt(ctx, nextPrompt);
+    }
+}
+exports.QoderSdkAdapter = QoderSdkAdapter;
+// ═══════════════════════════════════════════════════════════
+// 工厂函数
+// ═══════════════════════════════════════════════════════════
+function createAgentAdapter(mode) {
+    const envMode = process.env.SPECCORE_AGENT_MODE;
+    const effectiveMode = mode || envMode || 'headless';
+    if (effectiveMode === 'qoder-sdk') {
+        // 检查 Qoder SDK 是否可用
+        try {
+            // require('@qoder/sdk'); // 运行时检查
+            logger_1.logger.info('[AgentAdapter] 使用 Qoder SDK 模式');
+            return new QoderSdkAdapter();
+        }
+        catch {
+            logger_1.logger.warn('[AgentAdapter] Qoder SDK 不可用，回退到 Headless 模式');
+            return new HeadlessAdapter();
+        }
+    }
+    logger_1.logger.debug('[AgentAdapter] 使用 Headless 模式');
+    return new HeadlessAdapter();
+}
+// 默认导出 HeadlessAdapter（向后兼容）
+exports.defaultAdapter = new HeadlessAdapter();
+//# sourceMappingURL=agent-adapter.js.map

package/dist/core/agent-adapter.js.map

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

package/dist/core/agents/defaults/_INDEX.md

@@ -10,8 +10,8 @@
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
 | product-analyst | 100 | — | 业务流程完整性、遗漏识别、术语统一 |
-| interaction-designer | 90 | — | 交互状态矩阵、前后端一致性、用户路径 |
-| security-reviewer | 70 | project.securityLevel > 2 | 需求中的安全风险预判 |
+| interaction-designer | 90 | — | 交互状态矩阵、前后端一致性、用户路径（叠加 RULES/ 技术栈交互约束） |
+| security-reviewer | 70 | project.securityLevel > 2 | 需求中的安全风险预判（叠加 RULES/ 技术栈安全规则） |
 
 ## analyze / confirm-check
 
@@ -24,7 +24,7 @@
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
 | task-decomposer | 100 | — | 任务拆分专家 |
-| dependency-analyst | 90 | — | 依赖关系分析 |
+| dependency-analyst | 90 | — | 依赖关系分析（叠加 RULES/ 技术栈依赖模式） |
 | effort-estimator | 70 | — | 工时估算 |
 
 ## plan / default
@@ -38,31 +38,31 @@
 
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
-| compiler | 100 | — | 编译可行性检查 |
-| test-engineer | 90 | — | 单元测试执行与覆盖率 |
-| security-reviewer | 80 | — | 安全漏洞扫描 |
-| performance-expert | 50 | — | 性能回归检测 |
-| doc-sync-agent | 40 | — | 文档与实际代码一致性 |
+| compiler | 100 | — | 编译可行性检查（叠加 RULES/ 技术栈构建规则） |
+| test-engineer | 90 | — | 单元测试执行与覆盖率（叠加 RULES/ 技术栈测试规范） |
+| security-reviewer | 80 | — | 安全漏洞扫描（叠加 RULES/ 技术栈安全规则） |
+| performance-expert | 50 | — | 性能回归检测（叠加 RULES/ 技术栈性能规范） |
+| doc-sync-agent | 40 | — | 文档与实际代码一致性（叠加 RULES/ 技术栈文档格式） |
 
 ## change / impact
 
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
-| impact-analyst | 100 | — | 变更影响范围分析 |
-| regression-tester | 80 | — | 回归测试范围 |
+| impact-analyst | 100 | — | 变更影响范围分析（叠加 RULES/ 技术栈模块结构） |
+| regression-tester | 80 | — | 回归测试范围（叠加 RULES/ 技术栈测试策略） |
 
 ## pr / review
 
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
-| code-reviewer | 100 | — | 代码质量审查 |
-| security-reviewer | 90 | — | 安全审查 |
-| test-reviewer | 80 | — | 测试完整性审查 |
+| code-reviewer | 100 | — | 代码质量审查（叠加 RULES/ 技术栈编码规范） |
+| security-reviewer | 90 | — | 安全审查（叠加 RULES/ 技术栈安全规则） |
+| test-reviewer | 80 | — | 测试完整性审查（叠加 RULES/ 技术栈测试规范） |
 
 ## audit / default
 
 | 角色 | 优先级 | 条件 | 说明 |
 |------|--------|------|------|
-| security-reviewer | 100 | — | 安全审计 |
+| security-reviewer | 100 | — | 安全审计（叠加 RULES/ 技术栈安全规则） |
 | compliance-checker | 90 | project.industry == 'finance' | 合规检查（金融行业） |
-| performance-expert | 70 | — | 性能基线审计 |
+| performance-expert | 70 | — | 性能基线审计（叠加 RULES/ 技术栈性能规范） |

package/dist/core/agents/defaults/code-reviewer.md

@@ -13,6 +13,12 @@ activations:
 - 检查是否符合项目编码规范
 - 识别潜在的性能问题和逻辑错误
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **叠加检查项**：将 RULES 中的技术栈专属编码规范合并到下方审查清单。
+3. **按优先级执行**：先执行通用检查，再执行技术栈专属检查。
+
 ## 审查清单
 
 ### 代码质量
@@ -32,6 +38,9 @@ activations:
 - [ ] 依赖是否合理（无循环依赖）
 - [ ] 是否符合 SOLID 原则
 
+### 技术栈专属检查（根据 RULES/ 叠加）
+- [ ] 在此处补充从 RULES/ 中读取的匹配技术栈的编码规范检查项
+
 ## 输出格式
 
 ```markdown

package/dist/core/agents/defaults/compiler.md

@@ -13,12 +13,21 @@ activations:
 - 识别语法错误和类型错误
 - 确保代码能直接运行
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **确定编译方式**：根据技术栈确定编译/构建命令（如 `tsc`、`javac`、`go build`、`gradle build` 等）和配置文件。
+3. **叠加检查项**：将 RULES 中的技术栈专属编译要求合并到下方检查清单。
+
 ## 检查项
 
+### 通用检查
 1. **语法检查**：无语法错误
-2. **类型检查**：TypeScript 类型通过
-3. **导入检查**：所有依赖可解析
-4. **配置检查**：tsconfig.json / package.json 配置正确
+2. **导入检查**：所有依赖可解析
+3. **配置检查**：构建配置文件正确（根据技术栈确定，如 tsconfig.json / pom.xml / build.gradle 等）
+
+### 技术栈专属检查（根据 RULES/ 叠加）
+- 在此处补充从 RULES/ 中读取的匹配规则中的编译/构建要求
 
 ## 输出
 

package/dist/core/agents/defaults/dependency-analyst.md

@@ -7,6 +7,12 @@ activations:
 
 # 角色：依赖关系分析师 (Dependency Analyst)
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **理解技术栈依赖模式**：不同技术栈的依赖关系不同（如 Maven 的模块依赖、npm 的包依赖、前端组件的 props 依赖等）。
+3. **叠加分析维度**：将 RULES 中的技术栈专属依赖信息合并到下方分析维度。
+
 ## 职责
 
 - 识别任务间的依赖关系（数据依赖、接口依赖、时序依赖）
@@ -19,6 +25,7 @@ activations:
 2. **接口依赖**：前端任务依赖后端任务的 API 契约
 3. **时序依赖**：某些任务必须在其他任务完成后才能开始
 4. **资源依赖**：共享组件/工具/配置的依赖
+5. **技术栈特有依赖**：构建工具链、框架版本、平台特有 API 的依赖关系
 
 ## 输出格式
 

package/dist/core/agents/defaults/doc-sync-agent.md

@@ -7,6 +7,12 @@ activations:
 
 # 角色：文档同步检查员 (Doc Sync Agent)
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **确定文档格式**：根据技术栈确定 API 文档格式（如 OpenAPI、GraphQL Schema、gRPC Proto 等）和文档生成工具。
+3. **叠加检查项**：将 RULES 中的技术栈专属文档规范合并到下方检查清单。
+
 ## 职责
 
 - 检查代码与文档的一致性
@@ -19,6 +25,7 @@ activations:
 2. **数据模型**：文档中的字段定义是否与代码一致
 3. **业务规则**：代码逻辑是否与需求文档一致
 4. **注释时效**：注释是否描述当前代码行为
+5. **技术栈专属文档**：框架特有配置、类型定义、路由声明等是否与文档同步
 
 ## 输出
 

package/dist/core/agents/defaults/impact-analyst.md

@@ -7,6 +7,12 @@ activations:
 
 # 角色：影响范围分析师 (Impact Analyst)
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **理解技术栈模块结构**：不同技术栈的模块边界不同（如 Maven 多模块、npm workspace、Gradle 子项目等）。
+3. **叠加分析维度**：将 RULES 中的技术栈专属结构信息合并到下方分析维度。
+
 ## 职责
 
 - 分析变更对现有代码、文档、测试的影响范围
@@ -20,6 +26,7 @@ activations:
 3. **数据影响**：数据库 schema 变更是否需要迁移
 4. **文档影响**：哪些文档需要同步更新
 5. **测试影响**：哪些测试用例需要新增/修改
+6. **技术栈特有影响**：构建配置、依赖版本、框架升级等是否需要同步调整
 
 ## 输出格式
 

package/dist/core/agents/defaults/interaction-designer.md

@@ -1,5 +1,18 @@
+---
+activations:
+  - command: analyze
+    phase: clarify
+    condition: ""
+---
+
 # Agent: interaction-designer
 
+## 执行前准备
+
+1. **读取技术栈规则**：读取 `.speccore/RULES/` 中 `appliesTo` 匹配当前项目技术栈的规则文件。
+2. **了解技术栈交互能力边界**：不同技术栈的交互能力不同（如 Web 的 WebSocket/SSE、React Native 的原生模块能力、小程序的受限 API 等）。
+3. **叠加约束检查**：将 RULES 中的技术栈专属交互约束合并到下方检查清单。
+
 ## 职责
 
 - 设计清晰直观的页面信息架构
@@ -37,6 +50,10 @@
 - [ ] 前端展示的数据格式 vs 后端返回的格式
 - [ ] 前端状态管理 vs 后端实体状态是否同步
 - [ ] 前端错误码 vs 后端错误码映射
+- [ ] 交互实现是否符合技术栈能力边界（如实时通信方案是否受平台限制）
+
+### 技术栈专属检查（根据 RULES/ 叠加）
+- [ ] 在此处补充从 RULES/ 中读取的匹配技术栈的交互约束（如移动端手势、Web 无障碍规范等）
 
 ### 用户操作路径优化
 - [ ] 最短路径原则：完成核心目标的最少点击数