@boyingliu01/xp-gate 0.6.0 → 0.7.0

package/plugins/qoder/widgets/sprint-dashboard.html

@@ -0,0 +1,172 @@
+<style>
+  :root {
+    --sd-bg: var(--vscode-editor-background, #1e1e1e);
+    --sd-fg: var(--vscode-editor-foreground, #d4d4d4);
+    --sd-border: var(--vscode-panel-border, #333);
+    --sd-pass: var(--vscode-testing-iconPassed, #73c991);
+    --sd-fail: var(--vscode-testing-iconFailed, #f14c4c);
+    --sd-skip: var(--vscode-descriptionForeground, #888);
+    --sd-accent: var(--vscode-focusBorder, #007acc);
+    --sd-card-bg: var(--vscode-editor-widget-background, #252526);
+    --sd-active: var(--vscode-charts-yellow, #e5c07b);
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: var(--vscode-font-family, 'Segoe UI', sans-serif); color: var(--sd-fg); background: var(--sd-bg); padding: 16px; }
+  .sd-header { display: flex; align-items: center; justify-content: space-between; margin-bottom: 16px; }
+  .sd-header h2 { font-size: 16px; font-weight: 600; }
+  .sd-status-badge { padding: 4px 12px; border-radius: 4px; font-size: 12px; font-weight: 600; text-transform: uppercase; }
+  .sd-status-badge.running { background: color-mix(in srgb, var(--sd-accent) 20%, transparent); color: var(--sd-accent); border: 1px solid var(--sd-accent); }
+  .sd-status-badge.paused { background: color-mix(in srgb, var(--sd-active) 20%, transparent); color: var(--sd-active); border: 1px solid var(--sd-active); }
+  .sd-status-badge.completed, .sd-status-badge.merged { background: color-mix(in srgb, var(--sd-pass) 20%, transparent); color: var(--sd-pass); border: 1px solid var(--sd-pass); }
+  .sd-meta { font-size: 12px; color: var(--sd-skip); margin-bottom: 16px; }
+  .sd-phase-track { display: flex; align-items: center; gap: 4px; margin-bottom: 20px; overflow-x: auto; padding-bottom: 4px; }
+  .sd-phase { display: flex; flex-direction: column; align-items: center; min-width: 72px; }
+  .sd-phase-dot { width: 28px; height: 28px; border-radius: 50%; display: flex; align-items: center; justify-content: center; font-size: 11px; font-weight: 700; border: 2px solid var(--sd-border); color: var(--sd-skip); background: var(--sd-bg); }
+  .sd-phase-dot.done { background: color-mix(in srgb, var(--sd-pass) 20%, transparent); border-color: var(--sd-pass); color: var(--sd-pass); }
+  .sd-phase-dot.active { background: color-mix(in srgb, var(--sd-accent) 25%, transparent); border-color: var(--sd-accent); color: var(--sd-accent); animation: pulse 1.5s infinite; }
+  .sd-phase-dot.future { border-color: var(--sd-border); color: var(--sd-skip); }
+  .sd-phase-label { font-size: 10px; margin-top: 4px; color: var(--sd-skip); text-align: center; white-space: nowrap; }
+  .sd-phase-label.active { color: var(--sd-accent); font-weight: 600; }
+  .sd-phase-label.done { color: var(--sd-pass); }
+  .sd-phase-line { width: 16px; height: 2px; background: var(--sd-border); margin-bottom: 20px; }
+  .sd-phase-line.done { background: var(--sd-pass); }
+  @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.6; } }
+  .sd-section { margin-bottom: 16px; }
+  .sd-section h3 { font-size: 14px; font-weight: 600; margin-bottom: 10px; padding-bottom: 6px; border-bottom: 1px solid var(--sd-border); }
+  .sd-progress-row { display: flex; align-items: center; gap: 10px; margin-bottom: 10px; }
+  .sd-progress-row .label { font-size: 13px; min-width: 100px; }
+  .sd-progress-row .bar-track { flex: 1; height: 10px; background: var(--sd-border); border-radius: 5px; overflow: hidden; }
+  .sd-progress-row .bar-fill { height: 100%; border-radius: 5px; background: var(--sd-accent); transition: width 0.4s ease; }
+  .sd-progress-row .count { font-size: 13px; font-weight: 600; min-width: 60px; text-align: right; }
+  .sd-outputs { display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: 8px; }
+  .sd-output-item { background: var(--sd-card-bg); border: 1px solid var(--sd-border); border-radius: 4px; padding: 8px 10px; font-size: 12px; }
+  .sd-output-item .key { color: var(--sd-skip); font-size: 11px; }
+  .sd-output-item .val { margin-top: 2px; font-weight: 500; word-break: break-all; }
+  .sd-metrics { display: flex; gap: 12px; flex-wrap: wrap; margin-bottom: 16px; }
+  .sd-metric-card { background: var(--sd-card-bg); border: 1px solid var(--sd-border); border-radius: 6px; padding: 10px 14px; text-align: center; min-width: 100px; }
+  .sd-metric-card .value { font-size: 22px; font-weight: 700; color: var(--sd-accent); }
+  .sd-metric-card .label { font-size: 11px; color: var(--sd-skip); margin-top: 2px; }
+  .sd-learnings { list-style: none; }
+  .sd-learnings li { padding: 6px 0; font-size: 12px; border-bottom: 1px solid var(--sd-border); }
+  .sd-learnings li:last-child { border-bottom: none; }
+  .sd-learnings .cat { display: inline-block; padding: 1px 6px; border-radius: 3px; font-size: 10px; font-weight: 600; background: var(--sd-card-bg); border: 1px solid var(--sd-border); margin-right: 6px; }
+  .sd-empty { text-align: center; padding: 32px; color: var(--sd-skip); font-size: 13px; }
+</style>
+
+<div id="sd-root"></div>
+
+<script>
+(function() {
+  const data = window.__WIDGET_DATA__ || {};
+  const root = document.getElementById('sd-root');
+
+  if (!data || (!data.phase && !data.id && !data.status)) {
+    root.innerHTML = '<div class="sd-empty">No sprint state data available.<br>Start a sprint with /sprint-flow to see the dashboard.</div>';
+    return;
+  }
+
+  const PHASES = [
+    { num: -1, name: 'ISOLATE' },
+    { num: 0, name: 'THINK' },
+    { num: 1, name: 'PLAN' },
+    { num: 2, name: 'BUILD' },
+    { num: 3, name: 'REVIEW' },
+    { num: 4, name: 'UAT' },
+    { num: 5, name: 'FEEDBACK' },
+    { num: 6, name: 'SHIP' },
+    { num: 7, name: 'LAND' },
+    { num: 8, name: 'CLEANUP' }
+  ];
+
+  const currentPhase = data.phase !== undefined ? data.phase : -2;
+  const status = data.status || 'unknown';
+  const outputs = data.outputs || {};
+  const metrics = data.metrics || {};
+  const learnings = data.learnings || [];
+
+  let html = '';
+
+  // Header
+  html += '<div class="sd-header">';
+  html += '<h2>Sprint' + (data.id ? ' — ' + esc(data.id) : '') + '</h2>';
+  const statusCls = ['running', 'paused', 'completed', 'merged'].includes(status) ? status : 'running';
+  html += '<span class="sd-status-badge ' + statusCls + '">' + esc(status) + '</span>';
+  html += '</div>';
+
+  // Phase progress track
+  html += '<div class="sd-phase-track">';
+  for (let i = 0; i < PHASES.length; i++) {
+    const p = PHASES[i];
+    if (i > 0) {
+      const lineCls = p.num <= currentPhase ? 'done' : '';
+      html += '<div class="sd-phase-line ' + lineCls + '"></div>';
+    }
+    let dotCls = 'future';
+    if (p.num < currentPhase) dotCls = 'done';
+    else if (p.num === currentPhase) dotCls = 'active';
+    const lblCls = p.num < currentPhase ? 'done' : p.num === currentPhase ? 'active' : '';
+    const icon = p.num < currentPhase ? '✓' : p.num === currentPhase ? '▶' : String(p.num);
+    html += '<div class="sd-phase">';
+    html += '<div class="sd-phase-dot ' + dotCls + '">' + icon + '</div>';
+    html += '<div class="sd-phase-label ' + lblCls + '">' + esc(p.name) + '</div>';
+    html += '</div>';
+  }
+  html += '</div>';
+
+  // Metrics cards
+  if (metrics.tests_passed !== undefined || metrics.coverage_pct !== undefined || metrics.tests_failed !== undefined) {
+    html += '<div class="sd-metrics">';
+    if (metrics.tests_passed !== undefined) {
+      html += '<div class="sd-metric-card"><div class="value">' + metrics.tests_passed + '</div><div class="label">Tests Passed</div></div>';
+    }
+    if (metrics.tests_failed !== undefined) {
+      html += '<div class="sd-metric-card"><div class="value" style="color:' + (metrics.tests_failed > 0 ? 'var(--sd-fail)' : 'var(--sd-pass)') + '">' + metrics.tests_failed + '</div><div class="label">Tests Failed</div></div>';
+    }
+    if (metrics.coverage_pct !== undefined) {
+      html += '<div class="sd-metric-card"><div class="value" style="color:' + (metrics.coverage_pct >= 80 ? 'var(--sd-pass)' : 'var(--sd-fail)') + '">' + metrics.coverage_pct + '%</div><div class="label">Coverage</div></div>';
+    }
+    html += '</div>';
+  }
+
+  // REQ progress
+  if (data.req_progress || data.reqs) {
+    const rp = data.req_progress || {};
+    const done = rp.done || 0;
+    const totalReqs = rp.total || (data.reqs ? data.reqs.length : 0);
+    const pct = totalReqs > 0 ? Math.round((done / totalReqs) * 100) : 0;
+    html += '<div class="sd-section"><h3>REQ Progress</h3>';
+    html += '<div class="sd-progress-row">';
+    html += '<span class="label">Completed</span>';
+    html += '<div class="bar-track"><div class="bar-fill" style="width:' + pct + '%"></div></div>';
+    html += '<span class="count">' + done + '/' + totalReqs + '</span>';
+    html += '</div></div>';
+  }
+
+  // Phase outputs
+  const outputKeys = Object.keys(outputs);
+  if (outputKeys.length > 0) {
+    html += '<div class="sd-section"><h3>Phase Outputs</h3>';
+    html += '<div class="sd-outputs">';
+    for (const key of outputKeys) {
+      html += '<div class="sd-output-item"><div class="key">' + esc(key) + '</div><div class="val">' + esc(outputs[key]) + '</div></div>';
+    }
+    html += '</div></div>';
+  }
+
+  // Learnings
+  if (learnings.length > 0) {
+    html += '<div class="sd-section"><h3>Recent Learnings</h3>';
+    html += '<ul class="sd-learnings">';
+    const recent = learnings.slice(-5).reverse();
+    for (const l of recent) {
+      const cat = l.category || 'general';
+      html += '<li><span class="cat">' + esc(cat) + '</span>' + esc(l.summary || l.text || JSON.stringify(l)) + '</li>';
+    }
+    html += '</ul></div>';
+  }
+
+  root.innerHTML = html;
+
+  function esc(s) { const d = document.createElement('div'); d.textContent = String(s); return d.innerHTML; }
+})();
+</script>

package/skills/delphi-review/SKILL.md

@@ -316,6 +316,54 @@ Every review round output MUST follow this exact JSON structure:
 
 ---
 
+## Qoder 平台适配
+
+在 Qoder IDE 中，delphi-review 的多专家评审通过以下方式实现：
+
+### 多模型评审（替代 OpenCode 的多 agent 配置）
+
+利用 Qoder 的多模型访问能力（类似 coding plan），通过 Agent subagent 派发不同模型完成 Expert A/B/C 评审：
+
+| 专家 | 角色 | Qoder Subagent 映射 | 说明 |
+|------|------|---------------------|------|
+| Expert A (架构) | 架构审查 | **plan-agent** subagent | 适合架构级分析 |
+| Expert B (技术) | 实现审查 | **CodeReview** subagent | 代码审查天然适合 |
+| Expert C (可行性) | 可行性仲裁 | **plan-agent** subagent（不同 prompt） | 与 Expert A 使用不同的评审 prompt |
+
+**执行流程**：
+1. orchestrator 准备评审材料（设计文档/代码变更）
+2. 分别派发 2-3 个 Agent subagent，每个 subagent 携带对应专家的 system prompt
+3. 收集各专家评审结果 → 合并为共识报告
+4. 如未达成共识 → 迭代（携带其他专家意见重新评审）
+
+### 专家配置
+
+专家→模型映射通过 `.qoder/delphi-config.json` 配置：
+
+```json
+{
+  "experts": {
+    "A": { "role": "architecture", "model_hint": "deepseek-v4-pro" },
+    "B": { "role": "implementation", "model_hint": "kimi-k2.6" },
+    "C": { "role": "feasibility", "model_hint": "qwen3.6-plus" }
+  },
+  "consensus_threshold": 0.95,
+  "max_rounds": 5
+}
+```
+
+> **注意**：`model_hint` 是建议模型，实际使用的模型取决于 Qoder 的模型调度策略。
+
+### 降级方案
+
+如果多模型 subagent 调用不可用，降级为**单模型多角色模式**：
+- 同一模型分别扮演 Expert A/B/C（不同 system prompt）
+- 明确标注降级警告：`[DEGRADED] 单模型多角色模式，失去跨 provider 匿名性保护`
+
+详细配置和执行指南参见 `references/qoder-multi-model.md`。
+
+---
+
 ## Anti-Patterns
 
 | ❌ 错误 | ✅ 正确 |

package/skills/delphi-review/references/qoder-multi-model.md

@@ -0,0 +1,191 @@
+# Qoder Multi-Model Review Guide for Delphi Review
+
+**Version:** v0.6.0  
+**Platform:** Qoder IDE  
+**Status:** Active
+
+---
+
+## 1. Overview
+
+Delphi Review requires multi-expert anonymous consensus review using at least 2 different LLM providers. In Qoder, this is achieved through Agent subagent dispatch, leveraging Qoder's built-in multi-model capability.
+
+---
+
+## 2. Expert Configuration
+
+### 2.1 Configuration File
+
+Create `.qoder/delphi-config.json` in project root:
+
+```json
+{
+  "experts": {
+    "A": {
+      "role": "architecture",
+      "focus": "System design, scalability, maintainability, SOLID principles",
+      "model_hint": "deepseek-v4-pro"
+    },
+    "B": {
+      "role": "implementation",
+      "focus": "Code quality, testing strategy, error handling, performance",
+      "model_hint": "kimi-k2.6"
+    },
+    "C": {
+      "role": "feasibility",
+      "focus": "Practical constraints, timeline, team capability, risk assessment",
+      "model_hint": "qwen3.6-plus"
+    }
+  },
+  "consensus_threshold": 0.95,
+  "max_rounds": 5,
+  "providers_required": 2
+}
+```
+
+### 2.2 Model Selection Rules
+
+- Experts MUST come from **at least 2 different providers**
+- **Forbidden**: Anthropic, OpenAI, Google (foreign models)
+- **Recommended domestic providers**: DeepSeek, Qwen (Alibaba), Kimi (Moonshot), GLM (Zhipu), MiniMax
+
+---
+
+## 3. Execution Flow in Qoder
+
+### 3.1 Round 1: Independent Anonymous Review
+
+For each expert, dispatch an Agent subagent with the expert's specific prompt:
+
+**Expert A (Architecture) — plan-agent**:
+```
+Agent(subagent_type="plan-agent", prompt="""
+You are Expert A in a Delphi consensus review. Your role: Architecture Reviewer.
+Focus: System design, scalability, maintainability, SOLID principles.
+
+Review the following design/code and provide your assessment:
+[REVIEW MATERIAL]
+
+Output format:
+{
+  "expert_id": "A",
+  "verdict": "APPROVED|REQUEST_CHANGES|REJECTED",
+  "issues": [...],
+  "strengths": [...],
+  "suggestions": [...]
+}
+""")
+```
+
+**Expert B (Implementation) — CodeReview subagent**:
+```
+Agent(subagent_type="CodeReview", prompt="""
+You are Expert B in a Delphi consensus review. Your role: Implementation Reviewer.
+Focus: Code quality, testing strategy, error handling, performance.
+
+Review the following code changes:
+[CHANGED FILES]
+""")
+```
+
+**Expert C (Feasibility) — plan-agent**:
+```
+Agent(subagent_type="plan-agent", prompt="""
+You are Expert C in a Delphi consensus review. Your role: Feasibility Arbiter.
+Focus: Practical constraints, timeline, team capability, risk assessment.
+
+Review the following design/code and provide your assessment:
+[REVIEW MATERIAL]
+
+Output format:
+{
+  "expert_id": "C",
+  "verdict": "APPROVED|REQUEST_CHANGES|REJECTED",
+  ...
+}
+""")
+```
+
+### 3.2 Consensus Aggregation
+
+After all experts respond:
+1. Parse each expert's JSON output
+2. Compare verdicts:
+   - All APPROVED → **Consensus: APPROVED**
+   - All REQUEST_CHANGES → Merge issues, present to user
+   - Mixed verdicts → **No consensus**, proceed to Round 2
+3. Calculate issue consensus ratio: issues agreed by ≥95% of experts → resolved
+
+### 3.3 Round 2+: Controlled Feedback
+
+In subsequent rounds, each expert receives other experts' anonymized opinions:
+```
+Agent(subagent_type="plan-agent", prompt="""
+You are Expert A. In Round 1, your verdict was: REQUEST_CHANGES.
+Other experts' anonymized feedback:
+- Expert X: APPROVED, noted [strengths]
+- Expert Y: REQUEST_CHANGES, noted [issues]
+
+Review your assessment in light of others' feedback. Maintain your independence.
+[REVIEW MATERIAL]
+""")
+```
+
+### 3.4 Terminal States
+
+| Condition | Action |
+|-----------|--------|
+| All experts APPROVED + ≥95% issue consensus | **APPROVED** — write `.sprint-state/delphi-reviewed.json` |
+| Max rounds reached without consensus | **REJECTED** — present disagreement summary |
+| Any expert REJECTED with critical issues | **REQUEST_CHANGES** — user must fix and re-review |
+
+---
+
+## 4. Degraded Mode
+
+When multi-model subagent dispatch is unavailable:
+
+### 4.1 Single-Model Multi-Role Mode
+
+The orchestrator plays all expert roles sequentially with different prompts:
+
+```
+⚠️ [DEGRADED] 单模型多角色模式
+失去跨 provider 匿名性保护，但保留多视角评审结构。
+建议：在条件允许时恢复多模型模式重新评审。
+```
+
+### 4.2 Degraded Output Format
+
+```json
+{
+  "mode": "design",
+  "verdict": "APPROVED",
+  "degraded": true,
+  "degradation_reason": "Multi-model subagent unavailable",
+  "experts": ["A", "B", "C"],
+  "model": "single"
+}
+```
+
+---
+
+## 5. Integration with Sprint Flow
+
+### 5.1 Phase 1 (Design Review)
+
+- Default: 2 experts (A + B)
+- Complex designs: 3 experts (A + B + C)
+- Output: `.sprint-state/delphi-reviewed.json` + `specification.yaml`
+
+### 5.2 Phase 3 (Code Walkthrough)
+
+- Default: 2 experts (A + B)
+- Use `CodeReview` subagent for Expert B
+- Output: `.code-walkthrough-result.json`
+
+### 5.3 HARD-GATE Enforcement
+
+- Phase 2 BUILD cannot start until delphi-review verdict is APPROVED
+- In Qoder: Pre-Edit Gate checks `.sprint-state/delphi-reviewed.json`
+- See sprint-flow SKILL.md for Pre-Edit Gate details

package/skills/ralph-loop/SKILL.md

@@ -297,6 +297,46 @@ Phase 0, 1, 3-6 行为完全不变。
 
 ---
 
+## Qoder 平台适配
+
+### Subagent Dispatch（替代 OpenCode 的 `task()` API）
+
+在 Qoder 环境中，ralph-loop 的 subagent 派发使用以下方式：
+
+| 原调用 | Qoder 替代 | 说明 |
+|---------|------------|------|
+| `task(category="unspecified-high", load_skills=["test-driven-development"])` | **orchestrator 直接执行** | ralph-loop 逐 REQ 迭代，每个 REQ 在干净上下文中执行，不需要独立 subagent |
+| `gstack/learn` | **Qoder Memory 系统** | permanent learnings → `UpdateMemory`；contextual learnings → 会话上下文 |
+
+### Learnings 持久化（替代 gstack/learn）
+
+ralph-loop 的 learnings 分类机制在 Qoder 中通过 Memory 系统实现更优雅的持久化：
+
+| Learnings 类型 | 原方案 | Qoder 替代 |
+|---------------|--------|------------|
+| **permanent** | progress.log + AGENTS.md | `UpdateMemory`（project_introduction / expert_experience / development_practice_specification 类型） |
+| **contextual** | progress.log（最近 3 条） | 当前会话上下文传递，不持久化 |
+| **Sprint retro** | gstack/learn | Phase 5 结束时 `UpdateMemory` 写入 |
+
+**执行方式**：每个 REQ 完成后，orchestrator 调用 `UpdateMemory` 存储 permanent learnings：
+- 架构决策 → `expert_experience` 类型
+- 接口约定/全局规范 → `development_practice_specification` 类型
+- 项目结构发现 → `project_introduction` 类型
+
+### 三层验证 Gate 增强（替代 PostToolUse Hook）
+
+在 Qoder 中，三层验证 Gate 增加 principles 检查步骤：
+
+| 层级 | 原验证 | Qoder 增强 |
+|------|--------|------------|
+| L1 | typecheck + lint | + **principles check**（`npx -y tsx src/principles/index.ts --files <changed> --format console`） |
+| L2 | 全量测试 | 无变化 |
+| L3 | coverage ≥ 80% | 无变化 |
+
+> **注意**：principles check 仅在 src/principles/ 存在时执行（非 xp-gate 项目跳过）。
+
+---
+
 ## Anti-Patterns
 
 | ❌ 错误 | ✅ 正确 |

package/skills/sprint-flow/SKILL.md

@@ -263,6 +263,25 @@ Phase 2 第一步必须执行 DELPHI-GATE 检查。没有 delphi-review APPROVED
 3. 验证 `verdict` 字段 == `"APPROVED"` → 不等于 → 同上 BLOCK
 4. ✅ 通过 → 进入 BUILD 编码
 
+**⚠️ Qoder Pre-Edit Gate（MANDATORY — 替代 Claude Code 的 delphi-review-guard.sh Hook）**:
+
+在 Qoder 环境中，由于没有 PreToolUse/PostToolUse 文件系统钩子，orchestrator **MUST** 在每次文件编辑/写入操作之前执行以下检查：
+
+1. 检查 `.sprint-state/` 目录是否存在 → 不存在 → 跳过检查（非 sprint 项目）
+2. 读取 `.sprint-state/delphi-reviewed.json` → 文件不存在 → **BLOCK**: 输出 `[DELPHI-GATE] delphi-review not APPROVED. 请先运行 /delphi-review`
+3. `verdict` != `"APPROVED"` → **BLOCK**
+4. `verdict` == `"APPROVED"` → 允许编辑
+
+此检查在 Phase 2 至 Phase 6 期间持续生效。orchestrator 不可绕过此检查。
+
+**Post-REQ Principles Check（替代 Claude Code 的 PostToolUse xp-gate-check Hook）**:
+
+每个 REQ 完成后（ralph-loop 三层验证 Gate 之后），orchestrator **MUST** 运行：
+```bash
+npx -y tsx src/principles/index.ts --files "<changed_files>" --format console
+```
+如果 src/principles/ 不存在（非 xp-gate 项目），则跳过此步骤。
+
 **输入**: `slices-manifest.json`（由 Phase 1 `/to-issues` 生成），按 `execution_order` 逐个执行。
 
 **默认模式**: `ralph-loop` — 逐 REQ/切片 迭代构建。每个切片（REQ）dispatch 独立 subagent，干净上下文，全量回归测试。Token 节约 40-67%。参见 `skills/ralph-loop/SKILL.md`。
@@ -425,6 +444,55 @@ Phase 2 第一步必须执行 DELPHI-GATE 检查。没有 delphi-review APPROVED
 | 7 | LAND | ✅ | `deep` | `["land-and-deploy"]` | subagent |
 | 8 | CLEANUP | ❌ | Bash（直接执行） | 无 | orchestrator |
 
+### Qoder Agent Dispatch Mapping（Qoder 平台替代方案）
+
+在 Qoder 环境中，OpenCode 的 `task()` API 和 superpowers/gstack 外部 skill 不可用。以下映射表说明每个 Phase 在 Qoder 中的执行方式：
+
+| Phase | 原 task()/skill 调用 | Qoder 替代方案 | 说明 |
+|-------|----------------------|--------------|------|
+| -1 ISOLATE | Bash 直接执行 | **Bash 直接执行**（无变化） | git worktree 操作平台无关 |
+| -0.5 AUTO-ESTIMATE | Bash 直接执行 | **Bash 直接执行**（无变化） | grep -rn 平台无关 |
+| 0 THINK | `task(deep, brainstorming)` | **plan-agent subagent** | 需求探索与设计适合 plan-agent |
+| 1 PLAN | `task(deep, autoplan+delphi+to-issues)` | **plan-agent subagent** | 规划类任务 |
+| 2 BUILD | `ralph-loop` + 外部 skill | **orchestrator 直接执行** | ralph-loop 逐 REQ 迭代，不需要独立 subagent |
+| 2 步骤 4 | `requesting-code-review` | **CodeReview subagent** | 代码盲评天然适合 CodeReview agent |
+| 2 步骤 6 | `verification-before-completion` | **orchestrator 内联** | 运行测试 + lint + coverage + principles |
+| 3 REVIEW | `task(deep, delphi+test-spec)` | **CodeReview subagent** + **browser-use MCP** | 代码走查 + 浏览器自动化 |
+| 4 ACCEPT | 强制人工 | **强制人工**（无变化） | 必须人工验收 |
+| 5 FEEDBACK | `task(quick, learn+retro+debug)` | **plan-agent** + **Memory 系统** | 回顾分析 + UpdateMemory 持久化 |
+| 6 SHIP | `task(quick, finishing-branch+ship)` | **orchestrator 直接执行** | git + gh CLI 操作平台无关 |
+| 7 LAND | `task(deep, land-and-deploy)` | **orchestrator 直接执行** | gh pr merge + CI polling |
+| 8 CLEANUP | Bash 直接执行 | **Bash 直接执行**（无变化） | git worktree remove 平台无关 |
+
+**Qoder 外部 Skill 降级表**（替代 superpowers/gstack 依赖）：
+
+| 外部 Skill | 来源 | Qoder 替代方案 |
+|-----------|------|----------------|
+| brainstorming | superpowers | orchestrator 内联需求探索对话 |
+| autoplan | gstack | plan-agent 分析代码库生成计划 |
+| freeze / unfreeze | gstack | Qoder Pre-Edit Gate 替代（见上方） |
+| requesting-code-review | superpowers | **CodeReview subagent** |
+| verification-before-completion | superpowers | orchestrator 运行测试+lint+coverage+principles |
+| learn / retro | gstack | Qoder **Memory 系统**（UpdateMemory / SearchMemory） |
+| browse | gstack | **browser-use MCP** 工具（navigate_page, click, fill, take_screenshot） |
+| ship / finishing-a-development-branch | superpowers/gstack | orchestrator 执行 git + gh CLI |
+| systematic-debugging | superpowers | orchestrator 内联分析错误日志 |
+| land-and-deploy / canary | gstack | orchestrator 执行 gh + curl/Invoke-RestMethod |
+| dispatching-parallel-agents | superpowers | orchestrator 按 dependency_graph 顺序执行 |
+| executing-plans | superpowers | orchestrator 直接执行 |
+
+**Qoder genui Widget 集成**：
+
+Phase 3 REVIEW 完成后，orchestrator **SHOULD** 使用 genui `show_widget` MCP 工具展示质量报告：
+- Widget 模板：`plugins/qoder/widgets/quality-report.html`
+- 数据源：读取项目根目录的 `quality-report.json`
+
+Sprint 执行过程中，用户可通过 `/sprint-status` 触发 genui `show_widget` 展示 Sprint 仪表板：
+- Widget 模板：`plugins/qoder/widgets/sprint-dashboard.html`
+- 数据源：`.sprint-state/sprint-state.json`
+
+详细适配规则参见 `references/qoder-adaptation.md`。
+
 **上下文隔离原则**：
 - 每个 Subagent 在**独立 session** 中启动，不继承 orchestrator 的对话历史
 - orchestrator session 仅接收 subagent 的最终结果摘要（~13,000 tokens/sprint）