从一句话,
到可验证的改动。
omp 不把“生成代码”当作终点。一个回合会经过上下文定位、显式计划、并行执行、独立验证与可审计交付;每一步都留下可检查的状态。
五步闭环。
步骤不是强制的仪式,而是工具与提示共同倾向的默认路径。
定位上下文
先用 read 拿摘要、grep/glob 缩小范围,再用 lsp 查定义与引用。需要语义入口时用 omp find 描述行为,直接得到实现文件与行区间。
read 默认摘要化,避免整仓倾倒;内部 scheme 让 PR、issue、子代理输出与本地文件同形。让计划可见
复杂任务进入 plan mode:只读探索、产出方案,确认后再切换执行模型。todo 把阶段与条目写进会话,阶段推进对用户和子代理都可见。
omp --plan-yolo "迁移到新的鉴权中间件"
# 只读规划 → 自动确认 → 交给 smol 角色执行并行执行
相互独立的切片交给 task。需要写盘时启用工作树隔离;每个 worker 有独立工具面与预算,结果以 schema 校验后的对象返回。父会话通过 wait 收结果,或通过 Agent Hub 实时介入。
独立验证
改完就跑最窄的检查:测试、类型检查、LSP 诊断、真实浏览器或 CLI。失败会回到编辑循环;成功才进入交付。UI 改动应在浏览器里看到实际表面,而不是只读源码。
交付与复盘
/review 用独立审查代理按 P0–P3 分级;omp commit 拆分原子提交;会话可导出 HTML、加密分享或直播给队友。子代理与成本统计保留在 omp stats。
一个引擎,四层边界。
入口只负责传输;会话编排、工具面与原生执行层共享同一套能力。
架构示意图。入口层共享会话;工具决定“能做什么”,执行层决定“多快、在哪做”。
扇出,然后收拢。
父代理定义切片与验收标准,worker 在自己的上下文里完成并 yield 一个对象。隔离工作树避免兄弟代理互相踩文件;类型化结果让父代理不必从散文里猜。
- 工作树隔离:APFS clone / btrfs / ZFS / overlayfs
- 预算与工具面按 worker 配置
- Alt+A:实时转录、纠偏、终止
同一引擎,四种入口。
| 入口 | 命令 | 适合 |
|---|---|---|
| 交互 TUI | omp | 日常开发;工具卡片、编辑预览、ask 表单、实时子代理 |
| 一次性 / 脚本 | omp -p、--mode json | CI、批处理、管道;--wait-async 等待后台任务 |
| RPC | omp --mode rpc | 非 Node 宿主;NDJSON 命令与事件,可选 UI 帧 |
| ACP / SDK | omp acp、@oh-my-pi/pi-coding-agent | Zed 等编辑器;Node 进程内嵌会话 |
# 事件流,适合管道
omp -p --mode json "列出所有 TODO" > events.jsonl
# 后台跑集成测试,结果回来继续同一会话
omp -p --wait-async --max-time 2h \
"后台跑集成测试,失败就修"
$ omp --mode rpc --no-session
> {"id":"r1","type":"prompt","message":"list .ts files"}
< {"id":"r1","type":"response", ...}
> {"id":"r2","type":"set_model",
"provider":"anthropic","modelId":"sonnet-4.5"}
> {"id":"r3","type":"abort"}
速度之外的边界。
审批分级
always-ask、always-ask-cached、write、yolo 四档;显式工具策略与供应商安全检查始终优先生效。
成本与时间上限
--max-cost 到达上限即停止发请求;--warn-cost 只提醒;--max-time 2h 限制无人值守会话。
流中纠偏
规则平时休眠;正则命中时中止 token 流、注入系统提醒并从同一点重试,注入内容在压缩后仍保留。
子代理隔离
写操作可跑在独立工作树;父子共享连接但各有超时与取消边界,父会话中断会停止子代理等待。
项目输入即代码
打开仓库会加载其设置、扩展、hooks、技能与 MCP。用 --no-extensions、--trusted-extension 或关闭项目 MCP 来收窄。
本地可观测
omp stats 从会话日志汇总请求、token、成本、工具与目录维度;数据留在本机。