内容
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/banner-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="assets/banner-light.svg">
<img alt="claude-forge" src="assets/banner-dark.svg" width="800">
</picture>
<br>
<p>
<a href="https://www.npmjs.com/package/claude-forge-plugin"><img src="https://img.shields.io/npm/v/claude-forge-plugin.svg?style=flat-square&color=171717&labelColor=171717" alt="npm"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-171717.svg?style=flat-square&labelColor=171717" alt="license"></a>
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%E2%89%A518-171717.svg?style=flat-square&labelColor=171717" alt="node"></a>
</p>
---
**Claude Code** 的多CLI委托和编排。
将后端工作路由到 **Codex CLI** （GPT-5.3，128K）和前端工作路由到 **Gemini CLI** （1M上下文）。
Claude协调所有操作 — 分类任务、委托给正确的模型、验证结果。
不需要CLI。内置代理在CLI未安装时处理它们。
---
## 安装
```bash
npm install -g claude-forge-plugin
```
或作为Claude Code插件：
```bash
/plugin marketplace add https://github.com/staticpayload/claude-forge
/plugin install claude-forge
```
然后运行设置向导：
```
/claude-forge:setup
```
向导处理CLI检测、模型偏好、HUD配置和团队设置。
已经配置？它提供快速的CLAUDE.md更新而不是完整向导。
---
## 工作原理
您的提示会命中关键词路由器（100+模式）。它分类任务、评估复杂性并路由到正确的目的地。
```
prompt → keyword router → classification
├── Codex CLI （后端信号：api，server，database，auth...）
├── Gemini CLI （前端信号：component，ui，css，react...）
├── built-in agents （当CLI不可用时）
└── direct execution （简单任务）
```
复杂性评分决定模型层级： **Haiku** 用于简单工作， **Sonnet** 用于标准工作， **Opus** 用于架构。
---
## 团队
使用Claude Code原生基础设施的协调多代理团队。旗舰编排功能。
```
/claude-forge:team 4 "build the user dashboard with auth, API, components, and tests"
```
```
┌─────────────────────────────────────────┐
│ TEAM LEAD │
│ decompose → route → monitor → verify │
└──────┬──────────┬──────────┬─────────────┘
│ │ │
┌───────▼──┐ ┌────▼─────┐ ┌──▼────────┐
│ Worker 1 │ │ Worker 2 │ │ Worker 3 │
│ executor │ │ designer │ │ codex MCP │
│ (claude) │ │ (claude) │ │ (GPT-5.3) │
└───────────┘ └──────────┘ └───────────┘
```
工作者直接通信，从共享列表中认领任务，并尊重文件所有权边界。
**智能自动路由** 分类每个子任务并将其发送到最佳提供者 — Codex用于后端，Gemini用于前端，Claude代理用于其他所有情况。不需要手动路由。
### 有什么不同
| 功能 | claude-forge | 其他 |
|:--------|:-------------|:-------|
| 工作者到工作者的消息传递 | 对等 | 仅限领导 |
| 任务路由 | 自动按子任务 | 手动 |
| 动态缩放 | 提前完成者重新分配 | 固定 |
| 级联模式 | 自动创建测试 + 审查任务 | 无 |
| 跨CLI验证 | 替代模型审查工作 | 无 |
| 团队模板 | 5个预建 | 无 |
| 需要构建步骤 | 否 | 是 |
### 模板
使用预建的团队组成快速开始：
| 模板 | 工作者 | 用例 |
|:---------|:--------|:---------|
| `build-team` | 架构师 + 执行者 + 设计师 | 功能开发 |
| `review-team` | 样式 + 质量 + 安全 + 性能 | 代码审查 |
| `fullstack-team` | 架构师 + 执行者 + 设计师 + 测试工程师 | 端到端功能 |
| `audit-team` | 安全 + 质量 + 代码审查者 | 安全审计 |
| `debug-team` | 探险家 + 调试器 + 执行者 | 错误调查 |
```
/claude-forge:team fullstack-team "implement the billing system"
```
[完整团队文档 →](docs/teams.md)
---
## 群
轻量级即发即忘的并行执行。无需团队开销 — 只需创建代理并收集结果。
```
/claude-forge:swarm 5 "write unit tests for each service in src/services/"
```
群将任务分解，将每个子任务路由到最佳提供者，立即创建所有代理并报告结果。基于波的创建处理5+任务而不击中并发限制。
当任务需要协调时使用 **team**。当它们独立时使用 **swarm**。
[完整群文档 →](docs/swarm.md)
---
## 执行模式
9种模式组合使用。[完整指南 →](docs/modes.md)
| 模式 | 触发器 | 描述 |
|:-----|:--------|:------------|
| `autopilot` | "autopilot", "build me" | 全管道 — 扩展、计划、执行、QA、验证 |
| `ralph` | "ralph", "don't stop" | 持久循环 — 工作、验证、重复直到完成 |
| `ultrawork` | "ulw", "ultrawork" | 并行引擎 — 分解、分配所有权、同时运行 |
| `ecomode` | "ecomode", "budget" | 成本高效的模型路由 — Haiku/Sonnet偏好 |
| `ultraqa` | "ultraqa" | QA循环 — 测试、诊断、修复、重复 |
| `ultrapilot` | "ultrapilot" | 并行自动驾驶员，具有文件所有权分区 |
| `team` | "forge team", 模板名称 | 具有共享任务列表的协调代理 |
| `swarm` | "swarm", "fire and forget" | 即发即忘的并行执行 |
| `pipeline` | "pipeline", "chain agents" | 顺序代理链和数据传递 |
Ralph包括ultrawork。Ecomode修改任何模式。Autopilot转换为ralph或ultraqa。
---
## 技能
42+技能，涵盖8个类别。自然触发或使用 `/claude-forge:<skill>`。
### CLI委托
| 技能 | 描述 |
|:------|:------------|
| `forge` | 根据信号分类自动路由到最佳CLI |
| `backend` / `frontend` | 直接委托给Codex或Gemini |
| `backend-agent` / `frontend-agent` | CLI不可用时的内置代理 |
| `review` | 并行审查 — Codex检查逻辑，Gemini检查设计 |
| `parallel` | 将任务分解为并行波，跨两个CLI |
### 规划和研究
| 技能 | 描述 |
|:------|:------------|
| `plan` | 战略规划，采访，Consensus或审查模式 |
| `research` | 并行科学家 — 子问题，交叉验证，综合 |
### 代码质量
| 技能 | 描述 |
|:------|:------------|
| `code-review` | 5维严重性评级审查 |
| `security-review` | OWASP Top 10，秘密检测，身份验证审计 |
| `tdd` | 红绿重构强制执行 |
| `build-fix` | 构建错误最小化修复 |
### 分析
| 技能 | 描述 |
|:------|:------------|
| `analyze` | 深入调查 — 架构，错误，性能 |
| `deepsearch` | 多策略详尽代码库搜索 |
<details>
<summary>生产力，专家和配置</summary>
<br>
**生产力：** `worktree` · `techdebt` · `fix` · `learn` · `deepinit` · `note` · `learner` · `trace`
**专家：** `frontend-ui-ux` · `git-master`
**配置：** `setup` · `doctor` · `help` · `hud` · `cancel` · `set-codex-model` · `set-gemini-model` · `enable-codex` · `enable-gemini`
</details>
---
## 魔法关键词
在任何提示中自然地说出它们。它们组合使用。
| 关键词 | 效果 |
|:--------|:-------|
| `ultrawork` / `ulw` | 最大并行度 — 分解并同时运行代理 |
| `deepsearch` | 详尽搜索 — 多策略，从不停止在第一个结果 |
| `analyze` / `investigate` | 在任何操作之前收集深度上下文 |
| `ultrathink` / `think hard` | 扩展推理 — 质量优于速度 |
*"ultrawork this analysis"* 激活并行执行和深入调查。
---
## 代理
32个代理，自动模型路由。[完整目录 →](docs/agents.md)
| 车道 | 代理 |
|:-----|:-------|
| 构建 | `explorer` · `analyst` · `planner` · `architect` · `debugger` · `executor` · `deep-executor` · `verifier` |
| 审查 | `style-reviewer` · `quality-reviewer` · `api-reviewer` · `security-reviewer` · `performance-reviewer` · `code-reviewer` |
| 领域 | `dependency-expert` · `test-engineer` · `build-fixer` · `designer` · `writer` · `qa-tester` · `scientist` · `git-master` · `quality-strategist` |
| 产品 | `product-manager` · `ux-researcher` · `information-architect` · `product-analyst` |
| 协调 | `critic` · `vision` · `researcher` · `team-lead` · `team-worker` |
### 团队组成
```
Feature: analyst → planner → executor → test-engineer → quality-reviewer → verifier
Bug fix: explorer + debugger → executor → test-engineer → verifier
Review: style-reviewer + quality-reviewer + api-reviewer + security-reviewer
Full-stack: planner → [Codex: backend] + [Gemini: frontend] → test-engineer → verifier
```
---
## HUD
显示一切的双行状态栏。
```
branch:main | model:Claude Opus 4
[FORGE] | 5h:[████████]42% wk:[████░░░░]28% | cx:✓ gm:✓ | run:cx:1 done:3 | ~$0.18 | ctx:[██████░░░░]62%
```
速率限制、CLI可用性、活动作业、成本估算、上下文使用情况。使用 `/claude-forge:hud` 配置。
---
## 架构
两个MCP服务器处理CLI委托。[完整指南 →](docs/cli-delegation.md)
**forge-codex** — 通过stdin启动 `codex exec --yolo`。GPT-5.3，128K上下文。
工具： `codex_exec` · `codex_status` · `codex_cancel` · `codex_list`
**forge-gemini** — 通过stdin启动 `gemini -y`。Gemini 3 Pro，1M上下文。
工具： `gemini_exec` · `gemini_status` · `gemini_cancel` · `gemini_list`
五个生命周期钩子： `SessionStart` （CLI检测） · `UserPromptSubmit` （关键词路由） · `PreToolUse` （每个工具的提示） · `PostToolUse` （上下文监控） · `Stop` （继续执行强制）
安全性：路径验证上下文文件、系统目录黑名单、基准名仅CLI解析、抗循环三明治模式、10MB输出上限。
<details>
<summary>文件结构</summary>
```
claude-forge/
├── .claude-plugin/
│ ├── plugin.json
│ └── marketplace.json
├── agents/ 32个代理系统提示
│ ├── team-lead.md 团队协调员（opus）
│ └── team-worker.md 团队工作者（sonnet）
├── docs/ 功能文档
│ ├── teams.md
│ ├── swarm.md
│ ├── modes.md
│ ├── agents.md
│ └── cli-delegation.md
├── hooks/hooks.json 5个生命周期钩子
├── hud/
│ ├── forge-hud.mjs 状态栏渲染器
│ └── usage-api.mjs Anthropic 使用 API
├── scripts/
│ ├── keyword-router.mjs 100+正则表达式模式
│ ├── session-init.mjs CLI检测
│ ├── context-monitor.mjs 令牌跟踪
│ ├── pre-tool-enforcer.mjs
│ ├── continuation.mjs 退出预防
│ └── lib/ 路由、关键词、复杂度
├── servers/
│ ├── codex-server.mjs Codex MCP服务器
│ └── gemini-server.mjs Gemini MCP服务器
├── skills/ 42+技能定义
│ ├── team/SKILL.md 1600行 — 团队编排
│ ├── swarm/SKILL.md 即发即忘的并行
│ └── ...
└── templates/CLAUDE.md 注入指令
```
</details>
---
## 文档
| 指南 | 描述 |
|:------|:------------|
| [团队](docs/teams.md) | 协调多代理团队 — 模板、生命周期、智能路由、级联 |
| [群](docs/swarm.md) | 即发即忘的并行执行 — 波浪式创建、路由 |
| [执行模式](docs/modes.md) | 所有9种模式 — 自动驾驶、拉尔夫、ultrawork、团队等 |
| [代理](docs/agents.md) | 32个代理的完整目录 — 模型、功能、组成 |
| [CLI委托](docs/cli-delegation.md) | Codex和Gemini集成 — 路由、MCP工具、回退 |
---
## 示例
```
autopilot: Build user auth with JWT, password hashing, rate limiting, and email verification
```
```
forge team fullstack-team: Implement the entire checkout flow with Stripe integration
```
```
swarm 5: Write comprehensive tests for every module in src/services/
```
```
ultrawork: Migrate the entire codebase from CommonJS to ESM
```
```
forge review the authentication PR
```
```
ecomode: Add form validation to the signup page
```
---
## 故障排除
**Codex CLI未找到** — `npm install -g @openai/codex` 然后 `/claude-forge:enable-codex`
**Gemini CLI未找到** — `npm install -g @google/gemini-cli` 然后 `/claude-forge:enable-gemini`
**技能未出现** — 运行 `/claude-forge:doctor` 进行7个诊断检查并自动修复
**取消卡住的模式** — `/claude-forge:cancel --force`
---
## 贡献
纯ESM JavaScript，无构建步骤。添加技能，创建 `skills/<name>/SKILL.md`，将触发模式添加到 `keyword-router.mjs`，并更新 `templates/CLAUDE.md`。
---
<sub>[GPL-3.0](LICENSE) · [GitHub](https://github.com/staticpayload/claude-forge) · [npm](https://www.npmjs.com/package/claude-forge-plugin) · [问题](https://github.com/staticpayload/claude-forge/issues)</sub>
