Skip to content

martin1847/evolab / skills/cto-orchestration

cto-orchestration

Unverified

以 CTO/orchestrator 模式管理多 agent 软件交付。用户要求“你做 CTO/编排者”“派 omp/codex 去做”“goal 模式派发”、管理多会话开发或接入这套工作流时使用;“复盘/收口/retro/retrospective”“工作盘点/盘点候选/stocktake”也必须触发,盘点只提案不动工。新项目先用 repo-governance-bootstrap 建治理骨架。不用于单 agent 小任务、无需评审循环的局部改动或纯文档初始化。

FileKindSize
README.mdmarkdown5.3 KB
SKILL.mdskill md15.8 KB
references/agentctl/README.mdmarkdown26.8 KB
references/agentctl/agentctlexecutablescript57.6 KB
references/agentctl/codegraph-hooks.shexecutablescript2.5 KB
references/agentctl/cto-guard-agent.pyexecutablescript26.6 KB
references/agentctl/cto-guard-bash.pyexecutablescript150.5 KB
references/agentctl/cto-guard-edit.pyexecutablescript16.7 KB
references/agentctl/cto-guard-stop.pyexecutablescript7.6 KB
references/agentctl/duplexctl.pyexecutablescript239.5 KB
references/agentctl/guard-hooks.jsonconfig1.5 KB
references/agentctl/identity.pyexecutablescript113.5 KB
references/agentctl/post-checkout-codegraph.shscript18 B
references/agentctl/seat-census.pyscript10.8 KB
references/agentctl/watchctl.pyexecutablescript143.2 KB
references/agents-md-orchestration-section.mdmarkdown5.3 KB
references/decision-queue.mdmarkdown5.7 KB
references/dispatch-baseline.mdmarkdown3.7 KB
references/doc-lifecycle.pyexecutablescript9.2 KB
references/frontend-verify.mdmarkdown7.9 KB
references/goal-clauses.mdmarkdown8.0 KB
references/goal-preflight.pyexecutablescript40.9 KB
references/goal-template.mdmarkdown10.8 KB
references/implementation-discipline.mdmarkdown8.0 KB
references/measurement-protocol.mdmarkdown4.2 KB
references/onboarding-checklist.mdmarkdown3.2 KB
references/queue-freshness.pyexecutablescript3.8 KB
references/queue-hooks.jsonconfig617 B
references/retro-check.shexecutablescript28.2 KB
references/retro-hooks.jsonconfig2.2 KB
references/retro-reminder.shexecutablescript5.8 KB
references/retrospective.mdmarkdown7.7 KB
references/review-brief-preamble.mdmarkdown3.4 KB
references/review-dispatch.mdmarkdown14.4 KB
references/session-economics.pyexecutablescript18.2 KB
references/shock-in-the-loop.mdmarkdown3.8 KB
references/stocktake.mdmarkdown2.3 KB

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.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall