@boyingliu01/xp-gate 0.19.2 → 0.20.0

package/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-09-22
-**Commit:** 3d1d1bf
-**Branch:** main
-**Version:** 0.19.2.0
+**Generated:** 2026-10-07
+**Commit:** ff55f35b
+**Branch:** fix/batch-defects-20261007
+**Version:** 0.20.0.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/skills/sprint-flow/references/phase-2-design.md

@@ -89,9 +89,9 @@ grill 访谈达成共享理解后（或 CONTEXT.md 快速路径下读取已有
   "head_commit": "<git rev-parse HEAD>",
   "consensus_ratio": 1.0,
   "expert_verdicts": [
-    { "role": "architecture", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-a" },
-    { "role": "technical", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-b" },
-    { "role": "feasibility", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-c" }
+    { "role": "architecture", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-a", "resolved_model": "provider/model-a", "channel": "external" },
+    { "role": "technical", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-b", "resolved_model": "provider/model-b", "channel": "external" },
+    { "role": "feasibility", "verdict": "APPROVED", "result_type": "delphi_expert_result", "requested_model": "provider/model-c", "resolved_model": "provider/model-c", "channel": "external" }
   ],
   "rounds": 1,
   "gaps": []

package/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-09-22
-**Commit:** 3d1d1bf
-**Branch:** main
-**Version:** 0.19.2.0
+**Generated:** 2026-10-07
+**Commit:** ff55f35b
+**Branch:** fix/batch-defects-20261007
+**Version:** 0.20.0.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/lib/__tests__/download-skill.test.js

@@ -1,281 +0,0 @@
-/**
- * @test download-skill
- * @intent Verify downloadFromGitHub/downloadTarball/downloadWithRetry/downloadFile/verifyChecksum behaviors
- */
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const https = require('https');
-const crypto = require('crypto');
-const { EventEmitter } = require('events');
-const { Writable } = require('stream');
-
-/**
- * Mock https.get with controllable behavior.
- * opts (or array of opts for sequential calls):
- *   - statusCode (default 200)
- *   - body (default 'data')
- *   - errorAfter (boolean) — emit 'error' on the request instead of responding
- *   - redirectTo (string url) — sends 302 with location header
- */
-function mockHttpsGet(optsOrList) {
-  const list = Array.isArray(optsOrList) ? [...optsOrList] : [optsOrList];
-  // Synchronous fake createWriteStream — the real one opens the FD asynchronously
-  // and races against downloadFile's unlinkSync(dest) in 301/302/error branches,
-  // causing ENOENT unhandled errors. The fake writes via writeFileSync (sync,
-  // file present immediately) and emits 'finish' on end().
-  vi.spyOn(fs, 'createWriteStream').mockImplementation((dest) => {
-    let buf = '';
-    try {
-      fs.writeFileSync(dest, '');
-    } catch {
-      /* dest dir may not exist; downstream code will surface that */
-    }
-    const stream = new EventEmitter();
-    stream.write = (chunk) => {
-      buf += chunk;
-      return true;
-    };
-    stream.end = () => {
-      try {
-        fs.writeFileSync(dest, buf);
-      } catch {
-        /* file may have been unlinked by source; safe to ignore */
-      }
-      process.nextTick(() => stream.emit('finish'));
-    };
-    stream.close = () => {};
-    return stream;
-  });
-
-  vi.spyOn(https, 'get').mockImplementation((url, options, cb) => {
-    const callback = typeof options === 'function' ? options : cb;
-    const req = new EventEmitter();
-    const config = list.shift() || { statusCode: 200, body: 'data' };
-    process.nextTick(() => {
-      if (config.errorAfter) {
-        req.emit('error', new Error('Network error'));
-        return;
-      }
-      const response = new EventEmitter();
-      response.statusCode = config.statusCode != null ? config.statusCode : 200;
-      response.headers = config.redirectTo ? { location: config.redirectTo } : {};
-      response.pipe = (file) => {
-        file.write(config.body != null ? config.body : 'data');
-        file.end();
-      };
-      callback(response);
-    });
-    return req;
-  });
-}
-
-describe('download-skill', () => {
-  let tmpHome, originalHome;
-
-  beforeEach(() => {
-    originalHome = process.env.HOME;
-    tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'xpgate-dl-'));
-    process.env.HOME = tmpHome;
-    vi.resetModules();
-    delete require.cache[require.resolve('../download-skill')];
-    vi.spyOn(console, 'log').mockImplementation(() => {});
-    vi.spyOn(console, 'error').mockImplementation(() => {});
-    vi.spyOn(console, 'warn').mockImplementation(() => {});
-  });
-
-  afterEach(async () => {
-    vi.useRealTimers();
-    await new Promise((resolve) => setImmediate(resolve));
-    process.env.HOME = originalHome;
-    vi.restoreAllMocks();
-    if (fs.existsSync(tmpHome)) {
-      fs.rmSync(tmpHome, { recursive: true, force: true });
-    }
-  });
-
-  function cacheDir() {
-    return path.join(tmpHome, '.config', 'xp-gate', 'cache');
-  }
-
-  describe('downloadFromGitHub', () => {
-    // Flat repo name avoids '/' becoming a subdir in cacheFile (source only mkdirs CACHE_DIR root).
-    it('downloads file to cache dir and returns the path', async () => {
-      mockHttpsGet({ statusCode: 200, body: '# Skill content' });
-      const { downloadFromGitHub } = require('../download-skill');
-
-      const result = await downloadFromGitHub('flatrepo', 'skills/foo/SKILL.md');
-
-      expect(result).toBe(
-        path.join(cacheDir(), 'flatrepo-skills-foo-SKILL.md.md')
-      );
-      expect(fs.existsSync(result)).toBe(true);
-      expect(fs.readFileSync(result, 'utf8')).toBe('# Skill content');
-    });
-
-    it('creates cache directory if missing', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'data' });
-      const { downloadFromGitHub } = require('../download-skill');
-
-      expect(fs.existsSync(cacheDir())).toBe(false);
-      await downloadFromGitHub('flatrepo', 'a/b');
-      expect(fs.existsSync(cacheDir())).toBe(true);
-    });
-
-    it('uses default version=main when not specified', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'data' });
-      const { downloadFromGitHub } = require('../download-skill');
-      await downloadFromGitHub('flatrepo', 'path/to/file');
-      expect(https.get).toHaveBeenCalled();
-      const calledUrl = https.get.mock.calls[0][0];
-      expect(calledUrl).toContain('/main/');
-    });
-
-    it('uses custom version when specified', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'data' });
-      const { downloadFromGitHub } = require('../download-skill');
-      await downloadFromGitHub('flatrepo', 'path/file', 'v1.2.3');
-      expect(https.get.mock.calls[0][0]).toContain('/v1.2.3/');
-    });
-  });
-
-  describe('downloadTarball', () => {
-    it('downloads tarball with correct filename', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'tarball-bytes' });
-      const { downloadTarball } = require('../download-skill');
-
-      const result = await downloadTarball('boyingliu01/xp-gate');
-
-      expect(result).toBe(path.join(cacheDir(), 'boyingliu01-xp-gate.tgz'));
-      expect(fs.existsSync(result)).toBe(true);
-    });
-
-    it('uses default main version', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'data' });
-      const { downloadTarball } = require('../download-skill');
-      await downloadTarball('user/repo');
-      expect(https.get.mock.calls[0][0]).toContain('/tarball/main');
-    });
-  });
-
-  describe('downloadWithRetry', () => {
-    it('succeeds on first try when no errors', async () => {
-      mockHttpsGet({ statusCode: 200, body: 'ok' });
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'out.txt');
-      await downloadWithRetry('https://example.com/x', dest, 3);
-
-      expect(https.get).toHaveBeenCalledTimes(1);
-      expect(fs.readFileSync(dest, 'utf8')).toBe('ok');
-    });
-
-    it('retries and eventually succeeds (sleep delays stubbed)', async () => {
-      // Stub setTimeout so sleep() resolves immediately, without patching setImmediate.
-      vi.spyOn(global, 'setTimeout').mockImplementation((fn) => {
-        Promise.resolve().then(fn);
-        return 0;
-      });
-      mockHttpsGet([
-        { errorAfter: true },
-        { statusCode: 200, body: 'recovered' },
-      ]);
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'retry.txt');
-      await downloadWithRetry('https://example.com/x', dest, 3);
-
-      expect(fs.readFileSync(dest, 'utf8')).toBe('recovered');
-    });
-
-    it('throws original error after exhausting retries', async () => {
-      vi.spyOn(global, 'setTimeout').mockImplementation((fn) => {
-        Promise.resolve().then(fn);
-        return 0;
-      });
-      mockHttpsGet([
-        { errorAfter: true },
-        { errorAfter: true },
-      ]);
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'fail.txt');
-      await expect(
-        downloadWithRetry('https://example.com/x', dest, 2)
-      ).rejects.toThrow('Network error');
-    });
-  });
-
-  describe('downloadFile (via downloadWithRetry retries=1)', () => {
-    it('follows 302 redirect to new location', async () => {
-      mockHttpsGet([
-        { statusCode: 302, redirectTo: 'https://newlocation.example.com/final' },
-        { statusCode: 200, body: 'redirected-content' },
-      ]);
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'redirect.txt');
-      await downloadWithRetry('https://example.com/orig', dest, 1);
-
-      expect(fs.readFileSync(dest, 'utf8')).toBe('redirected-content');
-    });
-
-    it('follows 301 redirect', async () => {
-      mockHttpsGet([
-        { statusCode: 301, redirectTo: 'https://newloc.example/final' },
-        { statusCode: 200, body: 'permanent-redirect' },
-      ]);
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'r301.txt');
-      await downloadWithRetry('https://example.com/orig', dest, 1);
-
-      expect(fs.readFileSync(dest, 'utf8')).toBe('permanent-redirect');
-    });
-
-    it('rejects with HTTP error for non-2xx/3xx status', async () => {
-      mockHttpsGet({ statusCode: 404 });
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, '404.txt');
-      await expect(downloadWithRetry('https://example.com/x', dest, 1)).rejects.toThrow(
-        'HTTP 404'
-      );
-    });
-
-    it('rejects and unlinks dest on request error', async () => {
-      mockHttpsGet({ errorAfter: true });
-      const { downloadWithRetry } = require('../download-skill');
-
-      const dest = path.join(tmpHome, 'err.txt');
-      await expect(downloadWithRetry('https://example.com/x', dest, 1)).rejects.toThrow(
-        'Network error'
-      );
-      // The createWriteStream call will create the file, the error handler should unlink it
-      expect(fs.existsSync(dest)).toBe(false);
-    });
-  });
-
-  describe('verifyChecksum', () => {
-    it('does not throw when checksum matches', () => {
-      const file = path.join(tmpHome, 'data.txt');
-      const content = 'hello world';
-      fs.writeFileSync(file, content);
-      const expected = crypto.createHash('sha256').update(content).digest('hex');
-
-      const { verifyChecksum } = require('../download-skill');
-      expect(() => verifyChecksum(file, expected)).not.toThrow();
-      // File preserved
-      expect(fs.existsSync(file)).toBe(true);
-    });
-
-    it('throws and deletes file on mismatch', () => {
-      const file = path.join(tmpHome, 'bad.txt');
-      fs.writeFileSync(file, 'real-content');
-
-      const { verifyChecksum } = require('../download-skill');
-      expect(() => verifyChecksum(file, 'wrong-hash-zzz')).toThrow(/Checksum mismatch/);
-      expect(fs.existsSync(file)).toBe(false);
-    });
-  });
-});

package/lib/download-skill.js

@@ -1,96 +0,0 @@
-const https = require('https');
-const http = require('http');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const crypto = require('crypto');
-
-// Cross-platform home directory resolution
-const HOME = process.env.HOME || process.env.USERPROFILE || os.homedir();
-
-const CONFIG_DIR = path.join(HOME, '.config', 'xp-gate');
-const CACHE_DIR = path.join(CONFIG_DIR, 'cache');
-
-async function downloadFromGitHub(repo, pathInRepo, version = 'main') {
-  const url = `https://raw.githubusercontent.com/${repo}/${version}/${pathInRepo}`;
-  const cacheFile = path.join(CACHE_DIR, `${repo}-${pathInRepo.replace(/\//g, '-')}.md`);
-  
-  fs.mkdirSync(CACHE_DIR, { recursive: true });
-  
-  await downloadWithRetry(url, cacheFile);
-  
-  return cacheFile;
-}
-
-async function downloadWithRetry(url, dest, retries = 3) {
-  for (let attempt = 1; attempt <= retries; attempt++) {
-    try {
-      await downloadFile(url, dest);
-      return;
-    } catch (err) {
-      if (attempt === retries) throw err;
-      console.log(`Retry ${attempt}/${retries}...`);
-      await sleep(1000 * attempt);
-    }
-  }
-}
-
-async function downloadFile(url, dest) {
-  return new Promise((resolve, reject) => {
-    const file = fs.createWriteStream(dest);
-    
-    https.get(url, { timeout: 30000 }, (response) => {
-      if (response.statusCode === 301 || response.statusCode === 302) {
-        file.close();
-        fs.unlinkSync(dest);
-        downloadFile(response.headers.location, dest).then(resolve).catch(reject);
-        return;
-      }
-      
-      if (response.statusCode !== 200) {
-        file.close();
-        reject(new Error(`HTTP ${response.statusCode}`));
-        return;
-      }
-      
-      response.pipe(file);
-      file.on('finish', () => {
-        file.close();
-        resolve();
-      });
-    }).on('error', (err) => {
-      file.close();
-      if (fs.existsSync(dest)) fs.unlinkSync(dest);
-      reject(err);
-    });
-  });
-}
-
-async function downloadTarball(repo, version = 'main') {
-  const tarballUrl = `https://api.github.com/repos/${repo}/tarball/${version}`;
-  const cacheFile = path.join(CACHE_DIR, `${repo.replace('/', '-')}.tgz`);
-  
-  fs.mkdirSync(CACHE_DIR, { recursive: true });
-  
-  await downloadWithRetry(tarballUrl, cacheFile);
-  
-  return cacheFile;
-}
-
-function sleep(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-function verifyChecksum(file, expectedChecksum) {
-  const hash = crypto.createHash('sha256');
-  const content = fs.readFileSync(file);
-  hash.update(content);
-  const actualChecksum = hash.digest('hex');
-  
-  if (actualChecksum !== expectedChecksum) {
-    fs.unlinkSync(file);
-    throw new Error(`Checksum mismatch: expected ${expectedChecksum}, got ${actualChecksum}`);
-  }
-}
-
-module.exports = { downloadFromGitHub, downloadTarball, downloadWithRetry, verifyChecksum };

package/plugins/qoder/skills/ralph-loop/references/components/memory.md

@@ -1,55 +0,0 @@
-# memory.md — Ralph Loop 状态与记忆结构（AHE 组件分解）
-
-> **本文是 `skills/ralph-loop/SKILL.md` 中状态管理的 AHE 对齐展开。**
-
-## 组件职责
-
-定义 Ralph Loop 的进度持久化 Schema、learnings 分类结构。
-
-## Progress Log Schema (`progress.log` — YAML)
-
-```yaml
-req_progress:
-  completed_count: 3
-  total_count: 5
-  current_req: REQ-XXX-004
-  status: running|completed|blocked
-  test_infra_status: generated|existing|skipped|fallback
-
-learnings:
-  permanent:
-    - pattern: "描述持久模式"
-      evidence: "来源证据"
-  contextual:
-    - pattern: "描述当前 REQ 有效模式"
-      expires_on: "过期条件"
-
-cost:
-  req_number: 3
-  tokens_used: 15000
-  cumulative_tokens: 85000
-  threshold: 200000
-```
-
-## Test Infra Status 字段
-
-| 值 | 含义 |
-|---|------|
-| `generated` | 本 REQ 首次生成 test-utils.ts |
-| `existing` | test-utils.ts 已存在且接口完整 |
-| `skipped` | 非首次 REQ，跳过 test-infra 检查（缓存结果）|
-| `fallback` | test-infra dispatch 失败，使用 inline 生成（含 warning）|
-
-## Learnings 分类
-
-| 类型 | 生命周期 | 持久化 | 示例 |
-|------|---------|--------|------|
-| `permanent` | 跨所有 REQ | progress.log | "项目使用 ESLint strict 模式" |
-| `contextual` | 当前 REQ 内 | progress.log (过期标记) | "REQ 003 使用 Zod 验证 schema" |
-
-## AHE 分类
-
-| 字段 | 值 |
-|------|---|
-| 组件类型 | Long-Term Memory |
-| 修改频率预期 | 低 |

package/plugins/qoder/skills/ralph-loop/references/components/middleware.md

@@ -1,54 +0,0 @@
-# middleware.md — Ralph Loop 迭代控制逻辑（AHE 组件分解）
-
-> **本文是 `skills/ralph-loop/SKILL.md` 中迭代流程的 AHE 对齐展开。**
-
-## 组件职责
-
-定义 Ralph Loop 的状态机：REQ 级迭代控制、熔断机制、中断续传逻辑。
-
-## 状态机
-
-```
-REQ N → 加载 learnings → 测试基础设施检查 → [infra missing?] → test_infra_dispatch
-     │                              │                             │
-     │                              │ infra ready                 │ FAIL (max 2 retry)
-     │                              ▼                             ▼
-     │                         TDD → 回归测试 ←───────────── BLOCK/fallback
-     │                              │
-     │ PASS → REQ N+1
-     │ FAIL → 重试 (max 3) → BLOCK → 用户决策
-     │ ALL_REQS_COMPLETE → 结束，返回控制权给 sprint-flow orchestrator
-```
-
-## 测试基础设施状态机
-
-```
-test_infra_check → [needs infra?] → test_infra_dispatch → FAIL → retry (max 2)
-        │               │                        │                      │
-        │               │ infra ready            │ pass                 │ pass
-        ▼               ▼                        ▼                      ▼
-     in_progress   test_infra_ready ─────────→ TDD → regression     BLOCK/fallback
-```
-
-## 熔断机制
-
-| 触发条件 | 动作 |
-|---------|------|
-| TDD 失败 > 3 次 | BLOCK + 用户决策 |
-| Token 使用超阈值 | BLOCK + 用户决策 |
-| 回归测试失败 | 记录到 progress.log，通知 sprint-flow orchestrator |
-| test-infra dispatch 失败 (max 2 retry) | BLOCK 或 fallback inline 生成（记录 warning）|
-
-## 暂停点
-
-| 暂停点 | 触发条件 | 恢复 |
-|--------|---------|------|
-| REQ 完成 | 自动暂停等待确认 | 确认后继续下一个 REQ |
-| 熔断 | 自动触发 | 用户决策后继续或放弃 |
-
-## AHE 分类
-
-| 字段 | 值 |
-|------|---|
-| 组件类型 | Middleware |
-| 修改频率预期 | 高 |

package/plugins/qoder/skills/ralph-loop/references/components/skill-invocations.md

@@ -1,39 +0,0 @@
-# skill-invocations.md — Ralph Loop 技能调用（AHE 组件分解）
-
-> **本文是 `skills/ralph-loop/SKILL.md` 中技能调用链的 AHE 对齐展开。**
-
-## 组件职责
-
-提供 Ralph Loop 在每个 REQ 执行中的技能调用链。
-
-## 完整调用链
-
-| 步骤 | Skill | 来源 | 参数 |
-|------|-------|------|------|
-| 0 | 测试基础设施检查 | 内置 | 检查 test-utils.ts 存在性 + 接口契约（createTestApp, withTestDb）|
-| 1 | `test-driven-development` | superpowers | `--lang` 注入 + TDD 铁律 + Mock 边界（覆盖默认策略）|
-| 2 | `learn` | gstack | classification: permanent/contextual |
-| 3 | `requesting-code-review` | superpowers | REQ 完成后评审 |
-
-## test-infra dispatch 节点
-
-当 test-utils.ts 不存在或接口缺失时：
-
-```
-task(category="unspecified-high", load_skills=["test-driven-development"], prompt="生成测试基础设施：createTestApp() + withTestDb()。TDD 铁律：先写测试再实现。")
-```
-
-- retry max 2 次
-- 仍失败 → BLOCK 或 fallback inline 生成（记录 warning）
-- 成功后与业务代码合并为同一 commit
-
-## 上游依赖
-
-从 `specification.yaml` 获取 REQ 列表（由 `to-issues` skill 生成）
-
-## AHE 分类
-
-| 字段 | 值 |
-|------|---|
-| 组件类型 | Skill Invocation Chain |
-| 修改频率预期 | 中 |

package/plugins/qoder/skills/ralph-loop/references/components/system-prompt.md

@@ -1,24 +0,0 @@
-# system-prompt.md — Ralph Loop 行为定义（AHE 组件分解）
-
-> **本文是 `skills/ralph-loop/SKILL.md` 核心原则的 AHE 对齐展开。**
-
-## 核心职责
-
-定义 Ralph Loop (Phase 2 BUILD 默认模式) 的行为边界：逐 REQ/切片 迭代构建，每个 REQ dispatch 独立 subagent，干净上下文，全量回归测试。
-
-## 核心原则 (AHE 对齐)
-
-| # | 原则 | 说明 |
-|---|------|------|
-| 1 | 逐 REQ 迭代 | 一次处理一个 REQ/切片，干净上下文，避免上下文线性膨胀 |
-| 2 | Token 节约 | 比旧并行模式节约 40-67% token |
-| 3 | 全量回归 | 每个 REQ 完成后跑全量测试 |
-| 4 | 进度持久化 | progress.log 持久化 learnings/permanent/contextual |
-| 5 | 可中断续传 | 中断后可从最后完成 REQ 继续 |
-
-## AHE 分类
-
-| 字段 | 值 |
-|------|---|
-| 组件类型 | System Prompt |
-| 修改频率预期 | 低 |

package/plugins/qoder/skills/ralph-loop/references/components/tool-descriptions.md

@@ -1,32 +0,0 @@
-# tool-descriptions.md — Ralph Loop 各步骤工具链（AHE 组件分解）
-
-> **本文是 `skills/ralph-loop/SKILL.md` 中构建步骤的 AHE 对齐展开。**
-
-## 组件职责
-
-描述 Ralph Loop 中每个 REQ 执行的具体工具链：TDD 流、回归测试、成本监控。
-
-## 构建步骤
-
-| 步骤 | 动作 | 说明 |
-|------|------|------|
-| 1 | 加载当前 REQ | 从 specification.yaml 获取下一个 READY REQ |
-| 2 | 加载 learnings | 从 progress.log 加载 permanent + contextual learnings |
-| 3 | 测试基础设施检查 | 检查 test-utils.ts 是否存在且导出 createTestApp()、withTestDb()。不存在 → dispatch test-infra subagent，retry max 2，失败 → BLOCK/fallback |
-| 4 | TDD (RED→GREEN→REFACTOR) | test-driven-development skill（含 TDD 铁律 + Mock 边界注入）|
-| 5 | 全量回归测试 | 运行全部现有测试 |
-| 6 | 测试先行比率检查 (L1b) | 新增测试行数 / (新增测试 + 新增实现) ≥ 40% |
-| 7 | 记录 progress.log | 将 learnings 分类存储 (permanent/contextual) |
-| 8 | 成本检查 | token 使用量是否超阈值 |
-| 9 | 完成/继续 | 所有 REQ 完成 → 结束；否则 → 下一个 REQ |
-
-## 语言特定
-
-通过 `--lang` 注入对应 TDD skill: `springboot-tdd`, `django-tdd`, `golang-testing`
-
-## AHE 分类
-
-| 字段 | 值 |
-|------|---|
-| 组件类型 | Tool Description |
-| 修改频率预期 | 高 |