omp²

从一句话,
到可验证的改动。

omp 不把“生成代码”当作终点。一个回合会经过上下文定位、显式计划、并行执行、独立验证与可审计交付;每一步都留下可检查的状态。

The loop

五步闭环。

步骤不是强制的仪式,而是工具与提示共同倾向的默认路径。

定位上下文

先用 read 拿摘要、grep/glob 缩小范围,再用 lsp 查定义与引用。需要语义入口时用 omp find 描述行为,直接得到实现文件与行区间。

→read 默认摘要化,避免整仓倾倒;内部 scheme 让 PR、issue、子代理输出与本地文件同形。

让计划可见

复杂任务进入 plan mode:只读探索、产出方案,确认后再切换执行模型。todo 把阶段与条目写进会话,阶段推进对用户和子代理都可见。

plan → execute
omp --plan-yolo "迁移到新的鉴权中间件"
# 只读规划 → 自动确认 → 交给 smol 角色执行

并行执行

相互独立的切片交给 task。需要写盘时启用工作树隔离;每个 worker 有独立工具面与预算,结果以 schema 校验后的对象返回。父会话通过 wait 收结果,或通过 Agent Hub 实时介入。

∥并发不是“多开几个聊天”:文件隔离、类型化 yield、点对点通信缺一不可。

独立验证

改完就跑最窄的检查:测试、类型检查、LSP 诊断、真实浏览器或 CLI。失败会回到编辑循环;成功才进入交付。UI 改动应在浏览器里看到实际表面,而不是只读源码。

✓验证结果写回会话,成为后续审查与提交消息的证据。

交付与复盘

/review 用独立审查代理按 P0–P3 分级;omp commit 拆分原子提交;会话可导出 HTML、加密分享或直播给队友。子代理与成本统计保留在 omp stats。

Architecture

一个引擎,四层边界。

入口只负责传输;会话编排、工具面与原生执行层共享同一套能力。

架构示意图。入口层共享会话;工具决定“能做什么”,执行层决定“多快、在哪做”。

Subagents

扇出,然后收拢。

父代理定义切片与验收标准,worker 在自己的上下文里完成并 yield 一个对象。隔离工作树避免兄弟代理互相踩文件;类型化结果让父代理不必从散文里猜。

  • 工作树隔离:APFS clone / btrfs / ZFS / overlayfs
  • 预算与工具面按 worker 配置
  • Alt+A:实时转录、纠偏、终止
parent session contracts + budget worker · tests own worktree worker · types own worktree worker · review own worktree typed yield → parent reads fields
Interfaces

同一引擎,四种入口。

入口命令适合
交互 TUIomp日常开发;工具卡片、编辑预览、ask 表单、实时子代理
一次性 / 脚本omp -p、--mode jsonCI、批处理、管道;--wait-async 等待后台任务
RPComp --mode rpc非 Node 宿主;NDJSON 命令与事件,可选 UI 帧
ACP / SDKomp acp、@oh-my-pi/pi-coding-agentZed 等编辑器;Node 进程内嵌会话
headless — 结构化输出
# 事件流,适合管道
omp -p --mode json "列出所有 TODO" > events.jsonl

# 后台跑集成测试,结果回来继续同一会话
omp -p --wait-async --max-time 2h \
  "后台跑集成测试,失败就修"
RPC — 每行一个帧
$ 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"}
Guardrails

速度之外的边界。

APPROVAL

审批分级

always-ask、always-ask-cached、write、yolo 四档;显式工具策略与供应商安全检查始终优先生效。

BUDGET

成本与时间上限

--max-cost 到达上限即停止发请求;--warn-cost 只提醒;--max-time 2h 限制无人值守会话。

RULES

流中纠偏

规则平时休眠;正则命中时中止 token 流、注入系统提醒并从同一点重试,注入内容在压缩后仍保留。

ISOLATION

子代理隔离

写操作可跑在独立工作树;父子共享连接但各有超时与取消边界,父会话中断会停止子代理等待。

TRUST

项目输入即代码

打开仓库会加载其设置、扩展、hooks、技能与 MCP。用 --no-extensions、--trusted-extension 或关闭项目 MCP 来收窄。

OBSERVE

本地可观测

omp stats 从会话日志汇总请求、token、成本、工具与目录维度;数据留在本机。