@wwkit/freetoken 1.0.1

package/client/src/data/docs/skills.js

@@ -0,0 +1,396 @@
+// Skills 模块：AI 编程 Agent 的技能系统
+// 首个子模块：Superpowers — 完整的软件开发方法论技能库
+
+export default {
+  id: 'skills',
+  name: 'Skills',
+  badge: '技能系统',
+  tagline: 'AI 编程 Agent 的可组合技能库与自动触发机制',
+  description:
+    'Skills 是 AI 编程 Agent 的"方法论插件"——通过 Markdown 技能文件 + SessionStart Hook 自动注入，让 Agent 在编码前自动遵循 TDD、头脑风暴、计划编写、子 Agent 驱动开发等最佳实践。技能不是建议而是强制工作流——Agent 在任何响应前必须检查并调用相关技能。',
+
+  subModules: [
+    {
+      id: 'superpowers',
+      name: 'Superpowers',
+      badge: '方法论',
+      tagline: '为编码 Agent 打造的完整软件开发方法论',
+      description:
+        'Superpowers 是一套基于可组合技能（Skills）的软件开发方法论，由 Jesse Vincent / Prime Radiant 开发。它不是代码库或工具——而是一组 Markdown 技能文件 + SessionStart Hook，让 Claude Code、Codex、Cursor、OpenCode 等 14+ 种编码 Agent 自动遵循"先思考再编码"的工作流。核心理念：Agent 在写代码前必须先头脑风暴→设计方案→编写计划→TDD 实现→代码审查。',
+
+      // ── 核心机制 ──
+      coreMechanism: {
+        title: '核心机制：SessionStart Hook + 技能自动触发',
+        description:
+          'Superpowers 的核心是一个 bash 脚本（hooks/session-start），在 Agent 会话启动、清除、压缩（compact）时自动执行。它读取 using-superpowers 技能的全文，注入为会话上下文（包裹在 <EXTREMELY_IMPORTANT> 标签中），让 Agent 从第一条消息就知道自己"有超能力"并必须使用技能。',
+        flow: [
+          { phase: '1. Hook 触发', detail: 'SessionStart Hook 在会话启动/clear/compact 时触发（hooks.json 配置 matcher: "startup|clear|compact"）' },
+          { phase: '2. 读取 bootstrap', detail: 'bash 脚本读取 skills/using-superpowers/SKILL.md 全文，JSON 转义后包裹为 <EXTREMELY_IMPORTANT> 上下文' },
+          { phase: '3. 平台适配输出', detail: '检测当前平台（Cursor/Claude Code/Copilot CLI），输出对应格式的 JSON：additional_context（Cursor）/ hookSpecificOutput.additionalContext（Claude Code）/ additionalContext（SDK 标准）' },
+          { phase: '4. 上下文注入', detail: 'Agent 收到注入的 using-superpowers 技能全文，从第一条消息就知道自己有技能系统' },
+          { phase: '5. 技能自动触发', detail: 'Agent 在处理任何用户消息前，先检查是否有相关技能。如果有（哪怕 1% 可能性），必须调用 Skill 工具加载技能全文并遵循' },
+          { phase: '6. compact 后重新注入', detail: '会话压缩（compact）会丢失上下文——Hook 在 compact 后重新执行，确保长会话不丢失技能感知' },
+        ],
+        hookCode: `// hooks/hooks.json — SessionStart Hook 配置
+{
+  "hooks": {
+    "SessionStart": [{
+      "matcher": "startup|clear|compact",
+      "hooks": [{
+        "type": "command",
+        "command": "\${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd session-start",
+        "shell": "bash",
+        "async": false
+      }]
+    }]
+  }
+}
+
+// hooks/session-start — 核心注入逻辑（bash）
+using_superpowers_content=$(cat "skills/using-superpowers/SKILL.md")
+session_context="<EXTREMELY_IMPORTANT>\\nYou have superpowers.\\n\\n"
+  + "Below is your 'using-superpowers' skill...\\n"
+  + escape_for_json(using_superpowers_content)
+  + "\\n</EXTREMELY_IMPORTANT>"
+
+// 平台适配输出
+if Cursor:    { "additional_context": session_context }
+if Claude:    { "hookSpecificOutput": { additionalContext: session_context } }
+if Copilot:   { "additionalContext": session_context }`,
+        notes: [
+          'Hook 是同步的（async: false），确保上下文在 Agent 处理第一条消息前就注入',
+          'compact 后重新注入是关键——没有它，长会话会"忘记"自己有技能',
+          'using-superpowers 是唯一的"bootstrap 技能"——其他技能通过 Skill 工具按需加载',
+          'Hermes Agent 没有 post-compact hook，长会话压缩后会丢失 bootstrap',
+        ],
+      },
+
+      // ── 技能库 ──
+      skillLibrary: {
+        title: '技能库（14 个技能）',
+        description:
+          '每个技能是一个 SKILL.md 文件，含 frontmatter（name + description）和 Markdown 正文。技能按职责分为测试、调试、协作、元技能四类。',
+        categories: [
+          {
+            name: '测试',
+            skills: [
+              { name: 'test-driven-development', desc: 'RED-GREEN-REFACTOR 循环：先写失败测试→看它失败→写最小代码→看它通过→重构。铁律：没有失败测试就不写生产代码。先写了代码？删掉重来。' },
+            ],
+          },
+          {
+            name: '调试',
+            skills: [
+              { name: 'systematic-debugging', desc: '4 阶段根因分析流程，含根因追踪、纵深防御、条件等待技术' },
+              { name: 'verification-before-completion', desc: '完成前验证——确保真正修好了，不只是"看起来修好了"' },
+            ],
+          },
+          {
+            name: '协作',
+            skills: [
+              { name: 'brainstorming', desc: '苏格拉底式设计精炼——在写代码前先搞清楚要做什么。三条路径：Spike（可行性探查）/ Bounded（有界修改）/ Architectural（架构级）。HARD-GATE：设计批准前不写任何代码' },
+              { name: 'writing-plans', desc: '将设计拆解为 2-5 分钟的细粒度任务，每个任务含精确文件路径、完整代码、验证步骤' },
+              { name: 'executing-plans', desc: '分批执行计划，带人工检查点' },
+              { name: 'dispatching-parallel-agents', desc: '并发子 Agent 工作流' },
+              { name: 'subagent-driven-development', desc: '每任务一个新子 Agent + 两阶段审查（规格合规→代码质量）+ 全分支终审。核心原则：新子 Agent 隔离上下文，不继承会话历史' },
+              { name: 'requesting-code-review', desc: '代码审查前检查清单' },
+              { name: 'receiving-code-review', desc: '如何响应审查反馈' },
+              { name: 'using-git-worktrees', desc: 'Git worktree 隔离开发分支' },
+              { name: 'finishing-a-development-branch', desc: '合并/PR/保留/丢弃决策流程' },
+            ],
+          },
+          {
+            name: '元技能',
+            skills: [
+              { name: 'writing-skills', desc: '创建新技能的最佳实践——将 TDD 应用于流程文档：写压力测试场景→看 Agent 不带技能时失败（RED）→写技能文档（GREEN）→堵漏洞（REFACTOR）' },
+              { name: 'using-superpowers', desc: '技能系统入口——SessionStart Hook 自动注入，定义"任何响应前必须检查技能"的铁律和 Red Flags 表' },
+            ],
+          },
+        ],
+      },
+
+      // ── 基本工作流 ──
+      workflow: {
+        title: '基本工作流',
+        description:
+          'Superpowers 定义了一条从想法到交付的完整工作流，每个阶段由对应技能驱动。技能自动触发——用户不需要手动调用。',
+        stages: [
+          { step: '1. brainstorming', detail: '用户说"做个 X"→ 自动触发 brainstorming 技能。Agent 不直接写代码，而是通过对话搞清楚需求，输出设计方案。HARD-GATE：设计批准前不写代码' },
+          { step: '2. using-git-worktrees', detail: '设计批准后 → 自动创建隔离 worktree + 新分支，运行项目初始化，验证测试基线' },
+          { step: '3. writing-plans', detail: '将设计拆解为 2-5 分钟的细粒度任务列表，每个任务含精确文件路径和验证步骤' },
+          { step: '4. subagent-driven-development', detail: '逐任务派发子 Agent 执行，每个任务后做两阶段审查（规格合规 + 代码质量）。Agent 可自主工作数小时不偏离计划' },
+          { step: '5. test-driven-development', detail: '实现阶段强制 RED-GREEN-REFACTOR：先写失败测试→看它失败→写最小代码→看它通过→提交。先写了代码？删掉' },
+          { step: '6. requesting-code-review', detail: '任务间自动审查，按严重度报告问题。Critical 问题阻断进度' },
+          { step: '7. finishing-a-development-branch', detail: '所有任务完成后，验证测试、展示选项（合并/PR/保留/丢弃）、清理 worktree' },
+        ],
+      },
+
+      // ── using-superpowers 铁律 ──
+      ironRule: {
+        title: 'using-superpowers 技能的铁律',
+        description:
+          'using-superpowers 是唯一通过 Hook 自动注入的技能。它定义了技能系统的使用规则——核心是一条不可协商的铁律。',
+        rule: '在任何响应或行动之前调用相关技能——包括澄清问题、探索代码库、检查文件。即使只有 1% 的可能性技能适用，也必须调用。',
+        redFlags: [
+          { thought: '"这只是个简单问题"', reality: '问题是任务。检查技能。' },
+          { thought: '"我先需要更多上下文"', reality: '技能检查在澄清问题之前。' },
+          { thought: '"让我先探索代码库"', reality: '技能告诉你如何探索。先检查。' },
+          { thought: '"我可以快速检查 git/文件"', reality: '文件缺少对话上下文。检查技能。' },
+          { thought: '"这不需要正式技能"', reality: '如果技能存在，就用它。' },
+          { thought: '"我记得这个技能"', reality: '技能会演进。读当前版本。' },
+          { thought: '"技能太重了"', reality: '简单的事会变复杂。用它。' },
+          { thought: '"我先做这一件事"', reality: '在做任何事之前先检查。' },
+        ],
+        priority: 'process 技能优先于 implementation 技能——brainstorming 和 systematic-debugging 是最常见的 process 技能，先设定方法，再执行实现。',
+      },
+
+      // ── subagent-driven-development 核心设计 ──
+      subagentDesign: {
+        title: 'subagent-driven-development 的核心设计',
+        description:
+          'Superpowers 最独特的技能——通过派发隔离上下文的子 Agent 实现高质量自主开发。',
+        principles: [
+          { name: 'Fresh subagent per task', detail: '每个任务派发新子 Agent，不继承会话历史。主 Agent 精确构造子 Agent 需要的指令和上下文' },
+          { name: 'Two-stage review', detail: '每个任务后做两阶段审查：先查规格合规（是否做了该做的），再查代码质量（做得好不好）' },
+          { name: 'Continuous execution', detail: '不在任务间暂停询问"要继续吗"。执行所有任务直到完成或遇到四种停止条件之一' },
+          { name: 'Rulings not stalls', detail: '遇到冲突/歧义/计划缺陷时做裁决而非停顿。记录每个决定为 Ruling: <决定> — <原因> — <错了的代价>' },
+          { name: 'Broad final review', detail: '所有任务完成后做全分支审查，确保整体一致性' },
+        ],
+        stopConditions: '只有四种情况停止：1. 不可逆/破坏性操作 2. 安全敏感操作 3. 工作树外的副作用（merge/push/publish）4. 计划完全破碎、每条路都是猜测',
+      },
+
+      // ── writing-skills 的 TDD 方法论 ──
+      writingSkills: {
+        title: 'writing-skills：用 TDD 写技能',
+        description:
+          'Superpowers 将 TDD 应用于技能文档本身——技能不是散文，是塑造 Agent 行为的代码。',
+        tddMapping: [
+          { tdd: 'Test case', skillCreation: '压力测试场景（子 Agent 挑战）' },
+          { tdd: 'Production code', skillCreation: '技能文档（SKILL.md）' },
+          { tdd: 'Test fails (RED)', skillCreation: 'Agent 不带技能时违反规则（基线行为）' },
+          { tdd: 'Test passes (GREEN)', skillCreation: 'Agent 带技能后遵守规则' },
+          { tdd: 'Refactor', skillCreation: '堵漏洞同时保持合规' },
+          { tdd: 'Write test first', skillCreation: '写基线场景在写技能之前' },
+          { tdd: 'Watch it fail', skillCreation: '记录 Agent 用的具体合理化借口' },
+          { tdd: 'Minimal code', skillCreation: '写技能针对那些具体违规' },
+          { tdd: 'Watch it pass', skillCreation: '验证 Agent 现在合规了' },
+        ],
+      },
+
+      // ── 多平台支持 ──
+      platforms: {
+        title: '多平台支持（14+ 种 Agent）',
+        description:
+          'Superpowers 通过平台适配的 Hook 和插件安装方式支持主流编码 Agent。核心机制相同——SessionStart Hook 注入 using-superpowers 技能。',
+        items: [
+          { name: 'Claude Code', install: '/plugin install superpowers@claude-plugins-official', hook: 'hookSpecificOutput.additionalContext' },
+          { name: 'Codex CLI/App', install: '/plugins → search superpowers', hook: 'additionalContext（SDK 标准）' },
+          { name: 'Cursor', install: '/add-plugin superpowers', hook: 'additional_context（snake_case）' },
+          { name: 'OpenCode', install: 'opencode.json plugin array', hook: '原生 skill 工具 + todowrite/task 工具映射' },
+          { name: 'Gemini CLI', install: 'gemini extensions install', hook: '扩展系统' },
+          { name: 'GitHub Copilot CLI', install: 'copilot plugin install', hook: 'additionalContext' },
+          { name: 'Devin CLI', install: 'devin plugins install', hook: '插件系统' },
+          { name: 'Hermes Agent', install: 'hermes plugins install', hook: '无 post-compact hook（长会话限制）' },
+        ],
+      },
+
+      // ── 哲学 ──
+      philosophy: {
+        title: '设计哲学',
+        principles: [
+          { name: 'Test-Driven Development', desc: '先写测试，永远如此。没有失败测试就不写生产代码' },
+          { name: 'Systematic over ad-hoc', desc: '流程优于猜测。每一步都有对应技能指导' },
+          { name: 'Complexity reduction', desc: '简洁是首要目标。技能帮助减少而非增加复杂度' },
+          { name: 'Evidence over claims', desc: '验证后再宣布成功。"看起来好了"不算成功' },
+          { name: 'Skills are mandatory', desc: '技能是强制工作流，不是建议。Agent 不能合理化跳过' },
+          { name: 'Human partner', desc: '刻意使用"human partner"而非"user"——强调协作而非服务关系' },
+        ],
+      },
+    },
+
+    // ── Subagent 子模块 ──
+    {
+      id: 'subagent',
+      name: 'Subagent',
+      badge: '子 Agent',
+      tagline: '4 种流行编码 Agent 的 subagent 机制对比：prompt、输出、文件、时机、并行、生命周期',
+      description:
+        'Subagent（子 Agent）是编码 Agent 将任务委派给隔离上下文的子进程的机制。主 Agent 构造精确的 prompt 派发子 Agent，子 Agent 在隔离上下文中执行任务后返回结果。本模块对比 Superpowers、Claude Code、opencode、Codex CLI 四种工具的 subagent 实现，覆盖 6 个关键维度。',
+
+      // ── 六维度对比表 ──
+      comparison: {
+        title: '六维度对比总览',
+        rows: [
+          {
+            dimension: '1. Prompt 构造',
+            superpowers: '模板文件（implementer-prompt.md）+ 占位符（BRIEF_FILE/REPORT_FILE/任务名）',
+            claude: '.md 文件 frontmatter（name/description/tools/model）+ 正文 system prompt',
+            opencode: 'task 工具 prompt 参数 + subagent_type 选择类型 + description（3-5 词）',
+            codex: 'spawn_agent prompt + fork_turns:"none"（隔离上下文）+ agent_type 角色文件 + model + reasoning_effort',
+          },
+          {
+            dimension: '2. 输出格式',
+            superpowers: '状态码（DONE/DONE_WITH_CONCERNS/BLOCKED/NEEDS_CONTEXT）+ commit SHA + 测试摘要 + 报告文件路径（<15 行）',
+            claude: '单条消息返回主 Agent。Transcript 中显示为 tool call 行（如 code-improver(Suggest improvements)）',
+            opencode: '单条消息返回调用方。不直接对用户可见——主 Agent 需摘要转发',
+            codex: '子 Agent 最终答案推入父 Agent mailbox。父 Agent 在下一轮收到。wait_agent 是事件订阅非轮询',
+          },
+          {
+            dimension: '3. 文件机制',
+            superpowers: '工作空间目录（.superpowers/sdd/<plan>/）：ledger（progress.md）、brief 文件、report 文件。Ledger 跨 compaction 存活',
+            claude: '~/.claude/agents/（用户级）或 .claude/agents/（项目级）或 --agents CLI JSON。优先级：managed > CLI > project > user > plugin',
+            opencode: '无文件定义。内置 agent 类型（explore/general/translate）。task_id 可恢复之前的 session',
+            codex: '~/.codex/agents/ 角色文件（agent_type）。~/.codex/config.toml 配置 default_subagent_model + reasoning_effort',
+          },
+          {
+            dimension: '4. 使用时机与分工',
+            superpowers: '计划驱动：逐任务派发。主 Agent = 控制器（协调/审查/裁决），子 Agent = 实现者（编码/测试/自审）。不在任务间暂停',
+            claude: '主 Agent 判断 subagent description 相关时自动委派。也可显式请求"Use the X agent to..."',
+            opencode: '"尽可能并发启动多个 agent"。委派后不重复工作，继续非重叠任务或等待结果。明确告知是写代码还是仅调研',
+            codex: '计划驱动：逐任务 spawn。有本地工作时不等（结果在下一轮到达），真正空闲时 wait_agent（5-10 分钟）',
+          },
+          {
+            dimension: '5. 并行机制与数量',
+            superpowers: '同一条消息中多个 dispatch = 并行。用于独立问题域（不同测试文件/不同子系统）。一条 dispatch = 顺序',
+            claude: 'Task 工具支持并行派发多个 subagent。多个 subagent 可同时执行独立任务',
+            opencode: '"在单条消息中使用多个 tool 调用"= 并行。启动后不重复已委派的工作',
+            codex: 'spawn_agent 创建子 Agent。可 spawn 多个。wait_agent 等待任一完成。V2 无显式数量上限（自动驱逐空闲子 Agent）',
+          },
+          {
+            dimension: '6. 生命周期与强制关闭',
+            superpowers: '返回单条消息后结束。可被 resume（fix findings R≤3 恢复同一实现者，R≥4 换新实现者+更强模型）。最多 5 轮修复',
+            claude: '运行至完成，返回单条消息。无 resume 机制。新 session 需重新 dispatch',
+            opencode: 'Fresh context（除非 task_id 恢复）。返回单条消息。输出应被信任。task_id 可续接同一子 Agent session',
+            codex: 'V2：无 close_agent，空闲子 Agent 自动驱逐（不阻塞）。V1：有 close_agent，审查后关闭。followup_task 恢复实现者。harness 驱逐的子 Agent 透明重载',
+          },
+        ],
+      },
+
+      // ── Superpowers 示例详解 ──
+      superpowersExample: {
+        title: 'Superpowers subagent 示例详解',
+        description:
+          'Superpowers 的 subagent-driven-development 是最完整的 subagent 工作流——有模板文件、状态码契约、文件持久化、修复循环和两阶段审查。',
+        promptTemplate: `// implementer-prompt.md 模板（简化）
+Subagent (general-purpose):
+  description: "Implement Task N: [task name]"
+  model: [MODEL — 必须指定，否则继承最贵模型]
+  prompt: |
+    You are implementing Task N: [task name]
+
+    ## Task Description
+    Read your task brief first: [BRIEF_FILE]
+    It contains the full task text from the plan.
+
+    ## Context
+    [Scene-setting: where this fits, dependencies, architectural context]
+
+    ## Your Job
+    1. Implement exactly what the task specifies
+    2. Write tests (following TDD if task says to)
+    3. Verify implementation works
+    4. Commit your work
+    5. Self-review (see below)
+    6. Report back
+
+    ## You Do Not Dispatch Subagents
+    Do all work yourself. Never spawn a subagent.
+    Review is the controller's job, not yours.
+
+    ## Report Format
+    Write your full report to [REPORT_FILE]:
+    - What you implemented
+    - What you tested and test results
+    - TDD Evidence (RED + GREEN)
+    - Files changed
+    - Self-review findings
+
+    Then report back with ONLY (under 15 lines):
+    - Status: DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
+    - Commits created (short SHA + subject)
+    - One-line test summary
+    - Your concerns, if any
+    - The report file path`,
+        outputContract: `// 状态码契约
+DONE               // 任务完成，测试通过
+DONE_WITH_CONCERNS // 完成但有疑虑
+BLOCKED            // 无法完成，需要帮助
+NEEDS_CONTEXT      // 缺少上下文信息
+
+// 报告格式（<15 行，详情在报告文件中）
+Status: DONE
+Commits: a1b2c3d Implement user login
+Tests: 14/14 passing, output pristine
+Concerns: none
+Report: .superpowers/sdd/plan-login/task-3-report.md`,
+        fileMechanism: `// 工作空间目录结构
+.superpowers/sdd/<plan-name>/
+├── progress.md          # Ledger — 跨 compaction 存活的进度追踪
+│   ├── "# SDD ledger — plan: <plan file path>"
+│   ├── "Task 1: complete"
+│   ├── "Task 2: complete"
+│   └── "Task 3: fix round 2"  ← 中途状态
+├── task-1-brief.md      # 任务简报（从计划提取）
+├── task-1-report.md     # 实现者报告
+├── task-2-brief.md
+├── task-2-report.md
+├── task-3-brief.md
+├── task-3-report.md
+└── review-packages/     # 审查包
+
+// Ledger 是恢复地图：
+// compact 后主 Agent 读 ledger 知道哪些任务已完成
+// 不会重复派发已完成任务`,
+        lifecycle: `// 修复循环生命周期
+Task 开始
+  ↓
+派发 implementer subagent（fresh context）
+  ↓
+implementer 实现 + 测试 + 提交 + 自审
+  ↓
+派发 task-reviewer subagent（两阶段审查）
+  ├── 阶段 1: 规格合规（是否做了该做的）
+  └── 阶段 2: 代码质量（做得好不好）
+  ↓
+审查通过？
+  ├── 是 → 标记任务完成 → 下一个任务
+  └── 否 → 修复循环（最多 5 轮）
+      ├── R ≤ 3: resume 同一 implementer（followup_task）
+      └── R ≥ 4: 派发新 implementer + 更强模型
+          ↓
+      派发 scoped re-review（只审查修复部分）
+          ↓
+      所有 findings 解决？
+      ├── 是 → 标记任务完成
+      └── R = 5 → 裁决每个未决 finding
+          ├── 有承重 finding → 裁决并继续（仅当每条路都是猜测时才停）
+          └── 无承重 finding → 暂存到 ledger 继续`,
+      },
+
+      // ── 各工具关键差异要点 ──
+      keyDifferences: {
+        title: '关键差异要点',
+        items: [
+          { tool: 'Superpowers', point: '唯一有完整修复循环（5 轮）+ 两阶段审查 + ledger 持久化的工具。子 Agent 不允许再派子 Agent（"You Do Not Dispatch Subagents"）' },
+          { tool: 'Claude Code', point: 'subagent 通过 .md 文件定义，有 5 级优先级（managed > CLI > project > user > plugin）。支持递归子目录发现。无 resume 机制' },
+          { tool: 'opencode', point: '最简洁——无文件定义，内置 3 种 agent 类型。task_id 是唯一 resume 机制。明确要求"告知子 Agent 是写代码还是仅调研"' },
+          { tool: 'Codex CLI', point: '最复杂——spawn_agent + followup_task + wait_agent 三工具配合。V2 无 close_agent（自动驱逐），V1 有。wait_agent 是事件订阅非轮询。必须显式设置 model + reasoning_effort' },
+        ],
+      },
+
+      // ── 并行与防阻塞最佳实践 ──
+      bestPractices: {
+        title: '并行与防阻塞最佳实践',
+        items: [
+          { practice: '并行触发', detail: '在单条消息中发起多个 subagent dispatch = 并行执行。每条消息一个 dispatch = 顺序。用于独立问题域（不同文件/不同子系统）' },
+          { practice: '不重复工作', detail: '委派给 subagent 后，主 Agent 不做相同工作。继续非重叠任务或等待结果' },
+          { practice: '精确构造 prompt', detail: '子 Agent 不继承会话历史——主 Agent 必须构造完整上下文。包含：任务描述、相关代码、约束条件、期望输出格式' },
+          { practice: '状态码契约', detail: 'Superpowers 的 DONE/BLOCKED/NEEDS_CONTEXT 状态码让主 Agent 快速决策——不需要读完整报告就能决定下一步' },
+          { practice: '文件持久化', detail: 'Superpowers 的 ledger（progress.md）跨 compaction 存活——compact 后主 Agent 读 ledger 恢复进度，不重复派发已完成任务' },
+          { practice: '超时与驱逐', detail: 'Codex V2 自动驱逐空闲子 Agent（不阻塞主 Agent）。opencode 无显式超时——子 Agent 返回单条消息即结束' },
+          { practice: '不无限嵌套', detail: 'Superpowers 明确禁止子 Agent 再派子 Agent。避免递归爆炸和上下文污染' },
+          { practice: '修复用 resume 不用新建', detail: 'Codex V2 的 followup_task 透明重载被驱逐的子 Agent。Superpowers R≤3 resume 同一实现者。opencode 用 task_id 续接' },
+        ],
+      },
+    },
+  ],
+}