用途：run-agent 是智能体执行的单一入口，用于启动子智能体运行。一次运行由模型、可选智能体、可选技能和提示词构成，它会根据所选模型自动路由到对应 CLI（claude、codex、opencode），记录日志并写入结构化索引条目。技能来源为同级目录 ../，运行产物写入 .orchestrate/。
主要能力与用法：运行脚本为 scripts/run-agent.sh，索引导航脚本为 scripts/run-index.sh。可用 --model 指定模型，--skills 指定技能，-p 给出提示词；支持 --label 标签、--session 会话分组、-v 模板变量替换、-f 追加引用文件、--dry-run 预览组合后的提示词与命令、-C 指定工作目录、--continue-run 延续之前的运行会话，以及 --fork、--in-place 控制续跑方式。首次运行会在工作区自动创建 .orchestrate/config.toml，可用 [skills] pinned 配置每次运行自动添加的技能。
模型路由：claude-、opus、sonnet、haiku 前缀走 Claude（claude -p）；gpt-、o1、o3、o4、codex 前缀走 Codex（codex exec）；opencode- 前缀或 provider/model 形式走 OpenCode（opencode run）。路由由所选模型自动决定。
产物与索引：每次运行写入 .orchestrate/runs/agent-runs/<run-id>/，包括 params.json、input.md、prompt.raw.md、output.jsonl、stderr.log、report.md、files-touched.nul 与 files-touched.txt。索引为 .orchestrate/index/runs.jsonl 的两行追加式记录：执行前写入 running 起始行，执行后写入 completed 或 failed 终结行（含退出码、耗时、token 用量、git 元数据）；只有起始行而无终结行表示崩溃或仍在进行。退出码含义：0 成功，1 智能体或模型错误，2 基础设施错误，3 超时，130 中断，143 终止。
适用场景与限制：适合在编排流程中批量启动并追踪子智能体运行。资料未提供价格、平台支持范围或效果指标；技能未命中时默认行为及 --strict-skills 之外的容错细节暂未提供。