60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
# orc
|
|
|
|
ORC 是显式调用的工程编排入口：把开发、版本发布、DEB 和 Docker 任务拆成阶段，
|
|
交给对应 Skill，并为每个执行 Agent 选择 `low`、`mid` 或 `high` 档位。
|
|
|
|
## 什么时候使用
|
|
|
|
- 一个请求同时包含写代码、发版本和构建产物。
|
|
- 希望由 ORC 监督多个 Agent，并按阶段控制成本与推理能力。
|
|
- 需要继续中断的多阶段工程流程并保留依赖关系。
|
|
|
|
只做单一领域任务时可以直接调用对应 Skill；ORC 不替代它们的安全规则。
|
|
|
|
## 使用前准备
|
|
|
|
- Orca 正在运行并启用了 orchestration。
|
|
- 安装本次需要的 `$ack`、`$manage-release`、`$deb-publisher` 或
|
|
`$publish-docker-image`。
|
|
- 运行 `$orc 初始化` 生成 `docs/orc/config.yaml`，确认三档对应的精确模型。
|
|
- `/usr/bin/python3`；ORC v1 配置必须保持为内置模板使用的 JSON-compatible YAML。
|
|
resolver 以 `-I -S` 隔离模式运行，不加载项目模块、用户 site-packages 或第三方解析器。
|
|
- ORC v1 worker 使用 `workspace-write` sandbox，以便发送 Orca lifecycle 消息；
|
|
只读任务会在阶段 prompt 中禁止文件修改。
|
|
|
|
## Agent 档位
|
|
|
|
| 档位 | 典型任务 |
|
|
|------|----------|
|
|
| `low` | 输入明确的测试、构建、打包和上传 |
|
|
| `mid` | 常规版本发布与范围清晰的工程任务 |
|
|
| `high` | 需求理解、跨系统改动、异常恢复和高风险裁决 |
|
|
|
|
档位不是权限。三个档位仍受各自 profile 和下游 Skill 的授权边界约束。
|
|
当前 ORC v1 的结构化启动适配器支持 Codex worker；其它 Agent CLI 需要独立适配器，
|
|
不会通过自由命令接入。
|
|
|
|
## 使用示例
|
|
|
|
```text
|
|
$orc high 修复登录问题，验证通过后发布新版本。
|
|
$orc code=high release=mid docker=low，完成修复、发版并推送镜像。
|
|
$orc mid 继续上次中断的 v1.4.0 发布流程。
|
|
```
|
|
|
|
阶段级档位优先于全局档位。用户显式指定后，ORC 不会静默改档；能力不足时会暂停并
|
|
请求确认。
|
|
|
|
## Agent 会做什么
|
|
|
|
1. 识别开发、源码发布、DEB 与 Docker 阶段及其依赖。
|
|
2. 解析每个阶段的 Agent profile，把配置快照、可信 Codex executable 和真实 Git
|
|
worktree 绑定成 launch fingerprint，并展示计划和外部写入边界。
|
|
3. 通过 Orca 分发给对应 Skill，监督完成消息、异常和决策门。
|
|
4. 汇总每个阶段的实际状态、证据和安全恢复入口。
|
|
|
|
## 如何判断完成
|
|
|
|
最终结果会逐阶段列出所用 Skill、Agent 档位、源 revision、远端或产物状态，以及任何
|
|
未完成项。只有所有必要阶段都通过各自验证时，ORC 才会报告整个流程完成。
|