speccore 8.3.159 → 8.3.160

package/dist/core/agent-adapter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * AgentAdapter — 子 Agent 统一适配层
+ *
+ * v8.3.160+: 实现子 Agent 隔离，解决上下文漂移问题。
+ * 每个 Pipeline 步骤可以指定 subagent，由适配层负责：
+ *   1. 准备该 subagent 所需的紧凑上下文
+ *   2. 控制上下文大小（Token 预算）
+ *   3. 输出子 Agent 激活标记和指令
+ *
+ * 适配模式:
+ *   - Headless: 基于文件/状态机模拟子 Agent（默认，无需 SDK）
+ *   - QoderSdk: 通过 Qoder SDK API 创建独立子 Agent（预留接口）
+ */
+import { ContextSnapshot } from './pipeline-engine';
+export interface AgentContext {
+    /** 子 Agent 名称 */
+    subagent: string;
+    /** 迭代名 */
+    iteration: string;
+    /** 任务 ID */
+    task?: string;
+    /** 端名 */
+    platform?: string;
+    /** 上下文快照 */
+    contextSnapshot?: ContextSnapshot;
+    /** 上下文预算（tokens） */
+    contextBudget: number;
+    /** 上下文加载类型 */
+    contextType: 'full' | 'incremental' | 'platform-only' | 'contract-only';
+    /** 工作区根目录 */
+    cwd: string;
+}
+export interface SubagentConfig {
+    /** 子 Agent 标识名 */
+    name: string;
+    /** 职责描述 */
+    description: string;
+    /** 系统级 Prompt（角色定义） */
+    systemPrompt: string;
+    /** 默认上下文类型 */
+    defaultContextType: 'full' | 'incremental' | 'platform-only' | 'contract-only';
+    /** 默认 Token 预算 */
+    defaultContextBudget: number;
+    /** 关联技能文件路径 */
+    skills: string[];
+}
+export interface AgentAdapter {
+    /** 注册子 Agent 配置 */
+    registerSubagent(name: string, config: SubagentConfig): void;
+    /** 根据 subagent 名获取配置 */
+    getSubagentConfig(name: string): SubagentConfig | undefined;
+    /** 准备子 Agent 的紧凑上下文文本 */
+    prepareContext(ctx: AgentContext): Promise<string>;
+    /** 构建子 Agent 激活标记和指令 */
+    buildActivationPrompt(ctx: AgentContext, nextPrompt: string): string;
+    /** 获取支持的适配模式 */
+    getMode(): 'headless' | 'qoder-sdk';
+}
+export declare class HeadlessAdapter implements AgentAdapter {
+    private registry;
+    constructor();
+    getMode(): 'headless' | 'qoder-sdk';
+    registerSubagent(name: string, config: SubagentConfig): void;
+    getSubagentConfig(name: string): SubagentConfig | undefined;
+    /** 准备子 Agent 的紧凑上下文 */
+    prepareContext(ctx: AgentContext): Promise<string>;
+    /** 构建子 Agent 激活标记 */
+    buildActivationPrompt(ctx: AgentContext, nextPrompt: string): string;
+}
+export declare class QoderSdkAdapter implements AgentAdapter {
+    private registry;
+    constructor();
+    getMode(): 'headless' | 'qoder-sdk';
+    registerSubagent(name: string, config: SubagentConfig): void;
+    getSubagentConfig(name: string): SubagentConfig | undefined;
+    prepareContext(ctx: AgentContext): Promise<string>;
+    buildActivationPrompt(ctx: AgentContext, nextPrompt: string): string;
+}
+export declare function createAgentAdapter(mode?: 'headless' | 'qoder-sdk'): AgentAdapter;
+export declare const defaultAdapter: HeadlessAdapter;
+//# sourceMappingURL=agent-adapter.d.ts.map

package/dist/core/agent-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../../src/core/agent-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;IACxE,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAGD,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,kBAAkB,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;IAC/E,kBAAkB;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAGD,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7D,wBAAwB;IACxB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5D,yBAAyB;IACzB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,wBAAwB;IACxB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACrE,gBAAgB;IAChB,OAAO,IAAI,UAAU,GAAG,WAAW,CAAC;CACrC;AA0KD,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAA8B;;IAY9C,OAAO,IAAI,UAAU,GAAG,WAAW;IAInC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAK5D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3D,uBAAuB;IACjB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAyJxD,qBAAqB;IACrB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;CAgBrE;AAMD,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAA8B;;IAY9C,OAAO,IAAI,UAAU,GAAG,WAAW;IAInC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAI5D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxD,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;CAMrE;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAkBhF;AAGD,eAAO,MAAM,cAAc,iBAAwB,CAAC"}

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/pipeline-engine.d.ts

@@ -10,14 +10,32 @@
  *   init → phase1-prompt → (AI --apply) → phase1-done
  *     → 检测多端 → phase2-prompt → (AI --apply) → done
  *
- * AI 侧流程:
+ * AI 侧流程 (v8.3.160+ 步骤隔离模式):
  *   1. 收到 Phase 1 prompt → 生成全局文档 → --apply
- *   2. CLI 写入文件 → 自动推进 → 输出 [SPECCORE_PIPELINE_NEXT] + Phase 2 prompt
- *   3. AI 看到标记 → 自动执行下一个命令 → 生成各端文档 → --apply
+ *   2. CLI 写入文件 → 自动推进 → 输出 [SPECCORE_STEP_DONE] + [SPECCORE_NEXT_STEP] + Phase 2 prompt
+ *   3. AI 在新会话中执行提示的命令 → 生成各端文档 → --apply
  *   4. CLI 写入文件 → 标记完成 → Pipeline 结束
  *
  * @since v6.68.0
  */
+export interface ContextSnapshot {
+    /** 核心约束摘要（从 CONSTITUTION.md 提取） */
+    keyConstraints: string[];
+    /** 已完成步骤的产出文件路径 */
+    completedOutputs: string[];
+    /** 技术栈摘要 */
+    techStackSummary?: string;
+    /** 当前任务/迭代 */
+    currentTask?: string;
+    /** 当前迭代 */
+    iteration: string;
+    /** 已完成的步骤 ID 列表 */
+    completedSteps: string[];
+    /** 下一步骤 ID */
+    nextStep?: string;
+    /** 生成时间 */
+    generatedAt: string;
+}
 export interface PipelineState {
     /** 当前步骤 */
     currentStep: string;
@@ -31,11 +49,28 @@ export interface PipelineState {
     name: string;
     /** 端列表（analyze 专用） */
     platforms?: string[];
+    /** v8.3.160+: 上下文快照（步骤隔离模式） */
+    contextSnapshot?: ContextSnapshot;
     /** 创建时间 */
     createdAt: string;
     /** 最后更新时间 */
     updatedAt: string;
 }
+export interface StepResult {
+    nextStepId: string | null;
+    nextStepName: string | null;
+    isComplete: boolean;
+    /** v8.3.160+: 是否需要新会话（步骤隔离模式） */
+    requiresNewSession: boolean;
+    /** v8.3.160+: 上下文快照（供新会话恢复） */
+    contextSnapshot?: ContextSnapshot;
+    /** v8.3.160+: 推荐的 Subagent */
+    subagent?: string;
+    /** v8.3.160+: 上下文 Token 预算 */
+    contextBudget?: number;
+    /** v8.3.160+: 上下文加载类型 */
+    contextType?: 'full' | 'incremental' | 'platform-only' | 'contract-only';
+}
 export interface PipelineStepDef {
     /** 步骤 ID */
     id: string;
@@ -45,6 +80,12 @@ export interface PipelineStepDef {
     next: string | null;
     /** 条件判断：返回 true 才执行此步骤，否则跳到 next */
     condition?: () => Promise<boolean> | boolean;
+    /** v8.3.160+: 该步骤使用的 Subagent 名称 */
+    subagent?: string;
+    /** v8.3.160+: 该步骤的上下文 Token 预算（默认 12000） */
+    contextBudget?: number;
+    /** v8.3.160+: 该步骤需要加载的上下文类型 */
+    contextType?: 'full' | 'incremental' | 'platform-only' | 'contract-only';
 }
 export interface PipelineEngineOptions {
     /** 迭代名称 */
@@ -64,11 +105,11 @@ export declare class PipelineEngine {
     constructor(options: PipelineEngineOptions);
     defineSteps(stepDefs: PipelineStepDef[]): void;
     init(firstStepId: string, extra?: Record<string, any>): Promise<void>;
-    advance(): Promise<{
-        nextStepId: string | null;
-        nextStepName: string | null;
-        isComplete: boolean;
-    }>;
+    advance(): Promise<StepResult>;
+    private buildSnapshot;
+    private saveSnapshot;
+    static loadSnapshot(cwd: string, iteration: string): Promise<ContextSnapshot | null>;
+    updateSnapshotConstraints(constraints: string[]): Promise<void>;
     getCurrentStep(): string | null;
     getCurrentStepDef(): PipelineStepDef | null;
     isActive(): Promise<boolean>;

package/dist/core/pipeline-engine.d.ts.map

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