ywcrew

KO | EN

gitlite — search

#ai #golang #android #machine-learning #rust #linux #docker #macos #kubernetes #vue #security #mcp #openai #open-source

(★ 37)

让你的 AI 智能体们组成一个团队：在任意宿主里把任务派给本地订阅的 Claude Code / Codex / Grok / Kimi / Antigravity，并行、不打断对话、全走已有订阅。

ywcrew Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ywcrew

**让你的 AI 智能体们组成一个团队**

你本地订阅了 Claude Code、Codex、Grok、Kimi、Antigravity……<br>
ywcrew 让它们互相调用：在任何一个智能体里说句话，就能把任务派给其他家的模型。

[![license](https://img.shields.io/badge/license-MIT-blue)](https://raw.githubusercontent.com/yuwen-cool/ywcrew/main/LICENSE)
[![node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
[![tests](https://img.shields.io/badge/tests-47%20passing-brightgreen)](https://raw.githubusercontent.com/yuwen-cool/ywcrew/main/test)
[![lang](https://img.shields.io/badge/文档-中文-red)](https://raw.githubusercontent.com/yuwen-cool/ywcrew/main/)

</div>

---

## 30 秒理解

装好之后，在 Cursor / Claude Code / Codex / Grok / Kimi 任意一个里，直接说：

| 你说 | 发生了什么 |
| --- | --- |
| "让 GPT 用最高思考强度查一下这个死锁" | 当前智能体把任务派给 Codex，后台执行，回来一份带证据的结论 |
| "开个评审会，对比一下这两个方案" | Claude、Codex、Kimi 并行各出一份评审，当前智能体汇总共识与分歧 |
| "让 kimi 接着刚才的结论继续深挖" | 跨轮追问，同后端原生续聊，KV 缓存零重建 |
| "让 claude 和 codex 各改一版，选好的" | 两家各自在隔离的 git worktree 里改代码，以 patch 交付，你挑一个 |

**三个关键保证：**

- **不烧 API key** —— 所有调用走你已付费的订阅（各家自己的 CLI 登录态）
- **不打断当前对话** —— 被调模型在独立进程里跑，主对话的缓存零污染
- **不碰你的代码** —— 只读任务有权限约束，改代码任务在隔离副本中进行、以 patch 交付

## 安装

**把仓库名发给你的智能体**（推荐），对任意 agent 说：

> 帮我安装 github.com/yuwen-cool/ywcrew：运行 `curl -fsSL https://raw.githubusercontent.com/yuwen-cool/ywcrew/main/install.sh | bash`，装完把上手指引转告我。

或者自己在终端跑同一条命令：

```bash
curl -fsSL https://raw.githubusercontent.com/yuwen-cool/ywcrew/main/install.sh | bash
```

装完屏幕上会直接给出上手指引（对智能体说什么、怎么自查）。想逐项确认配置的话，再跑一次交互式 `ywcrew init`。

- 唯一前置要求：Node ≥ 20（脚本会检查并提示）
- **不需要注册任何账号**：直接从本仓库下载，构建产物已随仓库提供
- 升级：重跑同一条安装命令；`~/.ywcrew` 下的配置与偏好不受影响
- 锁定版本：`YWCREW_VERSION=v0.1.0 bash install.sh`（默认跟随 main 最新）

## 工作原理

```mermaid
sequenceDiagram
    participant U as 你
    participant H as 宿主智能体<br>(Cursor / Claude Code / …)
    participant Y as ywcrew CLI
    participant W as detached worker
    participant B as 被调后端<br>(claude / codex / grok / kimi / agy)

U->>H: "让 GPT 看看这个 bug"
    H->>Y: ywcrew run（任务 JSON + 文件白名单）
    Y-->>H: 立即返回 runId（不阻塞）
    Y->>W: 派生独立进程
    W->>B: 组装自包含上下文，headless 调用
    Note over H: 继续干手头的活
    B-->>W: 执行完成
    H->>Y: ywcrew result --wait
    Y-->>H: 结构化结论（summary / evidence / patch）
    H-->>U: 汇总后的答案 + 可接管的会话命令
```

宿主智能体靠一份**按你的真实配置动态渲染的技能文件**学会这一切：里面只出现你实际启用的后端、你的默认模型、你自定义的路由偏好——它不会被引导去调一个你没有的模型。

回来的结论长这样（真实运行输出节选）：

```json
{
  "status": "ok",
  "summary": "发现 1 个 P0：PID 复用后 kill 会误杀无关进程组……",
  "evidence": [{ "file": "src/core/lock.ts", "lines": "46-58", "claim": "…" }],
  "confidence": "high",
  "usage": { "inputTokens": 525103, "outputTokens": 14624, "durationMs": 338466 },
  "takeover_command": "cd \"/path/to/proj\" && codex resume 019fa79b-…"
}
```

`takeover_command` 可以直接复制到终端，亲自接管子智能体的会话继续深聊。

## 支持的后端

| 后端 | 命令 | 思考强度 | 原生续聊 | 只读机制 |
| --- | --- | :-: | :-: | --- |
| Claude Code | `claude` | – | 支持 | `--permission-mode plan` |
| Codex | `codex` | 支持 | 支持 | `--sandbox read-only`（原生沙箱） |
| Grok | `grok` | 支持 | 支持 | `--permission-mode plan` |
| Kimi Code | `kimi` | – | 支持 | worktree 隔离（无原生只读档） |
| Antigravity | `agy` | 支持 | 支持 | `--mode plan` |

计划中的后端（opencode / droid / cursor-agent / 浏览器通道）见 [`docs/roadmap.md`](./docs/roadmap.md)。

## 命令速查

| 命令 | 作用 |
| --- | --- |
| `ywcrew run --stdin` | 派单个任务（任务 JSON，`ywcrew template` 看模板） |
| `ywcrew panel --stdin` | 同一任务并行发给多个模型（评审会；成员不可用自动降级） |
| `ywcrew followup <threadId> "…"` | 跨轮追问；`--backend` 换模型自动重建历史 |
| `ywcrew status / result <runId>` | 查状态 / 取结论（`result --wait` 阻塞等待多个 run） |
| `ywcrew route list/add/clear` | 查看/自定义任务路由偏好（写进各宿主技能） |
| `ywcrew doctor` | 体检：后端安装、登录态、宿主技能装载 |
| `ywcrew backends` | 列出可用后端与模型 |
| `ywcrew refresh` | 重新探测后端与模型清单，重渲染宿主技能 |
| `ywcrew install` | 把技能分发到各宿主的 skills 目录 |
| `ywcrew gc` | 清理超龄任务记录、worktree 与不活跃线程 |
| `ywcrew mcp` | 以 MCP stdio server 方式运行（可选接入方式） |

## 常见问题

**为什么不直接在主对话里切换模型？**
切模型会把当前对话的 KV 缓存整个打掉重建，又慢又贵。ywcrew 把被调模型放进独立进程，主对话缓存零污染，回来的只有结论。

**被调的模型能看到我的整个项目吗？**
默认模式下，注入的上下文严格限于你圈定的文件白名单（secret guard 拦截凭据文件、路径逃逸、密钥特征），但被调模型运行在项目目录中，理论上可自行读取其他文件（各家的权限档是行为约束）。**敏感仓库请加 `"strict": true`**：任务会在只含白名单文件的影子目录中执行，被调模型物理上读不到项目的其他任何文件。

**模型返回的结论可信吗？**
每条 evidence（文件 + 行号）都由 worker 自动核验并标记 `verified`——文件不存在或行号越界会被如实标出。结论本身仍是建议性的，宿主智能体会对照代码库复核后再采纳。

**改代码的任务安全吗？**
edit 任务永远在隔离的 git worktree 里进行（你未提交的改动也会同步进去，保证它看到的是当前真实代码），产出以 patch 文件交付，绝不直接改你的仓库。

**任务跑一半我关掉编辑器会怎样？**
没影响。worker 是 detached 进程，状态全部落盘在 `~/.ywcrew`，随时回来 `ywcrew result <runId>` 取结论。

**多个任务同时跑会打架吗？**
有跨进程并发控制（每后端 + 全局双层槽位锁），排队自动进行；僵死任务有心跳检测和惰性回收。

## 设计要点

<details>
<summary>展开查看架构决策</summary>

- **CLI-first + 技能分发**：所有宿主都有 shell；技能文件按用户真实配置动态渲染，MCP 只是可选通道
- **任务五段式模板**：briefing / locations / objective / constraints / output_contract——被调模型对项目零知识，上下文质量决定结果质量；提示词层同时声明 agentic 环境与读写边界
- **无 daemon**：detached worker + 磁盘状态 + mkdir 原子锁（带初始化宽限与归属校验）+ 心跳惰性回收，宿主进程退出不影响任务
- **续聊双通道**：同后端原生 session resume（KV 缓存零重建）；跨后端按时间正序重建历史（预算封顶，旧轮折叠）
- **失败当场报**：未安装/未登录的后端、不存在的目录、零匹配的 glob、占位符模型名——全部在派单时拦截并给出下一步动作
- **多模型互审出厂**：发布前由 GPT 5.6 与 Kimi 各自完成一轮代码评审（就是用 ywcrew 自己派的单），P0/P1 全部修复

</details>

## 开发

```bash
npm install && npm run build   # tsup 打包到 dist/（dist 随仓库提交，改完 src 记得重新 build）
npm test                       # vitest 单测
npm run typecheck
```

## License

[MIT](./LICENSE)

ywcrew

ywcrew Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ywcrew

ywcrew Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README