# @crafts69guy/orchestra 中文文档

规范地址：https://npmcn.com/package/%40crafts69guy/orchestra/

版本：0\.17\.0
npm 元数据更新时间：2026-10-26T14:20:55.111Z
中文译文更新时间：2026-11-11T00:08:03.035Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40crafts69guy/orchestra
原文对照：https://npmcn.com/package/%40crafts69guy/orchestra/?lang=original
项目主页：https://github.com/crafts69guy/orchestra
源码仓库：https://github.com/crafts69guy/orchestra

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：183 kB，43 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.8
- 运行依赖：0 个
- 首次发布：2026-10-12T04:13:28.213Z
- 最新版本发布：2026-10-26T14:20:54.907Z
- 近 30 天下载量：2433（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

Cross-harness( Claude Code + Codex) 管弦工作流程插件

## 安装

```sh
npm install @crafts69guy/orchestra
```

也可以使用：`pnpm add @crafts69guy/orchestra`、`yarn add @crafts69guy/orchestra`、`bun add @crafts69guy/orchestra`

## README

# 管弦乐团

[![npm](https://img.shields.io/npm/v/@crafts69guy/orchestra)](https://www.npmjs.com/package/@crafts69guy/orchestra) [![ci](https://github.com/crafts69guy/orchestra/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/crafts69guy/orchestra/actions/workflows/ci.yml) [![coverage](https://img.shields.io/badge/coverage-%E2%89%A598%25-brightgreen)](https://npmcn.com/package/%40crafts69guy/orchestra/AGENTS.md#coverage-rule)

管弦乐( 插名) `orc`)是克勞德·克勞德·克勞德(Claude Code)和克勞德·克勞德·克勞德·克勞德·克勞德(Claude C. C. C. C. C. C. C. C. C. C. C. C. C 密码 一个主要特工范围、代表、审查和船只通过4个专业副特工开展工作 (单位:千美元)`scoper`, (中文(简体) ), `implementer`, (中文(简体) ), `reviewer`, (中文(简体) ), `shipper`),在并行 git 中运行独立任务 工作树.

规则总是执行的,但选入:仅在会话开始时才注入 `ORC=1`。 。 。 .

## 建筑

```mermaid
flowchart LR
  user([Developer]) -->|"orc claude / orc codex<br/>(ORC=1)"| ss
  subgraph plugin["orc plugin"]
    ss["SessionStart hook<br/>rules + lessons"]
    guard["PreToolUse guard<br/>push / PR only from shipper"]
    gate["SubagentStop gate<br/>implementer must report Validation"]
  end
  ss --> orc["Orchestrator<br/>(main thread)"]
  orc -->|"unfamiliar code"| scoper["scoper<br/>read-only brief"]
  orc -->|"one task"| impl["implementer<br/>feature branch"]
  orc -->|"plan skill"| plan[(".scratch/FEATURE/plan.md")]
  plan -->|"dispatch skill"| wts["implementers<br/>one git worktree each (wt)"]
  impl & wts --> review["orchestrator review<br/>+ reviewer when risky"]
  review -->|"user asks to ship"| shipper["shipper<br/>commit · push · PR"]
  review -->|"Capture"| reflect["reflect skill<br/>log.md → lesson deltas"]
  reflect -->|"user approves rows"| lessons[(".orc/lessons.md")]
  lessons -->|"next session"| ss
  guard -.->|"enforces"| impl & wts & shipper
  gate -.->|"enforces"| impl & wts
  guard & gate -.->|"signals"| reflect
```

-   **一个来源,两个绳子.** 规则、代理和技能是Markdown; 一套节点钩 服务克洛德代码和代码。 代码代理生成 TOML,以及 `orc codex` 注入同样的 上下文的钩子.
-   **柔软规则,硬钩.** 这些规则决定范围、授权、计划和发出的时间 钩子执行 少数的事情是绝对不能出错的.
-   **只在支付时才平行.** `dispatch` 仅运行 2+ 独立、实质性任务 工作树; 小树被分批为一个执行者 (单位:千美元)[ADR-0006 (韩语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0006-dispatch-threshold.md)) (中文(简体) ).
-   **学习每回波.** 核准的经验教训反馈给以后的届会;关于半兽人的经验教训 本身只成为规则编辑的后方 (单位:千美元)[ADR-0013 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0013-self-improvement-loop.md)) (中文(简体) ).
-   **可选融合:** 墨水特征注释, Cocoindex-code 语义搜索, herdr pane 工人们.

细节 : [文献/档案](https://npmcn.com/package/%40crafts69guy/orchestra/docs/ARCHITECTURE.md)。 。 。 .

## 所需资源

-   节点(Node.js 22.8或更新)(hoks和CLI是平地节点脚本,零运行时间依赖).
-   [工作运行](https://worktrunk.dev/) (单位:千美元)`brew install worktrunk`用于平行发送。 这个 会话勾钩警告何时 `wt` 缺少.
-   克劳德代码和/或代码.
-   可选 : [cocoindex-代码](https://github.com/cocoindex-io/cocoindex-code) (单位:千美元)`uv tool install 'cocoindex-code[full]'`(中文(简体) ) 用于语义代码搜索. 兽人从来不安装它.
-   克劳德代码: `ponytail` 插件被宣布为依赖 。 首先添加其市场: `/plugin marketplace add DietrichGebert/ponytail`。 。 。 .

## 安装

安装 `orc` CLI,然后让它检查其他一切:

```sh
npm i -g @crafts69guy/orchestra
orc doctor
```

`orc doctor` 打印每检查一行,每行有固定提示,如果有,则退出1行 需要检查失败。 安装您的套接字 :

克劳德代码 :

```text
/plugin marketplace add crafts69guy/orchestra
/plugin install orc@orchestra
```

代码 :

```sh
codex plugin marketplace add crafts69guy/orchestra
codex plugin add orc@orchestra
```

## 使用量

| 命令 | 对 |
| --- | --- |
| `orc doctor [--json]` | 检查节点,git, `wt`,带带的 CLI 和已安装的插件 |
| `orc status [--json]` | 每个计划任务1行`.scratch/<feature>/plan.md`及其工作树、花岗岩剂状态和报告状态 |
| `orc inkdrop init|inbox|claim|push|pull|lessons ...` | 将特性映射到墨滴笔记中, 将教训映射到自己的笔记中( 墨滴, 下面) |
| `orc context [--scope user|project|all] [--json]` | 审计Claude Code和Codex在上下文(记忆、技能、代理、插件、MCP):符号估计和结果 |
| `orc claude [--yolo] [--level high] [--panes|--pair] [--wt <branch> [--base <ref>]] [args...]` | 开始 `claude` 与 `ORC=1` 财务报告和审定财务报表 `--model opus` (除非你通过) `--model`(中文(简体) ) |
| `orc codex [--yolo] [--wt <branch> [--base <ref>]] [args...]` | 开始 `codex` 与 `ORC=1` 和管弦乐背景(下文) |
| `orc update` | 更新 npm CLI,然后是每个带的插件 `orchestra` 市场`claude plugin update orc@orchestra`, (中文(简体) ), `codex plugin marketplace upgrade orchestra`; 跳过 npm 从 git 取出 |
| `orc ccc init [--force]` | 此重播索引 `ccc` 语义搜索( 在200个文件中需要重取) `--force`(中文(简体) ) |
| `orc wt new|merge|remove|list ...` | 工作树帮助工具 `dispatch` 技术(`remove` 放弃任务: 工作树和分支; 打印 JSON |
| `orc wt session <branch> [--base <ref>] [--yes]` | 创建或再利用会话工作树 `<branch>` (单位:千美元)`--base` 仅适用于新分支; 打印 `{branch, path, action}` |
| `orc pane start <F> <T> --path <wt> --brief <file> [--here]`, (中文(简体) ), `wait|prompt|close <T> --path <wt> ...` | 草地上的工人 `dispatch` 技能(平面模式,下方)或对面模式(平面模式)`--here`; 打印 JSON 数据 |
| `orc eval [args...]` | 行为 evals; 仅来自 git 退出(参见 [一般事务人员(其他职等)](https://npmcn.com/package/%40crafts69guy/orchestra/AGENTS.md)(中文(简体) ) |
| `orc completion fish` | 打印一条鱼的完成脚本 : `orc completion fish > ~/.config/fish/completions/orc.fish` |
| `orc --help`, (中文(简体) ), `orc --version` | 使用和版本 |

`orc status --json`, (中文(简体) ), `orc doctor --json` 财务报告和审定财务报表 `orc context --json` 是一个版本合同 (单位:千美元)`schemaVersion`外部客户端,例如Raycast扩展;见 [ADR-0010 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0010-json-contract-for-external-clients.md)。 。 。 .

`--yolo` 关闭该运行的许可提示( n)`--dangerously-skip-permissions` 克劳德, `--dangerously-bypass-approvals-and-sandbox` (《法典》)。 没有它,绳子就正常了 权限模式。 其他的论据也传递到机身上,它的出局代码也是如此.

`orc claude` 只设定 `ORC=1`· ; `ORC=1 claude` 还行 无 `ORC=1` 钩子退出 默而会之而无事.

交接简报 `implementer` 包括Docs/JSDoc接受标准(新出口或已改变的出口) 携带JSDoc,触摸到的docs更新. `ORC_DOCS=0` 关闭它; 任何其他值保持它.

何时 `ccc` 开始 `PATH` 和repo的基特根被索引(`orc ccc init`, (中文(简体) ), `orc claude` 财务报告和审定财务报表 `orc codex` 添加 `cocoindex-code` 运行的MCP服务器. `ORC_CCC=0` 关闭; 其它 价值保持它。 重新编制索引的会中需要重启 .

`orc claude --level high` (或 `ORC_LEVEL=high`) 提高该会话的亚剂型号,克洛德 只有代码 : `implementer` 运行在opus, `scoper` 财务报告和审定财务报表 `shipper` 在诗歌上, `reviewer` 不变,而且 管弦乐师的模特儿也一样. `--level default` (或无旗)保持特工自己的型号.

`orc claude --panes` (或 `ORC_PANES=1`当会话在内部运行时打开窗格模式 [医生](https://herdr.dev/) (单位:千美元)`HERDR_ENV=1`: `dispatch` 每个执行者运行为真实 `claude` 或者说 `codex` 在草丛中 `orc:<feature>` 选项卡,在工作树内,你可以观看 并步入每一个。 工人向 `<worktree>/.orc/report.md` (图表除外). 在草地外的旗帜没有效果. 见 [ADR-0009 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0009-herdr-pane-workers.md)。 。 。 .

`orc claude --pair` (或 `ORC_PAIR=1`)在herdr内部打开对模式:每个执行者 任务以编码会话的形式运行,在向管弦乐手右侧分割的窗格中,标记为 `orc:<task>`中,在同一检查中,一次一个任务。 管弦乐师审查diff,关闭 窗帘和船通过 `shipper` 和往常一样; Codex sandbox 防止工人犯罪. 它不能与 `--panes`。见 [AR-0014 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0014-pair-panes.md)。 。 。 .

每一次检查都进行一个管弦乐会议. `orc claude --wt <branch>` (或 `orc codex --wt <branch>`开始会话在自己的会话工作树上进行,工作树由 `orc wt session` 从 `--base` 当分支是新分支时, 在您工作运行模板给出的路径上( 默认情况下是兄弟姐妹) `<repo>.<branch>`) (中文(简体) ). 计划留在主检查室 `.scratch/`当会话开始于 检查另一个草药代理在工作 或(在外)已经没有承诺 变化时,上下文警告它不要触摸它们,要孤立自己. 见 [ADR-0012 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0012-session-worktrees.md)。 。 。 .

半兽人每学一次 当一个功能完成后 `reflect` 技术建议对主要 退职 `.orc/lessons.md` (git被排除在外),如新课或对旧课投票,以及 只应用您批准的行。 以后的每届,关于克洛德代码和Codex, 得到40 规则之后的成绩最好 关于半兽人本身的教训可以推广到其规则中,但 只在第一个失败的新 eval 案件后面。 见 [ADR-0013 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0013-self-improvement-loop.md)。 。 。 .

## 墨水滴

可选: 共享每个特性 [墨水滴](https://www.inkdrop.app/) 当作一个音符。 打开 本地服务器( 首选 ~ 本地服务器) , 并导出相同的变量 Irkdrop MCP 服务器 用户。 在鱼身上,把它们放进一个没有跟踪的文件,比如: `~/.config/fish/conf.d/inkdrop.local.fish`数字 :

```fish
set -gx INKDROP_LOCAL_SERVER_URL http://localhost:19840   # optional; loopback hosts only
set -gx INKDROP_LOCAL_USERNAME <username>
set -gx INKDROP_LOCAL_PASSWORD <password>
```

别用 `set -U` 如果您的点文件跟踪 `fish_variables`: 密码最终会出现在 复发. 然后将 repo 映射到笔记本上( 默认: repo 目录名称, 匹配) 对案件不敏感; `--create` 创造出 `orc` 标签 :

```sh
orc inkdrop init [--book <name>] [--parent <name>] [--create] [--move]
```

与 `--parent Orc` (或 `git config --global orc.inkdropParent Orc` (每回一次) repo的笔记本是根笔记的子笔记本 `Orc`,比如说. `Orc/orchestra`,而不是 本身的根笔记。 重运行 `init` 在地图上的重映画它; `--move` 移动这个 repo的笔记在旧笔记本上随行(其课,相联的特征笔记和无声谱). 无 `--move`,它拒绝重新映射 当这些笔记留下。 搜索时使用笔记本标识,所以 在"墨滴"中重命名笔记本是安全的.

五行,每行由管弦乐手驱动,一旦会话上下文将笔记命名为:

-   **收件箱 :** 写入标记的便条 `orc` 有状态 `active`· ; `orc inkdrop inbox` 列出它和 `orc inkdrop claim <note-id> <feature>` 把它变成请求.
-   **镜像 :** `orc inkdrop push <feature>` 写一个管理区块(决定,每个任务一个复选框, 文本下方,并 `orc wt merge` 再推一脚. `orc inkdrop pull <feature>` 报告您是否编辑了 .
-   **抓取 :** `orc inkdrop push <feature> --done` 添加 `.scratch/<feature>/log.md` 标记 笔记完成.
-   **回顾:** 与相接的墨滴 MCP 服务器、管弦器和 `scoper` 搜索 范围界定前的笔记本.
-   **经验教训:** `orc inkdrop lessons` 将每个活动课程写入 `.orc/lessons.md` 给它自己的 标签 `orc-lesson` 并标记已删除的 `dropped`,所以请记住从其他 重现.

oRC只重写自己的块,绝不删除. 标记被损坏的纸条(一个 未终止起止, 有两块) 被拒绝, 从未猜到: 在 Inktrop 中固定它 . `orc doctor` 检查服务器. `ORC_INKDROP=0` 关闭集成( 没有规则行, 没有笔记本) 上下文,后不按键 `orc wt merge`; 合并仍为 `orc status`; 任何其他 价值保持它。 见 [ADR-0011 (英语)](https://npmcn.com/package/%40crafts69guy/orchestra/docs/adr/0011-inkdrop-feature-note.md)。 。 。 .

验证一次, 运行墨水滴 :

1.  `orc doctor` 显示 `✓ inkdrop` 还有笔记本.
2.  `orc inkdrop claim <note-id> demo`,则 `orc inkdrop push demo`。 。 。 .
3.  编辑墨水滴中的光谱; `orc inkdrop pull demo` 显示 `changed: yes`。 。 。 .
4.  墨水滴预览隐藏 `<!-- orc:begin -->` 财务报告和审定财务报表 `<!-- orc:end -->` 标记.

## 代码

Codex 默认不信任工程代理或插件钩, 所以 `orc codex` 运行 `codex` 与 `ORC=1` 和预支,每跑和不碰 `~/.codex`数字 :

-   `-c developer_instructions=...`: 与SessionStart 钩子注入的上下文相同(规则 绝对路径 `orc`, (中文(简体) ), `wt` )),",",",".
-   `-c agents.<name>.config_file=...` 财务报告和审定财务报表 `.description=...` 每个 `codex/agents/*.toml`。 。 。 .
-   `--add-dir <git common dir>` 因为.. `workspace-write` 块 `.git` 财务报告和审定财务报表 工作树和承诺需要它.

如果规则文件缺失,则退出1;如果规则文件缺失,则退出127 `codex` 还没上 `PATH`。 。 。 .

## 文档

-   [建筑](https://npmcn.com/package/%40crafts69guy/orchestra/docs/ARCHITECTURE.md)
-   [研究说明](https://npmcn.com/package/%40crafts69guy/orchestra/docs/research/)
-   [贡献和演示命令](https://npmcn.com/package/%40crafts69guy/orchestra/AGENTS.md)

## 许可证

麻省理工学院

## 常见问题

### @crafts69guy/orchestra 是什么？

Cross-harness\( Claude Code \+ Codex\) 管弦工作流程插件

### 如何安装 @crafts69guy/orchestra？

在项目目录运行 npm install @crafts69guy/orchestra，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 orc，可以用 npx orc 直接运行。

### @crafts69guy/orchestra 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/crafts69guy\_\_orchestra 是否存在。

### @crafts69guy/orchestra 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @crafts69guy/orchestra 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.8。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @crafts69guy/orchestra 可以商用吗？

@crafts69guy/orchestra 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @crafts69guy/orchestra 的下载量有多少？

根据 npm 官方下载统计，@crafts69guy/orchestra 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,433 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @crafts69guy/orchestra 还在维护吗？

最新版本 0\.17\.0 发布于 2026/10/26（15 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/10/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。