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/retrospective.md

View on GitHub
# 复盘仪式操作手册

> 显著返工、交付失败或用户明确要求复盘时,按本 checklist 执行;刚跑过只补增量。
> 普通收口与压缩按 SKILL.md §5,不触发全套复盘。

## 七步 checklist

1. **交付清单**:shipped / parked / 残留,**每单元标面**(业务效果 / 必要工程 / 混合,混合单列
   不硬分;分类以落地物路径为准,覆写留理由——覆写清单在此人眼过)+ 报近期配比与
   **距上次真实用户路径被走通的间隔**(配比轴判据见 SKILL §2)——比值是数字才判得了,且它只在
   这里被看见:自动闸只咬间隔,拦不住长期偏离;比值这一期该是多少,由主理人当场调旋钮。
2. **过程×结果四象限**(每个收口单元落唯一一格,禁「上线=好」塌缩):好程好果=**实力赢**(固化做法) ·
   坏程好果=**走运**(别奖励、补过程洞) · 好程坏果=**倒霉**(别改流程) · 坏程坏果=**实力输**(改)。
   判「走运」即使 shipped 也标 outcome 星号 + 点出过程缺口。
3. **教训分层沉淀**(系统方法论见内核 `orchestrator-core/references/self-evolution.md`,此步为其操作化、自包含可跑):
   - **分诊落层**:五问追根,**追问停在哪层、教训就落哪层**——事实(路径/凭据/执行路径)→ ACCESS/docs;
     本项目情景教训 → memory(带 **Why + How-to-apply + provenance**〔哪次事故立的〕,memory 只留指针
     不存事实细节);跨项目操作规则 → skill reference;判断标准 → skill 主干;范式 → meta。
     同类补丁在低层反复出现 = 上一层治理变量有缺陷的信号,升层提问、别再加一条。
   - **晋升三门**:**样本门**(measure-before-more 的复盘版)——n=1 只标 `OBSERVATION`、不改 spec/默认,
     **≥2 例同向**才提议升层;**行为门**——顺手核一条:上轮复盘沉淀的教训这轮 fire 了吗(记录 ≠ 学会,
     没 fire 的进下条淘汰);再核一条:**上一批买下的性质,这一批有电守着吗**(合同写在 goal 里的,
     goal 归档它就死了);**压缩门**——同层出现 **≥3 条同族条目 → 提蒸馏合并案**(1 条上层判据 +
     retire 原件,corpus 总量不增;总量没减 = 复制不是晋升)。retro 只**提议**,改 spec 由主理人**裁定**
     (提议/批准分离,防按一次性事件堆规则)。
   - **教训与门同形态**:教训入台账写 typed 行 `LESSON: <slug> n=<复发次数> gate=<门路径|none|accepted(理由)>`(行首顶格或 `- ` 前缀)
     ——n≥2 且 gate=none 由 retro-check 第 7 检 FAIL:当批升门(gate 指向真实文件)或主理人显式 accepted(理由)。
   - **门效果审计(行为门的对偶面)**:本波编排位自造的每个门/上限/仪式写 typed 行 `GATE-AUDIT: <slug> hits=<真缺陷数> false=<误报 BLOCKED 数> action=<kill|keep(<理由>)>`
     ——hits=0 且 false≥2 默认 kill,keep 须写非空理由,否则 retro-check 第 8 检 FAIL;先问「门该不该在」,再谈校准阈值。
   - **淘汰同轮做**:会在动手那一刻 fire 的才留正文;hook 已强制的收成一行指针;从不 fire 的删或降
     README 背景(不 fire 的散文是净负债)。
4. **上下文治理**:只关本席位 `agentctl start` 派出且已交付完的会话,其他会话一律不动(会话账
   `/tmp/agent-watch-run` 与 tmux server 都是全席位共享,账内 ≠ 你的、不认识的名字一律不动,
   零派工记录 ≠ 全场可清;机器面 retro-check FOREIGN 行只报不杀,但账内他席位会话它不报——散文是
   该格唯一承重面)+ **扫孤儿**(见 SKILL §5「孤儿扫」纪律:`docker ps`/`ps`/后台 job + compose
   trap/finally + repro 禁裸 `while True`)+ **worktree 核对**(先核成果与证据保留;未合入先保全,已收货/合入且
   停全部写入者后,按 `agentctl/README.md` 的 `closeout` 流程收尾 linked worktree;不满足前提则保留并停报)+
   **base 对齐**(squash 集成仓的长驻 checkout:base 分支与 origin 分叉〔ahead 且 behind〕→ 核实
   ahead 内容已被 squash 合并后 backup ref + `reset --hard origin/<base>`;真未合并的工作先救——
   retro-check 1b 只检测告警,reset 归编排者)+
   **敞口清单**(=下会话入口;敞口要变下一批选题时走盘点仪式 `stocktake.md`,取舍判据单源在彼);本周期各会话的 ctx/req 读数见 retro-check 第 12 检。
5. **状态维护**:事实/下一步有变化才更新权威任务入口,不同步重写多份状态;完成的改动/测试查 Git/CI。纠正失效事实,保留真待裁事项(队列机制见 `decision-queue.md`)。治理文档 PREMISE 行须 0 DEAD(第 10 检实跑);第 11 检的归档候选只供人工裁决。
6. **memory 治理**:见下「memory 治理」。
7. **session 切换决策**:见下「session 切换决策」。

收尾跑 SKILL §5 的 **`retro-check.sh`**(FAIL / warning 项以脚本输出为准;warning 按任务语义人工裁决;脚本只验机械代理,不证复盘语义完成)。

**检查数据源**:`--docs` 默认 `docs`;第 7/8 检扫描其活动 Markdown,排除名为 `archive` 的目录及后代;第 10 检范围不变;第 11 检并扫未忽略的 orchestration/ 子目录。第 9 检保留 advisory phases 读数;`--ledger <path>` 仅兼容旧调用,不读取或要求人工账本。时间记录条件见 SKILL §2。
最小调用例(项目根运行,脚本路径按安装位置替换):`bash retro-check.sh --docs docs/orchestration`。

## memory 治理(步骤 6 展开)

- COMPLETED workstream 精简到 ≤10 行(结论 + 关键教训 + 指针),删掉过程细节。
- 事实性细节(路径 / 凭据 / 执行路径 / 导航步骤)沉淀到项目环境文档(如 `ACCESS.local.md`,
  由 `repo-governance-bootstrap` 生成),memory 只留指针;追加更正必须**同时改掉被推翻的原文**(append-only 是此类文档的主腐烂模式,腐的是指针类事实)。
- 重复 / 矛盾的 memory 合并或删除;已过时的 workstream 状态更新。
- MEMORY.md 是索引(一行一条,宿主只加载前 200 行 / 25KB,且不进非 fork 子 agent),条目按宿主四类 `user / feedback / project / reference` 落文件;索引行只留指针与一句 hook。

## session 切换决策(步骤 7 展开)

治理完评估当前上下文状态,**`/compact` 优先**(会话 id 不变、摘要自动、可 resume):接得上 > 省 token。

- **`/compact` 续跑**:默认路径。机械阈值:上下文 >300k / 请求、或预计等待 >1h → 收口即 `/compact`
  (成本 = 上下文体量 × 请求数;提醒触点在 `retro-hooks.json` 的 UserPromptSubmit 条目,本周期读数见
  retro-check 第 12 检)。
- **新 session + handoff**:只在压缩后仍需彻底清场时(角色 / 优先级切换、workstream 批次结束、等外部
  部署 / 验收)。
  写一次性 handoff 到 `/tmp/`(**不进 `docs/orchestration/`**——handoff 是 transient 交接产物,放治理
  SoT 会变又一个只生不死的死文件;持久状态归 ACTIVE_CONTEXT + memory,handoff 只快照运行时状态)。三件事:
  ① 待办队列(带状态 + session/worktree/branch 指针);② 活跃 tmux sessions 及其当前任务;
  ③ 需用户决策的 blocking 项。新 session 读 handoff + memory 冷启动,**读完即删**。

切换 / 压缩后的第一条回复先复述:在飞批次 / 待裁 / 下一步(开场指针触点 = `retro-reminder.sh` 的
SessionStart startup/clear,谓词 = 仓根 `docs/ACTIVE_CONTEXT.md` 存在)。
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