规划与执行
四个把产品决策转化为可运行代码的技能:ce-plan(设计 HOW)、ce-doc-review(多人格审查)、ce-work(实施)、ce-worktree(隔离)。
家族概览
本族处于实施边界。ce-plan 产出可被 worker 拿来执行的产物;ce-doc-review 在提交前证明它;ce-work 实施它;ce-worktree 在必要时隔离工作区。
ce-plan
目的:设计 HOW 如何构建。三种输出契约(Phase 0.6):Direct / Chat brief / Durable。不确定时取更重的那种。
Durable 是强制的
当满足以下任一条件:无头 / 流水线 / 用户要求“plan” / “plan file” / “output format” / 续接既有计划条目 / 风险面(认证、支付、迁移、外部契约)。
5 个阶段
| 阶段 | 先读 |
|---|---|
| 0 | references/output-mode.md、references/resume.md、references/intake.md |
| 1-4 | references/research.md、references/structure.md、references/plan-sections.md |
| 5 | references/final-review.md、references/reasoning-elevation.md、references/plan-handoff.md |
Phase 5.3.8 — 文档审查关
强制:调用 ce-doc-review mode:non-interactive <plan-path>。即便在流水线模式下也不例外。若不可用,记录一条结构化的占位结果,含 skipped_reason: skill_unreachable。
Phase 5.4 菜单
仅交互模式;流水线返回结构化审查结果并停止。最多 5 个选项:启动 ce-work(推荐) / 以 /goal 方式运行 / 处理审查的待办项 / 原型化一个仍待感受的问题 / 创建 Issue / 在浏览器中打开(仅 HTML)。通用规划 / 求答 / 仅需求类产物跳过执行选项。
References(18 文件、16 个代理、约 4,651 行 — 最大技能)
包含与 ce-brainstorm + ce-ideate 共享的 html-rendering.md(638 行)与 markdown-rendering.md(242 行);与 ce-brainstorm 共享的 settled-decisions.md(45 字节,受一致性校验保护)。approach-altitude.md 用于“计划的计划”流。deepening-workflow.md 用于信心检查深化。reasoning-elevation.md 用于 5.3.7 处的模型提升边界。
ce-doc-review
目的:对计划/规格的多人格审查。始终运行 coherence-reviewer + feasibility-reviewer。可选运行 adversarial / product-lens / security-lens。
阶段
- 获取并分类文档(先在磁盘上核实)。
- 分派审查者(有界并行;容量拒绝 = 背压)。
- 若有 trio 人格触发,进行跨模型判断。
- 综合 +(编排器在授权范围内应用修正)。
- 走查与交接(交互式)或结构化返回(非交互式)。
8 个人格
coherence-reviewer · feasibility-reviewer · adversarial-document-reviewer · product-lens-reviewer · security-lens-reviewer · design-lens-reviewer · scope-guardian-reviewer · whole-doc-reviewer(仅跨模型)。
References(15 文件、8 个人格、1 个 schema)
references/document-intake.md(44)references/dispatch.md(52)references/persona-selection.md(41)references/cross-model-review.md(185)— 累加式,不阻塞references/synthesis-and-presentation.md(343)references/walkthrough.md(347)— 仅交互references/bulk-preview.md(146)— 仅交互references/open-questions-defer.md(158)references/rendering-floor.md(175)— 跨场景共享references/findings-schema.json(85)— JSON schema
ce-work
目的:端到端执行计划。独立模式:实施 + 验证 + 发布收尾。返回调用者模式:仅实施 + 验证;调用者(lfg)负责发布。
阶段
| 阶段 | 做了什么 |
|---|---|
| 0 | 输入分流:先激活恢复路径。references/input-triage.md。 |
| 1 | 快速启动:工作区 + 引擎 + 策略。 |
| 2 | 执行:内联 / 串行 / 并行。平凡路径跳过任务列表。 |
| 3-4 | 质量检查 + 收尾(仅独立模式):simplify + review + commit + PR + babysit。 |
硬约束
- 独立模式:在 commit/push 时,必须先有真实的
ce-code-review回执。没有它,运行未完成。 - 返回调用者模式:永远不做 simplify / review / PR / babysit。这些归调用者。
- 平凡路径 = 1-2 个文件 + 无行为变更 → 跳过任务列表(仍先解决引擎)。
- 提交范围:每个实施提交只声明自己的文件。禁止
git add -A/.。禁止裸git commit。
返回调用者 schema(必填字段全列)
status(complete/blocked/failed)、plan_path、changed_files、u_ids_attempted、u_ids_completed、verification_results、verification_evidence、implementation_engine_binding、requested_route、actual_route、requested_model、actual_model、fallback_reason、run_id、source_kind、source_digest、unit_receipts、plan_checkpoint、blockers、recovery_path、settled_decision_conflicts、behavior_change、standalone_shipping_skipped: true。
引擎(4 种)
- Native — 编排器自己的上下文。平凡工作的默认。
- Cross-model goal mode — 经由
scripts/cross-model-work.sh(988 行)的 CodeX / claude / grok。 - Cross-model dynamic workflow — 用于需要定制工作流形态的计划。
- 外部实施 worker —
scripts/agents/implementation-worker.md。
References(14 文件、2 个代理)
references/input-triage.md(50)references/workspace-setup.md(27)references/execution-engines.md(161)references/cross-model-execution.md(137)references/cross-model-work-eval.md(105)references/execution-strategy.md(73)references/implementation-loop.md(163)references/non-code-execution.md(23)references/return-to-caller.md(32)references/review-findings-followup.md(91)references/shipping-workflow.md(133)references/tracker-defer.md(150)— 与 lfg 共享references/work-intake.md(52)references/implementation-result-schema.json(52)
脚本:scripts/cross-model-work.sh(988 行)、scripts/unit-workspace.py(215 行)+ 5 个库模块(约 4,073 行总计)。
ce-worktree
目的:建立隔离的 git worktree — 为新工作创建新分支,或将 worktree 附加到既有引用。极简技能:仅有 SKILL.md,无 references/。
3 个步骤
- 检测既有隔离 — 比较
git rev-parse --absolute-git-dir与(cd "$(git rev-parse --git-common-dir)" && pwd -P);不同 = worktree(或 submodule)。submodule 视作非隔离。 - 优先使用原生 worktree 工具 — 主机的
EnterWorktree、/worktree或--worktree标志。永不 偷偷执行git worktree add。 - Git 兜底 —
git worktree add -b <branch> .worktrees/<branch> origin/<from-branch>。分支名由工作描述派生;永不采用不透明名。
硬规则
- 一个分支,一个 worktree:若目标分支已在别处签出,不要 创建第二个;上报 "
already checked out at <path>",由调用者决定。 - PR worktree 陷阱:
FETCH_HEAD是 detached 的,会让 fix-loop 提交变孤儿。先用git fetch origin pull/<n>/head:pr-<n>,再用git worktree add .worktrees/pr-<n> pr-<n>。若要跟踪推送,使用--detach+gh pr checkout <n>。 - .worktrees/:首先应加入 .gitignore。用
git check-ignore -q .worktrees/(带尾斜杠)探测。未忽略则加入.gitignore。 git worktree add上的权限/沙箱错误:报告失败;提供 “在当前 checkout 中工作” 与 “停下并解决” 二选一。
跨技能边界
| From | To | 何时 |
|---|---|---|
| ce-plan | ce-doc-review | Phase 5.3.8 — Phase 5.4 之前强制 |
| ce-plan | ce-bakeoff | 可选的方案级规划 |
| ce-plan | ce-work | Phase 5.4 菜单选项 1(默认) |
| ce-doc-review | ce-brainstorm / ce-plan | 文档接收时被分类为统一计划或需求 |
| ce-work | ce-code-review | 独立发布(Step 4) |
| ce-work | ce-simplify-code | 独立发布(Step 3) |
| ce-work | ce-commit-push-pr | 独立发布(Step 9) |
| ce-work | ce-commit | 本地留守路径(debug 的本地修复路径) |
| ce-worktree | (被使用于) | ce-work、ce-dogfood、lfg(经由 ce-work 的工作区设置) |