@boyingliu01/xp-gate 0.14.23 → 0.14.25

package/bin/xp-gate.js

@@ -195,6 +195,14 @@ const COMMANDS = {
     description: 'Run all invokable quality gates',
     run: subargs => check(['--all', ...subargs]).then(code => process.exit(code)),
     usage: 'xp-gate gate-all [<path>]'
+  },
+  'phase-transition': {
+    description: 'Transition sprint phase + auto-render dashboard (resolves #338)',
+    run: subargs => {
+      const { handlePhaseTransition } = require('../lib/phase-transition.js');
+      handlePhaseTransition(subargs).then(code => process.exit(code));
+    },
+    usage: 'xp-gate phase-transition <phase> <status> [--render] [--outputs <json>]'
   }
 };
 

package/lib/__tests__/init.test.js

@@ -370,4 +370,81 @@ describe('init', () => {
     const result = await init(['--core-only']);
     expect(result).toBe(0);
   });
+
+  describe('configureQoderDelphiAgents', () => {
+    function qoderSkillsDir() {
+      return path.join(tmpHome, '.qoder', 'skills');
+    }
+
+    function setupQoderPlatform() {
+      fs.mkdirSync(qoderSkillsDir(), { recursive: true });
+    }
+
+    function agentTemplateDir() {
+      // srcDir = path.dirname(__dirname) = src/npm-package/lib -> src/npm-package
+      return path.join(__dirname, '..', '..', 'plugins', 'qoder', 'agents');
+    }
+
+    it('deploys Delphi agents when platform is Qoder and agents do not exist', async () => {
+      fs.mkdirSync(path.join(tmpProject, '.git', 'hooks'), { recursive: true });
+      mockExecSuccess();
+      setupQoderPlatform();
+
+      // Ensure agent templates exist in the npm package
+      const templateDir = agentTemplateDir();
+      fs.mkdirSync(templateDir, { recursive: true });
+      fs.writeFileSync(path.join(templateDir, 'delphi-architecture.md'), '---\nname: test\n---\narch expert');
+
+      vi.resetModules();
+      delete require.cache[require.resolve('../init')];
+      delete require.cache[require.resolve('../detect-deps.js')];
+      delete require.cache[require.resolve('../shared-paths')];
+
+      const { init } = require('../init');
+      const result = await init(['--core-only']);
+      expect(result).toBe(0);
+
+      const deployedAgent = path.join(tmpProject, '.qoder', 'agents', 'delphi-architecture.md');
+      expect(fs.existsSync(deployedAgent)).toBe(true);
+      expect(fs.readFileSync(deployedAgent, 'utf8')).toContain('arch expert');
+    });
+
+    it('does not overwrite existing agent files (preserves user customizations)', async () => {
+      fs.mkdirSync(path.join(tmpProject, '.git', 'hooks'), { recursive: true });
+      mockExecSuccess();
+      setupQoderPlatform();
+
+      // Pre-existing user-customized agent
+      const agentsDir = path.join(tmpProject, '.qoder', 'agents');
+      fs.mkdirSync(agentsDir, { recursive: true });
+      fs.writeFileSync(path.join(agentsDir, 'delphi-architecture.md'), 'CUSTOM USER CONTENT');
+
+      // Template in npm package
+      const templateDir = agentTemplateDir();
+      fs.mkdirSync(templateDir, { recursive: true });
+      fs.writeFileSync(path.join(templateDir, 'delphi-architecture.md'), 'TEMPLATE CONTENT');
+
+      vi.resetModules();
+      delete require.cache[require.resolve('../init')];
+      delete require.cache[require.resolve('../detect-deps.js')];
+      delete require.cache[require.resolve('../shared-paths')];
+
+      const { init } = require('../init');
+      await init(['--core-only']);
+
+      // User content preserved
+      expect(fs.readFileSync(path.join(agentsDir, 'delphi-architecture.md'), 'utf8')).toBe('CUSTOM USER CONTENT');
+    });
+
+    it('skips deployment when platform is not Qoder', async () => {
+      fs.mkdirSync(path.join(tmpProject, '.git', 'hooks'), { recursive: true });
+      mockExecSuccess();
+      // Default platform is 'opencode' (no .qoder/skills dir)
+
+      const { init } = require('../init');
+      await init(['--core-only']);
+
+      expect(fs.existsSync(path.join(tmpProject, '.qoder', 'agents'))).toBe(false);
+    });
+  });
 });

package/lib/__tests__/phase-transition.test.js

@@ -0,0 +1,174 @@
+/**
+ * Tests for phase-transition CLI command
+ * @test REQ-338 Phase transition CLI + dashboard rendering
+ * @intent Verify phase-transition command updates state and renders dashboard
+ * @covers AC-338-01 (CLI transitions phase and writes state)
+ * @covers AC-338-02 (--render flag outputs ASCII dashboard)
+ * @covers AC-338-03 (invalid inputs return error exit code)
+ * @covers AC-338-04 (--outputs flag records outputs in state)
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { handlePhaseTransition, renderDashboard } from '../phase-transition.js';
+
+describe('phase-transition', () => {
+  let tmpDir;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'phase-transition-test-'));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  describe('handlePhaseTransition()', () => {
+    it('returns 0 and shows help with --help', async () => {
+      const code = await handlePhaseTransition(['--help']);
+      expect(code).toBe(0);
+    });
+
+    it('returns 1 for missing arguments', async () => {
+      const code = await handlePhaseTransition([]);
+      expect(code).toBe(1);
+    });
+
+    it('returns 1 for invalid phase number', async () => {
+      const code = await handlePhaseTransition(['7', 'completed']);
+      expect(code).toBe(1);
+    });
+
+    it('returns 1 for invalid status', async () => {
+      const code = await handlePhaseTransition(['1', 'invalid_status']);
+      expect(code).toBe(1);
+    });
+
+    it('transitions phase and writes state file', async () => {
+      const code = await handlePhaseTransition(['1', 'completed', '--dir', tmpDir]);
+      expect(code).toBe(0);
+
+      const stateFile = path.join(tmpDir, '.sprint-state', 'sprint-state.json');
+      expect(fs.existsSync(stateFile)).toBe(true);
+
+      const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+      expect(state.phase).toBe(1);
+      expect(state.phase_history).toHaveLength(1);
+      expect(state.phase_history[0].status).toBe('completed');
+      expect(state.phase_history[0].phase_name).toBe('PREP');
+    });
+
+    it('records outputs when --outputs flag is provided', async () => {
+      const outputs = JSON.stringify({ spec: 'path/to/spec.yaml' });
+      const code = await handlePhaseTransition(['2', 'completed', '--outputs', outputs, '--dir', tmpDir]);
+      expect(code).toBe(0);
+
+      const stateFile = path.join(tmpDir, '.sprint-state', 'sprint-state.json');
+      const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+      expect(state.outputs.spec).toBe('path/to/spec.yaml');
+    });
+
+    it('returns 1 for invalid --outputs JSON', async () => {
+      const code = await handlePhaseTransition(['1', 'completed', '--outputs', 'not-json', '--dir', tmpDir]);
+      expect(code).toBe(1);
+    });
+
+    it('transitions through multiple phases sequentially', async () => {
+      await handlePhaseTransition(['1', 'completed', '--dir', tmpDir]);
+      await handlePhaseTransition(['2', 'in_progress', '--dir', tmpDir]);
+      await handlePhaseTransition(['2', 'completed', '--dir', tmpDir]);
+      await handlePhaseTransition(['3', 'in_progress', '--dir', tmpDir]);
+
+      const stateFile = path.join(tmpDir, '.sprint-state', 'sprint-state.json');
+      const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+
+      expect(state.phase).toBe(3);
+      expect(state.phase_history).toHaveLength(3);
+      expect(state.phase_history[0].status).toBe('completed');
+      expect(state.phase_history[1].status).toBe('completed');
+      expect(state.phase_history[2].status).toBe('in_progress');
+    });
+
+    it('updates existing entry when same phase is transitioned again', async () => {
+      await handlePhaseTransition(['1', 'in_progress', '--dir', tmpDir]);
+      await handlePhaseTransition(['1', 'completed', '--dir', tmpDir]);
+
+      const stateFile = path.join(tmpDir, '.sprint-state', 'sprint-state.json');
+      const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+
+      // Should NOT have duplicate entries
+      expect(state.phase_history).toHaveLength(1);
+      expect(state.phase_history[0].status).toBe('completed');
+      expect(state.phase_history[0].completed_at).toBeDefined();
+    });
+  });
+
+  describe('renderDashboard()', () => {
+    it('returns "No sprint state found" for null state', () => {
+      const result = renderDashboard(null);
+      expect(result).toBe('No sprint state found');
+    });
+
+    it('renders dashboard with all 6 phases', () => {
+      const state = {
+        id: 'sprint-test-123',
+        task_description: 'Test feature',
+        phase: 3,
+        status: 'in_progress',
+        started_at: '2026-07-21T10:00:00Z',
+        phase_history: [
+          { phase: 1, phase_name: 'PREP', status: 'completed', duration_seconds: 120 },
+          { phase: 2, phase_name: 'DESIGN', status: 'completed', duration_seconds: 300 },
+          { phase: 3, phase_name: 'BUILD', status: 'in_progress' },
+        ],
+        isolation: { branch: 'sprint/test-branch' },
+        outputs: {},
+      };
+
+      const result = renderDashboard(state);
+
+      expect(result).toContain('SPRINT PROGRESS');
+      expect(result).toContain('sprint-test-123');
+      expect(result).toContain('Test feature');
+      expect(result).toContain('sprint/test-branch');
+      expect(result).toContain('Phase 1/6');
+      expect(result).toContain('Phase 6/6');
+      expect(result).toContain('✅'); // completed phases
+      expect(result).toContain('🔄'); // in_progress phase
+      expect(result).toContain('⏳'); // pending phases
+    });
+
+    it('shows outputs section when outputs exist', () => {
+      const state = {
+        id: 'sprint-out',
+        task_description: 'Feature',
+        phase: 2,
+        status: 'in_progress',
+        started_at: '2026-07-21T10:00:00Z',
+        phase_history: [],
+        isolation: { branch: 'test' },
+        outputs: { spec: 'design.yaml', pr: '#42' },
+      };
+
+      const result = renderDashboard(state);
+      expect(result).toContain('输出物');
+      expect(result).toContain('spec: design.yaml');
+      expect(result).toContain('pr: #42');
+    });
+
+    it('handles minimal state gracefully', () => {
+      const state = {
+        id: 'sprint-min',
+        phase: 1,
+        status: 'in_progress',
+        phase_history: [],
+      };
+
+      const result = renderDashboard(state);
+      expect(result).toContain('SPRINT PROGRESS');
+      expect(result).toContain('sprint-min');
+    });
+  });
+});

package/lib/init.js

@@ -402,6 +402,7 @@ async function installLocal(args) {
 
   injectKarpathyPrinciples(projectRoot);
   configureOpenCodePlugin(srcDir, projectRoot);
+  configureQoderDelphiAgents(srcDir, projectRoot);
 
   // Auto-register TUI plugin globally (idempotent)
   try {
@@ -503,6 +504,53 @@ async function setupGlobal(args) {
   return 0;
 }
 
+/**
+ * Deploy Qoder-native Delphi review agents when platform is Qoder.
+ * Copies agent templates from the bundled qoder plugin to the project's
+ * .qoder/agents/ directory. Idempotent — never overwrites existing files.
+ *
+ * @param {string} srcDir - npm package source directory
+ * @param {string} projectRoot - user's project root
+ */
+function configureQoderDelphiAgents(srcDir, projectRoot) {
+  const platform = detectPlatform();
+  if (platform !== 'qoder') {
+    return; // Not Qoder — skip (OpenCode uses .delphi-config.json instead)
+  }
+
+  const agentSrcDir = path.join(srcDir, 'plugins', 'qoder', 'agents');
+  if (!fs.existsSync(agentSrcDir)) {
+    console.log('  Qoder Delphi agents: SKIP (templates not bundled)');
+    return;
+  }
+
+  const agentsDestDir = path.join(projectRoot, '.qoder', 'agents');
+  fs.mkdirSync(agentsDestDir, { recursive: true });
+
+  const agentFiles = fs.readdirSync(agentSrcDir).filter(f => f.endsWith('.md'));
+  let deployed = 0;
+  let skipped = 0;
+  for (const file of agentFiles) {
+    const destFile = path.join(agentsDestDir, file);
+    if (fs.existsSync(destFile)) {
+      skipped++;
+      continue; // Don't overwrite user customizations
+    }
+    fs.copyFileSync(path.join(agentSrcDir, file), destFile);
+    deployed++;
+  }
+
+  if (deployed > 0) {
+    console.log(`  Qoder Delphi agents: deployed ${deployed} agent(s) to .qoder/agents/`);
+  }
+  if (skipped > 0) {
+    console.log(`  Qoder Delphi agents: ${skipped} existing agent(s) preserved`);
+  }
+  if (deployed === 0 && skipped === 0) {
+    console.log('  Qoder Delphi agents: no agent templates found');
+  }
+}
+
 function configureOpenCodePlugin(srcDir, projectRoot) {
   const opencodeJsonPath = path.join(projectRoot, 'opencode.json');
   const pluginSrcPath = path.join(srcDir, 'plugins', 'opencode');

package/lib/phase-transition.js

@@ -0,0 +1,211 @@
+/**
+ * xp-gate phase-transition — Programmatic sprint phase transition
+ *
+ * Resolves #338 (dashboard never auto-renders) and #146 (sprint-state enforcement).
+ * 
+ * This CLI command is the programmatic entry point for sprint phase transitions.
+ * The sprint-flow SKILL.md MUST instruct the orchestrator to call this command
+ * after each phase completion, replacing text-level MUST instructions with
+ * a concrete CLI invocation.
+ *
+ * Usage:
+ *   xp-gate phase-transition <phase> <status> [--outputs <json>] [--render]
+ *
+ * Examples:
+ *   xp-gate phase-transition 1 completed
+ *   xp-gate phase-transition 2 in_progress
+ *   xp-gate phase-transition 3 completed --outputs '{"spec":"path/to/spec.yaml"}'
+ *   xp-gate phase-transition 3 completed --render  (auto-render dashboard)
+ *
+ * @module phase-transition
+ */
+
+'use strict';
+
+const path = require('path');
+const { SprintStateManager } = require('./sprint-state-manager');
+
+/**
+ * Render ASCII dashboard from sprint state.
+ * Reuses the formatSprintTable logic from sprint-status.
+ * @param {object} state - Sprint state object
+ * @returns {string} Rendered dashboard
+ */
+function renderDashboard(state) {
+  if (!state) return 'No sprint state found';
+
+  const PHASE_NAMES = {
+    '1': 'PREP', '2': 'DESIGN', '3': 'BUILD',
+    '4': 'VERIFY', '5': 'SHIP', '6': 'CLOSE',
+  };
+
+  function statusIcon(status) {
+    switch (status) {
+      case 'completed': return '✅';
+      case 'in_progress': return '🔄';
+      case 'skipped': return '⏭️';
+      case 'failed': return '❌';
+      case 'paused': return '⏸️';
+      default: return '⏳';
+    }
+  }
+
+  function formatDuration(seconds) {
+    if (seconds == null || seconds === 0) return '-';
+    if (seconds < 60) return `${seconds}s`;
+    const mins = Math.floor(seconds / 60);
+    if (mins < 60) return `${mins}m`;
+    const hrs = Math.floor(mins / 60);
+    if (hrs < 24) return `${hrs}h ${mins % 60}m`;
+    return `${Math.floor(hrs / 24)}d ${hrs % 24}h`;
+  }
+
+  const branch = state.isolation?.branch || 'unknown';
+  const sprintId = state.id || 'unknown';
+  const taskDesc = state.task_description || state.issue_title || '-';
+  const overallStatus = state.status || 'running';
+  const startedAt = state.started_at ? state.started_at.slice(0, 16).replace('T', ' ') : '-';
+
+  // Build phase history lookup
+  const historyLookup = {};
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      historyLookup[String(ph.phase)] = ph;
+    }
+  }
+
+  const currentPhase = state.phase || 1;
+  const currentPhaseName = PHASE_NAMES[String(currentPhase)] || `Phase ${currentPhase}`;
+
+  // Progress bar
+  const completedCount = Object.values(historyLookup).filter(h => h.status === 'completed').length;
+  const pct = Math.round((completedCount / 6) * 100);
+  const filled = '█'.repeat(completedCount);
+  const current = currentPhase <= 6 ? '▓' : '';
+  const empty = '░'.repeat(Math.max(0, 6 - completedCount - (current ? 1 : 0)));
+  const progressBar = `[${filled}${current}${empty}] ${pct}%`;
+
+  // Build lines
+  const lines = [];
+  lines.push('+============================================================+');
+  lines.push(`|  SPRINT PROGRESS                      ${sprintId.padEnd(20)}|`);
+  lines.push('+============================================================+');
+  lines.push(`|  需求: ${(taskDesc).slice(0, 54).padEnd(54)}|`);
+  lines.push(`|  分支: ${(branch).slice(0, 54).padEnd(54)}|`);
+  lines.push(`|  状态: ${(overallStatus).slice(0, 15).padEnd(15)}        启动: ${startedAt.slice(0, 19).padEnd(19)}|`);
+  lines.push('+============================================================+');
+  lines.push('|                                                             |');
+
+  for (let i = 1; i <= 6; i++) {
+    const entry = historyLookup[String(i)];
+    const icon = statusIcon(entry?.status || (i < currentPhase ? 'completed' : i === currentPhase ? 'in_progress' : 'pending'));
+    const name = (PHASE_NAMES[String(i)] || `Phase ${i}`).padEnd(10);
+    const dur = formatDuration(entry?.duration_seconds).padEnd(8);
+    lines.push(`|  ${icon} Phase ${i}/6  ${name} ${dur}          |`);
+  }
+
+  lines.push('|                                                             |');
+  lines.push(`|  ${progressBar.padEnd(58)}|`);
+  lines.push('+============================================================+');
+  lines.push(`|  > 当前: Phase ${currentPhase}/6 ${currentPhaseName}`.padEnd(59) + '|');
+  lines.push(`|    状态: ${(entry_status(currentPhase, historyLookup)).padEnd(50)}|`);
+  lines.push('+============================================================+');
+
+  // Outputs section
+  if (state.outputs && Object.keys(state.outputs).length > 0) {
+    lines.push('|  输出物:                                                     |');
+    for (const [key, val] of Object.entries(state.outputs)) {
+      lines.push(`|    ${(`${key}: ${val}`).slice(0, 55).padEnd(55)}|`);
+    }
+    lines.push('+============================================================+');
+  }
+
+  return lines.join('\n');
+
+  function entry_status(phaseNum, lookup) {
+    const e = lookup[String(phaseNum)];
+    return e?.status || (phaseNum < currentPhase ? 'completed' : phaseNum === currentPhase ? 'in_progress' : 'pending');
+  }
+}
+
+/**
+ * CLI entry point for phase-transition command.
+ * @param {string[]} args - CLI arguments
+ * @returns {Promise<number>} Exit code
+ */
+async function handlePhaseTransition(args = []) {
+  if (args.includes('--help')) {
+    console.log('Usage: xp-gate phase-transition <phase> <status> [options]');
+    console.log('');
+    console.log('Arguments:');
+    console.log('  phase    Phase number (1-6)');
+    console.log('  status   Status: in_progress | completed | skipped | failed | paused');
+    console.log('');
+    console.log('Options:');
+    console.log('  --outputs <json>   JSON object of outputs to record');
+    console.log('  --render           Render ASCII dashboard after transition');
+    console.log('  --dir <path>       Project directory (default: cwd)');
+    console.log('');
+    console.log('Examples:');
+    console.log('  xp-gate phase-transition 1 completed');
+    console.log('  xp-gate phase-transition 3 completed --render');
+    console.log('  xp-gate phase-transition 2 in_progress --outputs \'{"spec":"path.yaml"}\'');
+    return 0;
+  }
+
+  if (args.length < 2) {
+    console.error('Error: Missing required arguments. Usage: xp-gate phase-transition <phase> <status>');
+    return 1;
+  }
+
+  const phase = parseInt(args[0], 10);
+  const status = args[1];
+  const renderFlag = args.includes('--render');
+  const dirIdx = args.indexOf('--dir');
+  const projectDir = dirIdx >= 0 ? args[dirIdx + 1] : process.cwd();
+
+  const outputsIdx = args.indexOf('--outputs');
+  let outputs = {};
+  if (outputsIdx >= 0 && args[outputsIdx + 1]) {
+    try {
+      outputs = JSON.parse(args[outputsIdx + 1]);
+    } catch (err) {
+      console.error(`Error: Invalid JSON for --outputs: ${err.message}`);
+      return 1;
+    }
+  }
+
+  // Validate inputs
+  if (phase < 1 || phase > 6) {
+    console.error(`Error: Phase must be 1-6, got ${phase}`);
+    return 1;
+  }
+
+  const validStatuses = ['in_progress', 'completed', 'skipped', 'failed', 'paused'];
+  if (!validStatuses.includes(status)) {
+    console.error(`Error: Status must be one of: ${validStatuses.join(', ')}`);
+    return 1;
+  }
+
+  // Execute transition
+  try {
+    const manager = new SprintStateManager(projectDir);
+    const newState = manager.transitionPhase(phase, status, { outputs });
+
+    console.log(`✅ Phase ${phase} transitioned to '${status}'`);
+
+    // Auto-render dashboard if --render flag is set
+    if (renderFlag) {
+      console.log('');
+      const dashboard = renderDashboard(newState);
+      console.log(dashboard);
+    }
+
+    return 0;
+  } catch (err) {
+    console.error(`Error: Phase transition failed: ${err.message}`);
+    return 1;
+  }
+}
+
+module.exports = { handlePhaseTransition, renderDashboard };

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-07-21
-**Commit:** 03e9223
+**Generated:** 2026-07-22
+**Commit:** 97dd89a
 **Branch:** main
-**Version:** 0.14.23.0
+**Version:** 0.14.25.0
 
 ## OVERVIEW
 Mock layering policy enforcement — Gate M3 of pre-push hook. Ensures integration tests use real implementations for internal dependencies, mock external dependencies, and annotate pending mocks with removal plans. Combines project scope scanning, mock decision engine, and per-file validation into a single pipeline.

package/mutation/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MUTATION KNOWLEDGE BASE
 
-**Generated:** 2026-07-21
-**Commit:** 03e9223
+**Generated:** 2026-07-22
+**Commit:** 97dd89a
 **Branch:** main
-**Version:** 0.14.23.0
+**Version:** 0.14.25.0
 
 ## OVERVIEW
 **Gate M** (incremental mutation testing) + **Gate M2** helpers (test-layer detection used by `src/mock-policy/`). Pre-push quality gate. TypeScript-only; uses Stryker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.14.23",
+  "version": "0.14.25",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"
@@ -39,7 +39,7 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "version": "0.14.23",
+    "version": "0.14.25",
     "prepack": "node scripts/sync-package-content.js",
     "test": "echo \"Run tests\" && exit 0"
   },

package/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.14.23",
+  "version": "0.14.25",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/claude-code/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-07-21
-**Commit:** 03e9223
+**Generated:** 2026-07-22
+**Commit:** 97dd89a
 **Branch:** main
-**Version:** 0.14.23.0
+**Version:** 0.14.25.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/claude-code/skills/delphi-review/SKILL.md

@@ -294,14 +294,34 @@ Each round MUST output a structured round marker:
 | 2 专家（默认） | A(架构) + B(实现) | 代码变更、小型设计 |
 | 3 专家 | A(架构) + B(实现) + C(可行性) | 架构决策、需求文档 |
 
-### 模型选择策略（强制 — 从 opencode.json 读取）
-
-**MUST 从 `opencode.json` 的 agent 配置中读取模型**，**严禁** hardcode 模型名称。
+### 模型选择策略（强制 — 平台适配）
 
 **关键原则**：
 - ✅ 三个专家必须来自 **至少 2 家不同 provider**
-- ❌ 禁止 hardcode 模型名称（模型列表以 `opencode.json` 为准）
+- ❌ 禁止 hardcode 模型名称
 - ❌ 禁止三个专家全部使用同一 provider 的模型
+- ❌ 禁止使用 Anthropic/OpenAI/Google 等国外模型
+
+#### Qoder 平台（推荐 — Custom Agent 模式）
+
+Qoder 环境下使用 **Custom Agent** 机制，每个专家是一个独立的 custom agent，配置不同的 Qoder 内置模型：
+
+| 专家 | Agent 文件 | 模型 | Credits 费率 |
+|------|-----------|------|-------------|
+| Architecture (A) | `.qoder/agents/delphi-architecture.md` | Qwen3.7-Max | 0.5× |
+| Technical (B) | `.qoder/agents/delphi-technical.md` | GLM-5.2 | 0.6× |
+| Feasibility (C) | `.qoder/agents/delphi-feasibility.md` | DeepSeek-V4-Pro | 0.5× |
+
+**执行方式**：通过 Agent tool 并行启动 3 个 subagent（type=GeneralPurpose），每个 agent 使用自己配置的模型独立评审，主 orchestrator 收集结果后计算共识。
+
+**优势**：无需外部 API key，直接使用 Qoder Credits，模型由平台统一管理。
+
+#### OpenCode 平台（External API 模式）
+
+OpenCode 环境下通过 `opencode.json` 的 agent 配置 + `.delphi-config.json` 调用外部 API：
+- **MUST 从 `opencode.json` 的 agent 配置中读取模型**
+- 通过 `scripts/delphi-external-review.cjs` 调用各 provider 的 OpenAI 兼容 API
+- 需要用户自行配置 API key（环境变量注入）
 
 ### 共识阈值
 

package/plugins/claude-code/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-21
-**Commit:** 03e9223
+**Generated:** 2026-07-22
+**Commit:** 97dd89a
 **Branch:** main
-**Version:** 0.14.23.0
+**Version:** 0.14.25.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.