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