<p align="center"> <img src="assets/teamwork-readme-onboarding-zh-v3.png" alt="Teamwork 卡通双路径：清楚就直接做，需要方法再使用协作、调研、探索、排错、计划、复查、目标、初始化和更新 9 个 skills，最后验证完成" width="760"> </p>

<h1 align="center">Teamwork</h1>

<p align="center"> <strong>让 Codex、Cursor 和 Claude Code 在该直接做时直接做，在需要方法时调用方法。</strong><br> Teamwork 提供 9 个按需使用的 skills，覆盖讨论收敛、外部调研、本地证据、未知失败排查、计划、复查、持续目标、项目初始化和全局更新。 </p>

<p align="center"> <a href="https://github.com/JinPLu/Teamwork/releases"><img src="https://img.shields.io/github/v/release/JinPLu/Teamwork?display_name=tag&amp;sort=semver" alt="最新 Release"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2563EB" alt="MIT License"></a> <img src="https://img.shields.io/badge/platforms-Codex%20%C2%B7%20Cursor%20%C2%B7%20Claude%20Code-0F766E" alt="支持 Codex、Cursor 和 Claude Code"> </p>

<p align="center"> <a href="README.en.md">English</a> · <a href="CHANGELOG.md">更新日志</a> · <a href="CODEX.md">Codex</a> · <a href="CURSOR.md">Cursor</a> · <a href="CLAUDE.md">Claude Code</a> </p>

---

> [!TIP] > **不需要先背会 9 个 skills。** 大多数时候直接描述结果；只有想精确控制工作方式时，才显式写出 `$teamwork-*` 名称。

## 🚀 一分钟开始

### Codex：推荐使用 Marketplace plugin

```bash codex plugin marketplace add JinPLu/Teamwork codex plugin add teamwork-skill@teamwork ```

开启一个新的 Codex 任务，运行：

```text $teamwork-update ```

首次运行会询问 `performance-first` 或 `cost-first`，并分别确认是否启用受管 CodeGraph 和本地 GPU Broker。无论是否启用这两项可选增强，skills、agents、 路由、全局策略和通知等基础流程都会完整执行；已保存的选择会在后续更新中继承。 配置完成后重启 Codex；如果启用了通知，请在 `/hooks` 中分别信任 Teamwork 的 `Stop` 和 `PermissionRequest`，不要使用 trust-all。

如果希望某个仓库拥有项目说明、Teamwork memory 和 CodeGraph 上下文，请在该仓库中运行：

```text 用 $teamwork-init 初始化这个项目。 ```

现在可以直接开始。例如：

```text 直接实现这个校验改动，验证受影响路径，成功后停止。 ```

这类目标清楚的本地工作不需要任何 Teamwork skill。想先讨论方向时，可以说：

```text 用 $teamwork-collaborate 和我一起梳理 onboarding，先给建议，再问最有价值的问题。 ```

<details> <summary><strong>Cursor、Claude Code 或开发 checkout</strong></summary>

```bash git clone https://github.com/JinPLu/Teamwork.git cd Teamwork ./install.s