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/dispatch-baseline.md

View on GitHub
# 派工基线纪律 + 收工核证(编排者侧规程)

> SKILL.md §1 step1(基线纪律)+ step6(收工核证)的展开。**受众是编排者,不是 worker**——
> 前半发生在 goal 存在之前(开基线),后半发生在 worker 自报 done 之后(独立核证),
> 都不属于 goal 合同:塞进合同 = 让执行者替编排者守门,恰好废掉"完成状态不由执行者自报"这道防线。
> worker 侧合同见 `goal-template.md`(本文产出它 header 里的 `cut from latest origin/<base> @ <sha>`)。
> 权威 git 细节见你的 Git 协作规范(evolab 公开镜像 `git-workflow-standard`);这里只留编排基线。

## 基线纪律(fetch + 检查,按需 rebase,集成用 squash)

派工基线四件(`agentctl start` 前编排位亲自做完):

1. **fresh worktree @ 最新远端 base**:`git fetch` 后
   `git worktree add ../wt-<name> -b feat/<name> origin/<base>`——不让 agent 在过期基线开工;多席在飞时不用 `git stash`(仓级共享、穿透 worktree 隔离)切基线,对照用一次性 worktree(guard ㉒ WARN)。
2. **构建/依赖就绪**(venv、node_modules 等按该仓声明)——席位开工即能跑测试,不烧轮装环境。
3. **播种即 seed commit**:编排位播进 worktree 的文件(goal/评审档等)先落 commit、非交付件放伞仓 docs/——untracked 即脏树,席位清洁门直接 STOP(guard ⑭:`agentctl start` 时 cwd porcelain 非空 → DENY)。
4. **主 checkout 不在核对面**:goal 固定句「基线核对只针对你自己的 worktree;主 checkout 与
   本地 <base> 分支不在核对面、不得要求 fast-forward」——squash 集成仓的主 checkout 必然
   分叉,席位拿它判 BLOCKED / 要求 fast-forward 全是误报(下游席位 n=3)。

- **rebase 条件动作 / 集成默认 squash(merge-commit 仅长驻集成分支批式 PR)**:base 没动不 rebase;动了且与
  改动重叠才 rebase(或 merge base 进来)——判据细节与合后 ancestry 陷阱归你所在仓的 Git 协作
  规范,此处不复读。编排位只记一条:多会话并发时 base 常被别的 PR 推进,
  **`git fetch`+检查这一步省不得**(省了才会在过期基线上 PR)。
- **同 cwd 起第二席前先收割 BLOCKED.md**(读取归档后删除)——前席遗留会让新席拒动他席文件而卡死(guard ⑮:`agentctl start` 时 `<cwd>/BLOCKED.md` 存在 → DENY)。
- **路径闭集派前枚举 use site**:闭集由设计视角写出会漏第三处引用——派前对交付项触碰的符号
  `rg` 枚举 use site,闭集 ⊇ 命中。
- **只读 scout/audit/Explore 也算"开工"**:经 Agent 工具派出时**静默继承编排者 cwd**(常是落后的主
  checkout、非新 worktree)→ 对着过期基线出"幻影发现"(删了的看着还在、已合的看着没合)。派 scout
  **显式指到新 worktree**,可疑结论再**对 base ref 复核**(`git show origin/<base>:<path>` / `git grep`);guard-agent P0e 对派往落后 upstream 的树 WARN(见 agentctl README)。

## 收工核证四件套(SKILL §1.6 验收原则的操作化;四件套定义在此)

1. 读 DONE 行行尾 `dirty=<N>`:`>0`、或**字段缺席**(未判定:cwd 非 git 树 / 探针失败)才手跑
   `git status -s`(执行 agent 常"声称完成没 commit";**评审审合同不审过程卫生,
   这件永远归编排位**——别为此往 goal 合同里塞自守门条款)。
2. `git log origin/<base>..HEAD` 与声明一致(多了 = 夹带,少了 = 没交)。
3. 独立复跑 test+lint——不吃 worker 转述的结果。
4. 测试计数用 `grep -E 'passed|failed'`,别信被截断的点行。
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