martin1847/evolab / skills/cto-orchestration
cto-orchestration
Unverified以 CTO/orchestrator 模式管理多 agent 软件交付。用户要求“你做 CTO/编排者”“派 omp/codex 去做”“goal 模式派发”、管理多会话开发或接入这套工作流时使用;“复盘/收口/retro/retrospective”“工作盘点/盘点候选/stocktake”也必须触发,盘点只提案不动工。新项目先用 repo-governance-bootstrap 建治理骨架。不用于单 agent 小任务、无需评审循环的局部改动或纯文档初始化。
references/goal-template.md
View on GitHub# GOAL — <一句话任务名>(<implementation | research-only | hotfix>)
> Owner: omp. Worktree `<abs path>`, branch `<feat/...>`(cut from latest origin/<base> @ <sha>).
> Reviewer: codex(after commits; diff 口径 three-dot `origin/<base>...HEAD`;评审行为契约归
> review-dispatch,本模板不复述). Commits stay LOCAL — pushing requires <用户名> approval.
> 本 goal 中所有“先读路径”和“交付物路径”必须写绝对路径,尤其跨伞仓/子仓;评审/派工 brief
> 同此规则(brief 也是 goal——裸文件名会被下游席位就近解释,产物写错位置)。
> 不要求证明命令内部每个参数都绝对化。如属研究:RESEARCH ONLY — no code changes, no commits.
> 基线核对只针对你自己的 worktree;主 checkout 与本地 <base> 分支不在核对面、不得要求
> fast-forward(squash 集成仓的主 checkout 必然分叉,拿它判 BLOCKED 是误报)。
Tier: <deep | light>(判档在 SKILL §2:goal 新增判据 / 门 / 状态 / 接口 / 解析面 = deep)
Goal-Review: <回执路径 | SKIPPED: <理由>>(仅 deep;review-dispatch §goal-review)
## Context (read first)
<合同作者先读目标仓及适用子目录规则,在此并列规则与前置研究/诊断文档的绝对路径,再写现状。
外部观测事实(运维/QA)标注 "ground truth:与假设矛盾时事实赢">
<凭据/环境入口给**绝对路径**(如 `ACCESS.local.md`——worker cwd 在 worktree,相对搜找不到);
build/test 关键命令若该仓 AGENTS.md 未列,在此内联一行>
<可选:codegraph 仅作定位加速器;已接 Git hook 时不重复 init/sync。仅本 worktree 已有索引、允许维护且未在构建时,才用
`codegraph status` 诊断(可能写库,exit 0/mtime 不证就绪);确认归属本树、已完成且无待同步/未解析/需重建提示,才用 `codegraph explore "<符号或问题>"`。
否则(含未装/无索引/失败/不可判)回退仓根 rg/源码阅读,非 blocker,不等待或补跑 sync;
删除/迁移/退役依赖零引用/无调用时,须源码 rg 或适用 AST 复核;普通定位不默认双扫。>
> 取证 / 机械改动 / 纯研究且不新增防御层或复杂度的 goal → 删下一行、派发加 `--no-preflight`;
> 其余 goal(含所有新增防御层/复杂度的)→ 先跑最便宜证伪、保留下一行(preflight 门校验其形态,
> 新增防御层者须含存在性探针,见场景条款)。探针命令锚 repo 根——只扫子目录会漏兄弟目录的
> 真实调用方,前提假则 goal 塌。
Value gate: <existing gap → incremental value>; Preflight: <cheapest read-only falsifier actually run> => <observed result>
## Pre-triage hypotheses (verify, don't trust)
- **H1 (likely primary)**: <假设 + file:line 证据>
- **H2**: <...>
(编排者预判可以加速,但必须标注为待验证——执行者有义务推翻它们)
## Premises this goal rests on (VERIFY — do not trust)
> 仅当本 goal 依赖 upstream audit / scout 结论、**或从正典(ADR / NORTH_STAR / 基建文档类)
> 继承硬约束**时填写。编排者必须抽出每条承重 premise;candidate evidence is not a verdict。
> 任何 premise 为假 → **STOP AND REPORT**,不得在错误基础上继续实现。
> `=> <observed>` 只抄自派发前在目标 base 干净树上**实跑**的输出;probe **整段恰一个反引号段** = 执行——门在 `agentctl start`
> 时于席位 cwd 原样跑它、与 `rc=N` / `count=N`(stdout 非空行数)比对,不符即拒(`goal-preflight.py`,细则见其头注);席位 / 评审席复跑同一行。
> 前提关乎**本 goal 即将改变的状态**时,probe 必须锚 pinned base(`git show <base sha>:<path> | …`)而非活树——否则交付物一落地它就翻转,goal 过不了自己的门(门对命中本 goal 写集的活树探针打 WARN,不拦)。
- [ ] PREMISE: <承重前提> verify=`<独立证明命令>` => count=<N> rc=<N>(门实跑此行并比对记号,每种记号至多一次;`live-probe: …` 与混排 / 多段反引号等其余形态不执行、一律报未执行)
- [ ] 继承的硬约束 = 也是 premise,同一形态并标〔来源 + 可降级性〕——继承≠免检;向主理人问一句
「这约束在本 goal 语境还算数吗」是合法且常为最便宜的证伪。
## North-star gate(目标仓/伞仓声明了方向文档时保留,否则整节删除)
> 动手前逐条过闸(spec-kit Constitution Check 同构;编排者写 goal 时先自过一遍,执行者开工前复核):
- Direction doc: `/absolute/path/to/NORTH_STAR.md`
- Touches: <NS-x: 一句话自证合规 / NS-y: 潜在张力 + 本 goal 的处理方式>
- 任何「无法一句话自证合规」的触碰 → 升 THINK 档:写 impact + 被拒的更简替代及理由;
仍存疑 → STOP AND REPORT,不得静默继续(放宽任何既有门禁同此协议)。
## Task / Deliverables
1. <可验证的具体产出,含交付物绝对路径>
2. **Tests**: <要求的测试形态——回归测试必须"修复前红、修复后绿";仅机制替换时,按实际调用方与路径
写保留行为,不以测试名代替契约;仅库/SDK 改持久化或外部可观察行为时,点名受影响消费者并绑定相关
现有套件或最小真实调用证明,不要求全量下游测试>
3. **E2E**: <环境 + 数据约束(哪个 DB 批准了写)+ 做不到时的诚实降级路径>
4. 文档:findings 写入 `/absolute/path/to/worktree/docs/orchestration/<NAME>_<FINDINGS|IMPL>_omp.md`,
含 what-changed / what-verified(真跑过) / 意外发现与关键决策(含理由);未验证项与剩余假设仅影响验收决定时列出。
回执里任何「没找到 / 0 命中 / 无回归 / unmatched」类缺席结论写 typed 行
`ABSENT: <claim> scope=<扫描根> probe=<cmd> positive=<已知阳性 cmd> => count≥1`
(已知阳性先证探测器看得见 X);拿不出已知阳性就写 `UNKNOWN`、不写缺席。
## Done when(完成判定 — 每条绑定证明命令,逐条须有**本次会话工具结果**级证据,非记忆中的旧结果;验证范围匹配声明范围)
> 实现类保留下一行(纯模板行:n=1 不立门,preflight 不机判它)——证明深度是合同的一部分,
> 不声明就会被「保险起见再跑一遍全量」吞掉;重复全量跑不产生新信息,只买心安。
Evidence: 各证明证到 <决策行|单套件|全量> 为止(缺省 = 单套件;全量仅当运行本身是验收对象)
- [ ] <任务实际产物 / 业务结果及预期(数量适用时列数量;偏离预期须说明原因)+ **证明命令与预期输出**;
测试通过不能替代交付——写成可据证据判定达标与否的形态>
- [ ] 回归测试绿、独立复跑 test+lint 干净;单测过 ≠ 端到端成立。**先红后绿推广到新功能**:头号断言若只有它自己的测试作证
(无编排者可独立复跑的真路径回执)→ 须证明它依赖该功能:去掉功能的贡献时头号断言**不成立**——常驻阴性对照用例断言相反结果且**绿**;对照红 = 头号断言是同义反复。
- [ ] 本 goal 定义验收仪器 → 只写**要看见什么损害**与观察面,不写用什么机制看(对象:Done-when 各条)
——机制归实现者:机制写死 = 把编排者的模型错误烘进合同,抹掉实现者那次独立抽样。越界信号:
goal 里出现具体 hook 点名 / monkeypatch 目标 / 内嵌多行 bash / 期望某文件某行长什么样。
## 场景条款(正文单源在 `references/goal-clauses.md`;逐条判命中:命中 → 从该文件复制该条正文、实例化进上方对应节;未命中 → 整条删)
- [ ] C01 决策或 Value gate 前提依赖「没观测到 X」(含「现无 / 不存在 / 没有机制拦」类断言)
- [ ] C02 新增防御层 / 复杂度(新校验、新隔离、新配置矩阵)
- [ ] C03 Value gate 的因果判断来自对照读数(「有 A 的成功 / 没 A 的失败」类相关性)
- [ ] C04 含「部署/配置生效后重测」步骤
- [ ] C05 测量/评测类 Done-when(对比判定 / 命中率 / 基准 / 评测报告)
- [ ] C06 鉴权/会话/用户数据相关改动
- [ ] C07 涉及长耗时外部作业
- [ ] C08 改动带功能旗标
- [ ] C09 goal 声明了可写路径闭集
- [ ] C10 改动触及状态机单一写者 / 命令面 / 巡检选取谓词之一
- [ ] C11 本 goal 新造门/上限/仪式(合同硬门、证据文档仪式)
- [ ] C12 goal 含合并/发布类终态动作
- [ ] C13 普通非 review-loop 长跑且有明确时长/成本上限
- [ ] C14 Done-when 含编排者自造量具(非仓内既有套件/CLI 的证明命令)
- [ ] C15 多 goal 波次 / 父 Goal 接续(本 goal 是某个父 Goal 的一段)
- [ ] C16 证伪型 goal(spike / 对照 / 候选比较)的采用与弃用
- [ ] C17 行为改动类 goal(`Change-Type: defect` / 改变可观察行为)的既有行为与测试条款
## Guardrails
- Scope = <精确边界>;**out of scope(枚举)**= <明确不做的相邻项>。合同作者写禁止项前对照已知根因候选;
若排除候选修复路径,派工前核必要性并裁决冲突;涉及权限、安全或主理人明示约束的冲突须上报,不自行豁免。
No refactors of neighboring code, no format changes.
- 禁止删 / 改 / 跳过测试、断言或 grader(命中 C17 的按其清单例外),禁止压制错误顶替修 root cause——测试集对执行者只读
(成功标准"红→绿"最易被 game)。
- 复述 / 立即开工 / BLOCKED 协议由 runtime 固定追加,本 GOAL 不复制;高风险任务升级为先交
mini-plan(goal 里显式要求先产出 plan 文件再动手)。
- **存疑协议**:缺失信息**会改变目标 / 权限 / 验收判据**的才标 `NEEDS-CLARIFICATION: <具体问题>` 停下问,
**禁止合理化猜测**(猜而不问是 goal 执行最常见的静默失败);可逆的实现细节自行决定、在 findings 记一行理由;
需要超 scope 改动、或同一路径连败两次:STOP and report(blocked + 已试过什么),不自行扩权、别硬耕。
- **自证止损**(对象:已由本次会话工具结果落定的 Done-when / claim):落定后允许至多 1 轮
确认性复跑;确认未改变结论 → 停止该结论的重复验证,继续未完成交付;全部完成则交付结果。
- 遵守仓库自身规则(AGENTS.md / 项目声明的影响分析工具等)。
- 点名本仓适用的工程规范 skill 并要求执行 agent 开工前加载(观测/后端/git 等)——**名单来自该仓
AGENTS.md 的声明,本模板不硬编码任何具体规范**(编排与规范各自独立可用,不耦合)。
- Redact secrets/customer data in docs. No AI signature lines in commits.
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 |