martin1847/evolab / skills/cto-orchestration
cto-orchestration
Unverified以 CTO/orchestrator 模式管理多 agent 软件交付。用户要求“你做 CTO/编排者”“派 omp/codex 去做”“goal 模式派发”、管理多会话开发或接入这套工作流时使用;“复盘/收口/retro/retrospective”“工作盘点/盘点候选/stocktake”也必须触发,盘点只提案不动工。新项目先用 repo-governance-bootstrap 建治理骨架。不用于单 agent 小任务、无需评审循环的局部改动或纯文档初始化。
references/goal-clauses.md
View on GitHub# 场景条款(按需清单,C01–C17)
> goal-template §场景条款 只留 17 行索引,条款正文在此单源。用法:逐条判命中 → 命中则把该条正文
> 复制进 goal 的对应节并实例化(填具体命令 / 路径 / 阈值 / 观察面);未命中的条款不出现在 goal 里,
> 也不需要在 goal 里留痕。ID 稳定,goal / 评审 / 复盘可直接引用(如「本 goal 命中 C09、C12」)。
## C01 决策或 Value gate 前提依赖「没观测到 X」(含「现无 / 不存在 / 没有机制拦」类断言)
- [ ] 决策**或 Value gate 前提**依赖「没观测到 X」(含「现无 / 不存在 / 没有机制拦」类断言)→ 加
absence-evidence gate:known-positive probe 先证探测器看得见 X,否则结论只能是 `UNKNOWN`;
队列 / 记忆 / 印象里的措辞不是实施状态证据(否定性断言各配自己的探针,正路径探针不覆盖它)。
**范围也要落纸**:负对照只证明探测器有效、不证明扫描面完整——缺席断言须同行声明扫描根
(preflight 门机判「有没有声明」,不判对不对);消费该前提的 worker 须**独立重列扫描面**、
与声明做差集,有差即 STOP——在给定范围里重跑给定命令不是独立验证,范围继承则验证不独立。
## C02 新增防御层 / 复杂度(新校验、新隔离、新配置矩阵)
- [ ] 新增防御层 / 复杂度(新校验、新隔离、新配置矩阵)→ Value gate / Preflight 行须含「该威胁
或需求场景在本架构真实存在」的实证探针——只证机制**能做**不构成**需要做**(复杂度按证据升级)。
## C03 Value gate 的因果判断来自对照读数(「有 A 的成功 / 没 A 的失败」类相关性)
- [ ] Value gate 的因果判断来自对照读数(「有 A 的成功 / 没 A 的失败」类相关性)→ 派发前先查
**失败侧实际行为**:失败样本是「尝试获取 A 而不得」,还是根本没走到需要 A 的那步?多数失败
样本确实尝试过才算因果成立;否则收益降级、回主理人重裁(相关读数当因果派单 = 给无关病灶
开药)。
## C04 含「部署/配置生效后重测」步骤
- [ ] 含「部署/配置生效后重测」步骤 → 先写**生效前置确认**(命令 + 期望值)再测;测量探针打
**运行时真源**(DB 行 / 活进程 / 线上 endpoint),不拿构建 SHA、镜像 tag 等代理指标下生效结论
(缺前置确认则 worker 自己发明等待、对已完成部署空转)。
## C05 测量/评测类 Done-when(对比判定 / 命中率 / 基准 / 评测报告)
- [ ] 测量/评测类 Done-when(对比判定 / 命中率 / 基准 / 评测报告)→ 读 measurement-protocol.md,
七条款逐条对照实例化进本 goal(细则该文件单源,本模板不复制)。
## C06 鉴权/会话/用户数据相关改动
- [ ] 鉴权/会话/用户数据相关改动 → 验证覆盖**状态形状矩阵**,不得只测新鲜快乐态;矩阵成员与
制造方法见 frontend-verify「状态形状矩阵」,本模板不复制。
## C07 涉及长耗时外部作业
- [ ] 涉及长耗时外部作业 → 写**等待配方**:禁止阻塞 sleep >60s,改有判据的短轮询(命令 + 达成
条件),连续 N 次未达成 → STOP and report(缺配方则 worker 自创长 sleep 顶穿 watcher 窗口);
编排位派发带 `--expect <预计分钟>`:超 1.5× 出 typed OVER-BUDGET 唤醒,重挂 `watch --expect <更大值>`
每抬一次再报一次 = 周期 check-in(席位合法长跑数小时也不空等)。
## C08 改动带功能旗标
- [ ] 改动带功能旗标 → 写旗标门控:<flag 名,默认 ON/OFF + 理由>。
## C09 goal 声明了可写路径闭集
- [ ] goal 声明了可写路径闭集 → 席位开工第一件事是 **Step 0 闭集核对**(10 分钟内、先于一切取证):
对每个交付项打开真正的落地物(use site / SQL / Dockerfile / 注册表),列出闭集外但必改的文件;
核对面 = 闭眼列出实现者 `git diff --name-only` 的全集:生成物 / goal 强制新建的仪器测试 /
RUNBOOK 与 findings 义务 / 修复对象的过时注释与同病邻居;
有漏 ⇒ 只把 delta(file:line + 为什么必改 + 最小改法)写进 BLOCKED.md 停等,不做整份取证;
无漏 ⇒ 回执一行「闭集核对:无 delta」后开工。
## C10 改动触及状态机单一写者 / 命令面 / 巡检选取谓词之一
- [ ] 改动触及**状态机单一写者 / 命令面 / 巡检选取谓词**之一 → Done-when 必含场景矩阵交付物
(状态 × 触发 × 关键变量 + 命令 × 状态两张表;形态与 kill criterion 细则读
implementation-discipline §场景矩阵,本模板不复制)——单点用例各自绿挡不住组合格与语义表(下游席位 n=3)。
## C11 本 goal 新造门/上限/仪式(合同硬门、证据文档仪式)
- [ ] 本 goal 新造门/上限/仪式(合同硬门、证据文档仪式)→ 先向主理人报,且同行附
**kill criterion**(什么证据证明它是净负债);无此行不进合同(复盘按 GATE-AUDIT 结账)。
## C12 goal 含合并/发布类终态动作
- [ ] goal 含合并/发布类终态动作 → 前置写成机械外部输入:「合并前置 = 编排位 steer 传回
verdict=PASS **及其针对的 head_sha**(编排位发此 steer 时必须带上;席位比对它与待合并
head 逐字相同);未满足(含 FIX-FIRST、verdict 后又有新提交)⇒ BLOCKED.md 停等;owner 闸
不满足 ⇒ STOP 回编排位,**席位不得自绕**(break-glass/程序外通道越权实证)」——抽象条件由
席位自判必被穿,不绑 head 的收据会被评审后追加提交沿用(下游席位各 n=2)。
## C13 普通非 review-loop 长跑且有明确时长/成本上限
- [ ] 普通非 review-loop 长跑且有明确时长/成本上限 → 写明该预算;耗尽仍未达成 = 保持任务
active + STOP and report。review-loop 轮数预算只由 runtime `--max-rounds` 强制,本 GOAL 不复制轮数。
## C14 Done-when 含编排者自造量具(非仓内既有套件/CLI 的证明命令)
- [ ] Done-when 含**编排者自造量具**(非仓内既有套件/CLI 的证明命令)→ 附四臂自跑记录(正绿/
坏红/量具故障红/阈值边界红)且 rc 逐值写死;细则 implementation-discipline §编排者自造量具
(下游席位 n=5 合同期 fail-open 实证)。
## C15 多 goal 波次 / 父 Goal 接续(本 goal 是某个父 Goal 的一段)
- [ ] 本 goal 服务于一个父 Goal(总 Goal / 波次)→ 抬头写 `Parent-Goal: <绝对路径>`,Done-when 末条写
**交付终点**:本 goal 到哪一步为止(集成 / 本机真路径 / 部署 / 线上验收),后续步骤归父 Goal、
由编排位接续——worker DONE 不是波次的停点,父 Goal 状态由编排位回写。
## C16 证伪型 goal(spike / 对照 / 候选比较)的采用与弃用
- [ ] 本 goal 是证伪型(spike / 对照 / 候选比较)→ **采用 / 弃用条件开工前写死**(阈值与判据进
Done-when,事后不改);回执必答「采用 / 弃用」二选一,弃用保留负结果与读数,不算失败,
也不得为交付把实验结果强塞进产品路径。
## C17 行为改动类 goal(`Change-Type: defect` / 改变可观察行为)的既有行为与测试条款
- [ ] 行为改动类 goal → 涉及既有算式 / 阈值时引用真源及原式,概括不得替代行为契约;改变原式须列出行为差异。
若含「逐字不改 / 只改 X、其余断言保留 / 原样搬」类限制承诺,写成「既有测试不动;**仅断言编码本次被改行为时,
按明确裁决可改/删,回执逐条列:旧断言 → 新断言 → 原因(为何编码旧合同)**」,编排位逐条验收;该测试条款**替换** Guardrails 的测试只读句。
纯增量 / 重构 / 删除类 goal 仍可写「逐字不改」(preflight 限制承诺与行为标记同现仅 WARN,指到本条)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |