speccore 6.83.0 → 6.89.0

package/dist/core/rules/defaults/nodejs.md

@@ -0,0 +1,38 @@
+---
+appliesTo:
+  - nodejs
+  - node
+  - nestjs
+  - express
+priority: 80
+---
+
+# Node.js / NestJS 服务端规范
+
+## API 设计
+
+- **RESTful 标准**：使用 HTTP 方法表达语义（GET/POST/PUT/DELETE/PATCH）。
+- **路由规范**：`/api/v{版本}/{模块}/{资源}`，如 `/api/v1/users`。
+- **状态码**：正确使用 HTTP 状态码（200/201/204/400/401/403/404/409/422/500）。
+- **统一响应格式**：
+  ```json
+  { "code": 0, "data": {}, "message": "ok" }
+  ```
+
+## 错误处理
+
+- **全局异常过滤器**：NestJS 使用 `ExceptionFilter`，Express 使用中间件。
+- **业务异常**：自定义 `BusinessException`，必须包含错误码和可读消息。
+- **不暴露内部错误**：生产环境不返回堆栈信息。
+
+## 依赖注入
+
+- **NestJS**：优先使用构造函数注入，避免 `@Inject()` 字符串令牌。
+- **分层架构**：Controller → Service → Repository，禁止跨层调用。
+- **接口隔离**：Service 层面向接口编程，便于测试和替换。
+
+## 数据访问
+
+- **ORM 优先**：使用 TypeORM / Prisma / Sequelize，禁止裸写 SQL（复杂查询除外）。
+- **事务边界**：多表操作必须使用事务，通过装饰器或显式事务管理。
+- **N+1 防护**：使用 `relations` + `select` 或 DataLoader 避免 N+1 查询。

package/dist/core/rules/defaults/react.md

@@ -0,0 +1,34 @@
+---
+appliesTo:
+  - react
+  - reactjs
+priority: 90
+---
+
+# React 组件规范
+
+## 组件设计
+
+- **函数组件优先**：所有新组件使用函数组件 + Hooks。
+- **单一职责**：一个组件只负责一个功能，超过 200 行必须拆分。
+- **Props 接口**：必须定义 `interface Props`，禁止用 `any`。
+- **默认导出**：页面级组件默认导出，业务组件命名导出。
+
+## Hooks 规范
+
+- **自定义 Hooks**：复用逻辑必须抽成自定义 Hook，以 `use` 开头。
+- **依赖数组**：`useEffect`、`useMemo`、`useCallback` 的依赖数组必须完整。
+- **禁止在循环/条件中调用 Hooks**。
+- **清理副作用**：`useEffect` 返回清理函数（订阅、定时器、事件监听）。
+
+## 状态管理
+
+- **局部状态优先**：能用 `useState` 就不用全局状态。
+- **全局状态**：使用 Context + useReducer 或 Redux/Zustand，禁止 prop drilling 超过 3 层。
+- **表单状态**：复杂表单使用 React Hook Form 或 Formik。
+
+## 性能
+
+- **.memo 使用**：仅对纯展示组件且接收复杂 props 时使用。
+- **懒加载**：路由级组件使用 `React.lazy()` + `Suspense`。
+- **避免内联对象/函数**：作为 props 传递时会导致不必要的重渲染。

package/dist/core/rules/defaults/security.md

@@ -0,0 +1,31 @@
+---
+appliesTo:
+  - security
+priority: 100
+---
+
+# 安全编码规范
+
+## 输入验证
+
+- **不信任任何输入**：所有用户输入必须校验（长度、类型、范围、格式）。
+- **白名单校验**：优先使用允许列表（白名单），而非禁止列表（黑名单）。
+- **参数化查询**：数据库查询必须使用参数化/预处理语句，禁止字符串拼接 SQL。
+
+## 认证与授权
+
+- **最小权限原则**：每个接口明确所需权限，默认拒绝。
+- **敏感操作二次确认**：资金操作、数据删除等需要额外验证（如短信/密码）。
+- **Token 安全**：JWT 设置合理过期时间（Access Token 15min，Refresh Token 7d），使用 HTTPS 传输。
+
+## 数据保护
+
+- **敏感数据加密**：密码使用 bcrypt/argon2，身份证号/银行卡号使用 AES-256 加密存储。
+- **日志脱敏**：日志中不出现明文密码、Token、身份证号。
+- **防泄漏**：错误响应不暴露堆栈、数据库结构、内部路径。
+
+## 常见漏洞防护
+
+- **XSS**：输出到 DOM 前转义，使用框架内置的 XSS 防护（React/Vue 自动转义）。
+- **CSRF**：状态变更操作使用 CSRF Token 或 SameSite Cookie。
+- **文件上传**：限制文件类型（白名单）、大小、存储路径（禁止执行权限）。

package/dist/core/rules/defaults/testing.md

@@ -0,0 +1,35 @@
+---
+appliesTo:
+  - test
+  - jest
+  - vitest
+  - testing
+priority: 60
+---
+
+# 测试规范
+
+## 测试策略
+
+- **测试金字塔**：单元测试（70%）→ 集成测试（20%）→ E2E 测试（10%）。
+- **覆盖目标**：核心业务逻辑覆盖率 ≥ 80%，分支覆盖率 ≥ 70%。
+- **测试文件名**：`{module}.test.ts` 或 `{module}.spec.ts`，与源码同目录或 `__tests__/` 下。
+
+## 单元测试
+
+- **独立性**：每个测试用例独立，不依赖执行顺序。
+- **Arrange-Act-Assert**：三段式结构清晰。
+- **Mock 外部依赖**：HTTP 请求、数据库、文件系统必须 Mock。
+- **命名规范**：`should {预期行为} when {条件}`，如 `should return 401 when token is expired`。
+
+## 集成测试
+
+- **真实依赖**：使用测试数据库（如 SQLite 内存 / TestContainers）。
+- **环境隔离**：每个测试套件前清理数据，后回滚事务。
+- **API 契约**：验证请求/响应格式符合 OpenAPI 定义。
+
+## 禁止
+
+- 不在测试中写逻辑（如 if/for），只调用和断言。
+- 不测试第三方库（如测试 `lodash` 的 `debounce`）。
+- 不提交 `.only`、`.skip` 到主分支。

package/dist/core/rules/defaults/typescript.md

@@ -0,0 +1,36 @@
+---
+appliesTo:
+  - typescript
+  - ts
+priority: 100
+---
+
+# TypeScript 编码规范
+
+## 类型安全
+
+- **禁止 `any`**：除非与第三方库交互，否则不使用 `any`。使用 `unknown` + 类型守卫替代。
+- **禁止 `@ts-ignore`**：必须使用 `@ts-expect-error` 并附注释说明原因。
+- **严格模式**：项目必须开启 `strict: true`。
+- **显式返回类型**：公共 API 函数必须声明返回类型。
+
+## 命名规范
+
+- 类型/接口：`PascalCase`（如 `UserProfile`）
+- 变量/函数：`camelCase`（如 `getUserName`）
+- 常量：`UPPER_SNAKE_CASE`（如 `MAX_RETRY_COUNT`）
+- 枚举：`PascalCase`，成员 `UPPER_SNAKE_CASE`
+- 布尔变量：使用 `is`、`has`、`should` 前缀（如 `isLoading`）
+
+## 模块组织
+
+- 一个文件一个核心导出（类/函数/组件）
+- 工具函数按领域分组（`utils/validation.ts`、`utils/date.ts`）
+-  barrel export 使用 `index.ts` 统一暴露模块公共 API
+- 禁止循环依赖
+
+## 异步规范
+
+- 优先使用 `async/await`，避免回调地狱
+- Promise 链必须有 `.catch()` 或 `try/catch`
+- 并行请求使用 `Promise.all()`，但注意错误处理

package/dist/core/skill-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SKILLS 可复用技能库加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/SKILLS/ 目录下的技能定义文件
+ * 2. 根据任务类型/关键词匹配对应的技能
+ * 3. 注入到代码生成 prompt 中
+ *
+ * v6.88.0+
+ */
+export interface SkillDefinition {
+    name: string;
+    content: string;
+    tags: string[];
+}
+/**
+ * 根据任务关键词匹配适用的技能
+ */
+export declare function resolveSkillsForTask(taskKeywords: string[], projectRoot: string): Promise<SkillDefinition[]>;
+/**
+ * 将匹配的技能合并为 prompt 字符串
+ */
+export declare function formatSkillsPrompt(skills: SkillDefinition[]): string;
+export declare function getBuiltinSkillContents(): Promise<{
+    name: string;
+    content: string;
+}[]>;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/core/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/core/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA0DD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAqBpE;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAE5F"}

package/dist/core/skill-loader.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * SKILLS 可复用技能库加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/SKILLS/ 目录下的技能定义文件
+ * 2. 根据任务类型/关键词匹配对应的技能
+ * 3. 注入到代码生成 prompt 中
+ *
+ * v6.88.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillsForTask = resolveSkillsForTask;
+exports.formatSkillsPrompt = formatSkillsPrompt;
+exports.getBuiltinSkillContents = getBuiltinSkillContents;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_SKILLS_DIR = (0, path_1.join)(__dirname, 'skills', 'defaults');
+async function scanSkillFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const skills = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue;
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        skills.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+        });
+    }
+    return skills;
+}
+function parseSkillMeta(content) {
+    const tags = [];
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (frontmatterMatch) {
+        const fm = frontmatterMatch[1];
+        const tagsMatch = fm.match(/tags:\s*\n((\s+-\s+.+\n)+)/);
+        if (tagsMatch) {
+            for (const line of tagsMatch[1].matchAll(/-\s+(.+)/g)) {
+                tags.push(line[1].trim().toLowerCase());
+            }
+        }
+    }
+    return { tags };
+}
+async function loadAllSkills(projectRoot) {
+    const userSkillsDir = (0, path_1.join)(projectRoot, '.speccore', 'SKILLS');
+    const skillMap = new Map();
+    const builtinFiles = await scanSkillFiles(BUILTIN_SKILLS_DIR);
+    for (const f of builtinFiles) {
+        const meta = parseSkillMeta(f.content);
+        skillMap.set(f.name, { name: f.name, content: f.content, tags: meta.tags });
+    }
+    const userFiles = await scanSkillFiles(userSkillsDir);
+    for (const f of userFiles) {
+        const meta = parseSkillMeta(f.content);
+        skillMap.set(f.name, { name: f.name, content: f.content, tags: meta.tags });
+    }
+    return Array.from(skillMap.values());
+}
+/**
+ * 根据任务关键词匹配适用的技能
+ */
+async function resolveSkillsForTask(taskKeywords, projectRoot) {
+    const allSkills = await loadAllSkills(projectRoot);
+    const keywords = taskKeywords.map(s => s.toLowerCase());
+    const matched = allSkills.filter(skill => {
+        return skill.tags.some(tag => keywords.some(kw => kw.includes(tag) || tag.includes(kw)));
+    });
+    return matched;
+}
+/**
+ * 将匹配的技能合并为 prompt 字符串
+ */
+function formatSkillsPrompt(skills) {
+    if (skills.length === 0)
+        return '';
+    const sections = [];
+    sections.push('## 可复用技能参考');
+    sections.push('');
+    sections.push('> 以下技能指南供参考，按需应用。');
+    sections.push('');
+    for (const skill of skills) {
+        let content = skill.content;
+        content = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+        content = content.trim();
+        sections.push(`### ${skill.name}`);
+        sections.push('');
+        sections.push(content);
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+async function getBuiltinSkillContents() {
+    return scanSkillFiles(BUILTIN_SKILLS_DIR);
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/core/skill-loader.js.map

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

package/dist/core/skills/defaults/caching.md

@@ -0,0 +1,33 @@
+---
+tags:
+  - cache
+  - redis
+  - performance
+  - memoization
+---
+
+# 缓存技能
+
+## 缓存策略
+
+| 策略 | 适用场景 | 缺点 |
+|------|---------|------|
+| Cache-Aside | 读多写少 | 首次读取慢 |
+| Write-Through | 强一致性要求 | 写延迟增加 |
+| Write-Behind | 高写入吞吐量 | 数据丢失风险 |
+| Read-Through | 简化应用逻辑 | 缓存 miss 时延迟高 |
+
+## Redis 最佳实践
+
+1. **Key 命名空间**：`service:entity:id:field`，如 `user:profile:1234:email`
+2. **TTL 设置**：根据数据变化频率设置合理过期时间
+3. **序列化**：使用 JSON 或 MessagePack，避免存储对象引用
+4. **连接池**：使用连接池管理 Redis 连接
+5. **缓存穿透**：对不存在 key 设置空值缓存（短 TTL）
+6. **缓存雪崩**：设置随机 TTL 偏移量
+
+## 本地缓存
+
+- Node.js：使用 `lru-cache` 或 `node-cache`
+- 前端：使用 `React.memo`、`useMemo`、`useCallback`
+- 限制：本地缓存仅存放热点数据，大小不超过 100MB

package/dist/core/skills/defaults/db-migration.md

@@ -0,0 +1,46 @@
+---
+tags:
+  - database
+  - migration
+  - schema
+  - typeorm
+  - prisma
+---
+
+# 数据库迁移技能
+
+## 迁移原则
+
+1. **向后兼容**：先加字段/表，后删字段/表，中间版本兼容
+2. **可回滚**：每个迁移必须有 `up()` 和 `down()`
+3. **数据安全**：生产环境迁移先备份
+4. **分批执行**：大数据量迁移分批处理，避免锁表
+
+## 迁移示例（TypeORM）
+
+```typescript
+export class AddUserProfile1672531200000 implements MigrationInterface {
+  name = 'AddUserProfile1672531200000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.addColumn('users', new TableColumn({
+      name: 'avatar',
+      type: 'varchar',
+      length: '500',
+      isNullable: true,
+    }));
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.dropColumn('users', 'avatar');
+  }
+}
+```
+
+## 零停机迁移策略
+
+1. **加字段**：ALTER TABLE ADD COLUMN（ nullable ）
+2. **双写**：应用同时读写新旧字段
+3. **回填**：批量回填历史数据
+4. **切换**：应用切换到新字段
+5. **删字段**：ALTER TABLE DROP COLUMN（下一个版本）

package/dist/core/skills/defaults/deployment.md

@@ -0,0 +1,50 @@
+---
+tags:
+  - deploy
+  - deployment
+  - ci-cd
+  - vercel
+  - aws
+  - docker
+---
+
+# 部署技能
+
+## 通用原则
+
+1. **蓝绿部署**：生产环境使用蓝绿部署，零停机切换
+2. **回滚策略**：每个版本保留回滚能力（保留最近 3 个版本）
+3. **健康检查**：部署后自动执行健康检查，失败自动回滚
+4. **灰度发布**：新功能先灰度 5% → 20% → 50% → 100%
+
+## Docker 部署
+
+```dockerfile
+# 多阶段构建
+FROM node:18-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:18-alpine
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY package.json ./
+EXPOSE 3000
+CMD ["node", "dist/main.js"]
+```
+
+## CI/CD 流水线
+
+```yaml
+# 标准流水线
+stages:
+  - lint
+  - test
+  - build
+  - deploy-staging
+  - deploy-production
+```

package/dist/core/skills/defaults/logging.md

@@ -0,0 +1,38 @@
+---
+tags:
+  - log
+  - logging
+  - monitoring
+  - observability
+---
+
+# 日志技能
+
+## 结构化日志
+
+所有日志必须使用结构化格式（JSON），包含以下字段：
+
+```json
+{
+  "timestamp": "2024-01-01T00:00:00.000Z",
+  "level": "info|warn|error|debug",
+  "service": "user-service",
+  "traceId": "uuid",
+  "message": "用户登录成功",
+  "context": { "userId": "123", "ip": "1.2.3.4" },
+  "duration": 45
+}
+```
+
+## 日志级别使用规范
+
+- **ERROR**：系统异常、业务失败（需要立即处理）
+- **WARN**：潜在问题、降级处理（需要关注）
+- **INFO**：关键业务流程节点（正常记录）
+- **DEBUG**：详细调试信息（仅开发环境）
+
+## 禁止
+
+- 不记录密码、Token、身份证号等敏感信息
+- 不在循环中大量打印日志
+- 不记录二进制数据或大对象

package/dist/core/verify-engine.d.ts

@@ -47,11 +47,16 @@ export declare function generateFixPrompt(report: VerifyReport, taskDir: string)
  * 生成 SPECCORE_EXEC 标签，触发 AI 修复
  */
 export declare function outputFixTag(report: VerifyReport, taskDir: string, round: number): void;
+export interface AgentQualityCheck {
+    agent: string;
+    prompt: string;
+}
 export interface QualityGateResult {
     passed: boolean;
     blockingFailed: CheckResult[];
     warnings: CheckResult[];
     report: VerifyReport;
+    agentChecks?: AgentQualityCheck[];
 }
 /**
  * 质量门禁 — execute 后自动运行，不可跳过
@@ -60,6 +65,8 @@ export interface QualityGateResult {
  */
 export declare function runQualityGate(taskId: string, codePath: string, taskDir: string, options?: {
     timeout?: number;
+    withAgents?: boolean;
+    projectRoot?: string;
 }): Promise<QualityGateResult>;
 /**
  * 根据单元测试结果同步更新 TEST.md 勾选状态

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

@@ -1 +1 @@
-{"version":3,"file":"verify-engine.d.ts","sourceRoot":"","sources":["../../src/core/verify-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAMD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAO9E;AAyID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0DnE;AAMD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,YAAY,CAAC,CAmEvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgD/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQvF;AAsYD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA2F5B;AAMD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"verify-engine.d.ts","sourceRoot":"","sources":["../../src/core/verify-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAMD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAO9E;AAyID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0DnE;AAMD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,YAAY,CAAC,CAmEvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgD/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQvF;AAsYD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,iBAAiB,CAAC,CAmH5B;AAMD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/core/verify-engine.js

@@ -19,6 +19,8 @@ const child_process_1 = require("child_process");
 const path_1 = require("path");
 const fs_extra_1 = require("fs-extra");
 const logger_1 = require("../utils/logger");
+// v6.84.0+: AGENTS 引擎集成
+const agents_1 = require("./agents");
 // ============================================================
 // 项目类型检测
 // ============================================================
@@ -818,6 +820,30 @@ async function runQualityGate(taskId, codePath, taskDir, options) {
         const block = c.blocking ? ' 🔒' : '';
         logger_1.logger.info(`   ${icon} ${c.name}${block}: ${c.details}`);
     }
+    // v6.84.0+: AGENTS 扩展检查（可选）
+    let agentChecks;
+    if (options?.withAgents && options?.projectRoot) {
+        try {
+            const agentContext = {
+                iteration: taskId.split('/')[0],
+                taskDir,
+                codePath,
+            };
+            const agents = await (0, agents_1.resolveAgentsForPhase)('execute', 'quality-gate', agentContext, options.projectRoot);
+            if (agents.length > 0) {
+                agentChecks = [];
+                logger_1.logger.info(`   🤖 AGENTS 扩展检查 (${agents.length} 个角色)...`);
+                for (const ra of agents) {
+                    const prompt = (0, agents_1.buildAgentPrompt)(ra.definition, agentContext);
+                    agentChecks.push({ agent: ra.name, prompt });
+                    logger_1.logger.info(`      - ${ra.name} (优先级: ${ra.priority})`);
+                }
+            }
+        }
+        catch {
+            // AGENTS 扩展检查失败不影响主流程
+        }
+    }
     const passed = blockingFailed.length === 0;
     if (passed) {
         logger_1.logger.info(`   ✅ 编译通过，质量门禁放行`);
@@ -829,7 +855,7 @@ async function runQualityGate(taskId, codePath, taskDir, options) {
         logger_1.logger.warn(`   ❌ 编译失败，质量门禁拦截`);
         logger_1.logger.info(`   💡 修复编译错误后自动重新检查`);
     }
-    return { passed, blockingFailed, warnings, report };
+    return { passed, blockingFailed, warnings, report, agentChecks };
 }
 // ============================================================
 // v6.79.0+: 文档同步 — 根据实际测试结果更新 TEST.md