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/decision-queue.md

View on GitHub
# 主理人注意力与决策队列 — 降认知负载(principal cognitive-load offloading)

> 把"降低主理人认知负载"当**编排设计目标**,但不让主理人变甩手掌柜——承重决定仍归他。
> 这是 SKILL 铁律③(主理人持判断,不持状态)的操作化:不是每事问,而是把"该谁决"事先设计掉。
> 审批流与工作记忆是两种东西,拆开——**三档委派应下沉 harness 权限层,
> 队列文件只装人脑的判断题(🔴/💤)**。这是目标架构,不冒充当前通用实现:本 bundle 已落地的是
> 可选 freshness reminder 与已清区残留检查,尚无通用 T1 自动记账 / T2 deny;散文规则随长上下文稀释,
> 权限只有 harness 强制才算数。

## 架构:三层各归其位

| 层 | 装什么 | 载体(强制级别) |
|---|---|---|
| **权限层** | T0/T1/T2 三档委派的执行目标 | 按项目接 permission rules / hook;本 bundle 未完整实现 |
| **队列文件** | 🔴 需人拍板的判断题 + 💤 parked | markdown;可选 freshness reminder 只提醒、不阻断 |
| **工作记忆** | 🟡 在飞的事、进度 | ACTIVE_CONTEXT / 任务系统——**别在队列里养第二份** |

- **三档委派 → 权限层映射**(语义定义,落地现状见篇首):
  - **T0 直接做不烦他**(可逆、已授权、无价值判断)→ `allow` rules / acceptEdits。
  - **T1 做了+记一行(可否决)**→ `allow` + PostToolUse 自动记账。减负关键 = 多往 T1 挪、少用 T2 当同步闸。
  - **T2 动手前必问**(不可逆/对外、战略/优先级/钱/价值、有实质下行的真模糊)→ `ask`/`deny` rules + PreToolUse deny。
- **需要即时拍板的 ≤4 个问题**:用 harness 原生批量提问(如 AskUserQuestion,1-4 问 × 每问 2-4 选项,
  带推荐与默认),别一问一 turn 切碎注意力;**异步/不急的进队列**。
- 队列瘦身后只剩权限系统管不了的**判断题**。

## 队列机制(六件,编排者维护、对主理人零增量)

1. **单一决策队列**(GTD open-loops):`docs/DECISION_QUEUE.md`,编排者维护、主理人只读。
   - **完整性保证(信任前提,最承重)**:必须是**唯一**面、不在别处另存、不静默丢——否则他仍要自己记
     "有没有漏",offload 失效。
   - 每个 🔴 = 什么 / 为何归他 / 选项 / **我的推荐** / **静默默认** / **revisit 触发**。带推荐+默认让
     "决定"变"确认/微调"。
   - [ ] ALWAYS → 请示项写成**五要素人话**(对象:每个给主理人的决策项):①这是什么(人话 + 一个
     具体例子)②为什么要改 ③不改会怎样 ④改了收益多大 ⑤成本/杠杆一句话。内部代号/切片编号只进
     存档不进问句;整份请示持全局观、禁细节铺大饼(与 T0/T1/T2 正交——那管何时问,这管怎么问)。
   - **只存活跃项**:已处理项立即移出、不在 `RECENTLY CLEARED` 留正文(retro-check 第 4 检 FAIL · queue-freshness hook 提醒)。
   - 候选池行的价值密度标注格式单源在 `stocktake.md` 第 2 步,队列行可选采用
     (下游席位试运行实证改变过排序)。
2. **静默默认**:主理人没回 → **可逆按写明默认前进;不可逆一律 HOLD,永不自动越过**(这条不可破)。
3. **聚合绊线**:一串可逆小步累积成不可逆(lock-in / 蔓延花费 / scope drift)时升 T2 并点名。
4. **批处理 + 升级包**:不每事件 ping,攒到检查点成批给;每个 T2 带议题/影响/已做步骤/需你啥+推荐+默认。
5. **变化 + revisit**:事实/待决项变化时更新;HELD/💤 项到 revisit 触发点主动重浮,不为检查点改写未变状态。

## 已落地兜底(提醒,不冒充权限门)

- **平时 / 新上下文**:`queue-freshness.py`(SessionStart + UserPromptSubmit,wiring 真源
  `queue-hooks.json`,可选接入)检出已清区残留与 stale queue。SessionStart 每次冒泡,运行中提醒
  按 `QUEUE_NAG_INTERVAL_SECS` 节流(默认 1 小时)。hook 不删数据;它明确标注残留项已关闭,禁止再活化。
- **复盘检查**:`retro-check.sh` 对“已清区仍有正文”返回 blocking FAIL,不按队列年龄告警。队列里的事实句可跟一行 ``PREMISE: <claim> verify=`cmd` => rc=N``,第 10 检实跑;状态可信靠事实,不靠刷新日期。
- **为什么是提醒不是 Stop-block**:block 需要"本 turn 存在未记账 T2"的确定性信号,当前无此信号源——
  伪精确的门比诚实的提醒更糟(误拦 + Stop hook 8 次连 block 熔断)。若未来 T2 拦截落 marker 文件,
  可升级为门。

## 落在哪(三层治理,勿混)
- **队列实例**(含具体待决项)→ 项目 `docs/`(随项目走)。
- **本实践方法论** → 本 skill(跨项目沉淀,项目无关)。
- **编排者私有的"本项目决策/教训"** → memory(私有指针)。

## 队列模板(copy-paste 骨架,项目无关)
```markdown
# Decision Queue — <principal> 的 cockpit
> 🔴需你 / 💤parked / ✅已清(🟡在飞的事归 ACTIVE_CONTEXT,不在此维护)。我维护、你只读。
> 完整性保证:这是唯一面,不在别处另存、不静默丢。每🔴带推荐+静默默认;每💤带 revisit 触发。
> 聚合绊线:可逆累积变不可逆时我升🔴。事实/待决项变化才更新;revisit 到期重浮。Last updated: <date>.

## 🔴 NEEDS YOU
| # | 决定 | 为何归你 | 我的推荐 | 静默默认 | revisit 触发 |

## 💤 PARKED / GATED  | 项 | 为何 parked | revisit 触发 |
## ✅ CLEARED(保持为空;凭证在 git history)
```
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: 471kUpdated 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