管弦乐团
管弦乐( 插名) 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。 。 。 .
建筑
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 (韩语)) (中文(简体) ). - 学习每回波. 核准的经验教训反馈给以后的届会;关于半兽人的经验教训 本身只成为规则编辑的后方 (单位:千美元)ADR-0013 (英语)) (中文(简体) ).
- 可选融合: 墨水特征注释, Cocoindex-code 语义搜索, herdr pane 工人们.
细节 : 文献/档案。 。 。 .
所需资源
- 节点(Node.js 22.8或更新)(hoks和CLI是平地节点脚本,零运行时间依赖).
- 工作运行 (单位:千美元)
brew install worktrunk用于平行发送。 这个 会话勾钩警告何时wt缺少. - 克劳德代码和/或代码.
- 可选 : cocoindex-代码 (单位:千美元)
uv tool install 'cocoindex-code[full]'(中文(简体) ) 用于语义代码搜索. 兽人从来不安装它. - 克劳德代码:
ponytail插件被宣布为依赖 。 首先添加其市场:/plugin marketplace add DietrichGebert/ponytail。 。 。 .
安装
安装 orc CLI,然后让它检查其他一切:
npm i -g @crafts69guy/orchestra
orc doctor
orc doctor 打印每检查一行,每行有固定提示,如果有,则退出1行
需要检查失败。 安装您的套接字 :
克劳德代码 :
/plugin marketplace add crafts69guy/orchestra
/plugin install orc@orchestra
代码 :
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 退出(参见 一般事务人员(其他职等)(中文(简体) ) |
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 (英语)。 。 。 .
--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当会话在内部运行时打开窗格模式
医生 (单位:千美元)HERDR_ENV=1: dispatch 每个执行者运行为真实 claude 或者说
codex 在草丛中 orc:<feature> 选项卡,在工作树内,你可以观看
并步入每一个。 工人向 <worktree>/.orc/report.md (图表除外).
在草地外的旗帜没有效果. 见 ADR-0009 (英语)。 。 。 .
orc claude --pair (或 ORC_PAIR=1)在herdr内部打开对模式:每个执行者
任务以编码会话的形式运行,在向管弦乐手右侧分割的窗格中,标记为
orc:<task>中,在同一检查中,一次一个任务。 管弦乐师审查diff,关闭
窗帘和船通过 shipper 和往常一样; Codex sandbox 防止工人犯罪.
它不能与 --panes。见 AR-0014 (英语)。 。 。 .
每一次检查都进行一个管弦乐会议. orc claude --wt <branch> (或 orc codex --wt <branch>开始会话在自己的会话工作树上进行,工作树由 orc wt session 从
--base 当分支是新分支时, 在您工作运行模板给出的路径上( 默认情况下是兄弟姐妹)
<repo>.<branch>) (中文(简体) ). 计划留在主检查室 .scratch/当会话开始于
检查另一个草药代理在工作 或(在外)已经没有承诺
变化时,上下文警告它不要触摸它们,要孤立自己. 见
ADR-0012 (英语)。 。 。 .
半兽人每学一次 当一个功能完成后 reflect 技术建议对主要
退职 .orc/lessons.md (git被排除在外),如新课或对旧课投票,以及
只应用您批准的行。 以后的每届,关于克洛德代码和Codex, 得到40
规则之后的成绩最好 关于半兽人本身的教训可以推广到其规则中,但
只在第一个失败的新 eval 案件后面。 见
ADR-0013 (英语)。 。 。 .
墨水滴
可选: 共享每个特性 墨水滴 当作一个音符。 打开
本地服务器( 首选 ~ 本地服务器) , 并导出相同的变量 Irkdrop MCP 服务器
用户。 在鱼身上,把它们放进一个没有跟踪的文件,比如: ~/.config/fish/conf.d/inkdrop.local.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 标签 :
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 (英语)。 。 。 .
验证一次, 运行墨水滴 :
orc doctor显示✓ inkdrop还有笔记本.orc inkdrop claim <note-id> demo,则orc inkdrop push demo。 。 。 .- 编辑墨水滴中的光谱;
orc inkdrop pull demo显示changed: yes。 。 。 . - 墨水滴预览隐藏
<!-- 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。 。 。 .
文档
许可证
麻省理工学院