面向 Claude Code 和 Codex 的 AI 工程工作流。
核心定位：
superagents是工程任务主入口（先路由到最佳技能，复杂任务走多 Agent 编排）rules定义约束skills定义执行流程
前置条件：先安装 superpowers。
skills/superagents是编排层，负责 1 master + N workers 的多 Agent 协作。- 对 bug / feature / refactor / 复杂 review，默认走
superagents；单一场景可直达最佳专项技能。 - 与仓库强制路由一致：先
superpowers:using-superpowers，再选择最小技能集合执行。
直接在任务里显式触发：
[$superagents](/Users/gdc/.codex/skills/superagents/SKILL.md) <任务描述>
常见场景：
- 缺陷修复：定位根因并修复回归，附验证证据
- 功能开发：实现需求并补齐测试与评审
- 复杂重构：保持外部行为不变，分阶段迁移
最小执行流：
- 路由：
using-superpowers - 选型：最小 Superpowers 组合（debugging/TDD/review/verification）
- 执行：
research -> plan -> implement -> review -> verify -> report - 门禁：
Typecheck/Build -> Lint -> Test - 交付：Done/Partial/Skipped +
file:line/命令摘要证据
复用模板：skills/superagents/templates/universal-engineering-task-prompt.md
rules/：全局约束（质量、语言、输出、快速路径）skills/：专项工作流（superagents、fix-bug、develop-feature、refactor等）agents/：执行角色（researcher/planner/implementer/reviewer/verifier/reporter）AGENTS.md：路由、协作与交付规范CLAUDE.md：仓库级强制路由规则
SKILL.md 里的 !command 会在 skill 加载时执行，并把输出注入上下文，例如：
!`git status`
Fetch and follow instructions from https://raw.githubusercontent.com/dacheng-gao/ai/main/.claude/INSTALL.md
升级：
Fetch and follow instructions from https://raw.githubusercontent.com/dacheng-gao/ai/main/.claude/UPGRADE.md
Fetch and follow instructions from https://raw.githubusercontent.com/dacheng-gao/ai/main/.codex/INSTALL.md
升级：
Fetch and follow instructions from https://raw.githubusercontent.com/dacheng-gao/ai/main/.codex/UPGRADE.md