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