技能家族 · 级别:参考

规划与执行

四个把产品决策转化为可运行代码的技能: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 个阶段

阶段先读
0references/output-mode.md、references/resume.md、references/intake.md
1-4references/research.md、references/structure.md、references/plan-sections.md
5references/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(推荐) / 处理审查的待办项 / 原型化一个仍待感受的问题 / 创建 Issue / 在浏览器中打开(仅 HTML)。通用规划 / 求答 / 仅需求类产物跳过执行选项。

References(19 文件、14 个代理、约 4,900 行 — 最大技能)

包含与 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 处的模型提升边界。publishing.md 用于发布副本——只投用户点名的发布方,本地文件仍是记录。

ce-doc-review

目的:对计划/规格的多人格审查。始终运行 coherence-reviewer + feasibility-reviewer。可选运行 adversarial / product-lens / security-lens。

阶段

  1. 获取并分类文档(先在磁盘上核实)。
  2. 宣布本次评审团队(简短、各条件人格给一句理由),然后保持安静直到结果齐;分派时把各自的人格文件路径交给它。
  3. 若有 trio 人格触发,进行跨模型判断。
  4. 综合 +(编排器在授权范围内应用修正)。
  5. 走查与交接(交互式)或结构化返回(非交互式)。交互式走查 = 路由问题 + 逐条发现走查 + 完成报告;批量预览只服务走查里的自动处置。

8 个人格

coherence-reviewer · feasibility-reviewer · adversarial-document-reviewer · product-lens-reviewer · security-lens-reviewer · design-lens-reviewer · scope-guardian-reviewer · whole-doc-reviewer(仅跨模型)。scope-guardian-reviewer 的机制定尺双向生效:既建议把没人要求的机制挪进「考虑过但不构建」清单,也改判「被计划收窄的请求行为」——对请求所要求部分的延迟、门控、封顶或跳过,除非满足可论证的危害条件,否则建议按请求原样规划。

References(15 文件、8 个人格、1 个 schema)

脚本:scripts/cross-model-doc-review.sh(1,086 行)— 跨模型评审的 peer 统一经被钉住的 acpx@0.19.5 传输路由,文档已嵌入提示、peer 不再从磁盘重读。

ce-work

目的:端到端执行计划。独立模式:实施 + 验证 + 发布收尾。返回调用者模式:仅实施 + 验证;调用者(lfg)负责发布。

阶段

阶段做了什么
0输入分流:先激活恢复路径。references/input-triage.md。
1快速启动:工作区 + 引擎 + 策略;外部 worker 的 reasoning_effort 从配置读。
2执行:内联 / 串行 / 并行;链式 unit 一律 inline 跑完,无 /goal 旁路;增量 commit 消息风格。平凡路径跳过任务列表。
3-4质量检查 + 收尾(仅独立模式):simplify + review + commit + PR + babysit。

硬约束

返回调用者 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 种)

References(15 文件、2 个代理)

脚本:scripts/cross-model-work.sh(1,150 行,经被钉住的 acpx@0.19.5 传输路由 peer)、scripts/unit-workspace.py(215 行)+ 6 个库模块(约 4,590 行总计)、scripts/packs-resolve.py(解析项目声明的 Compound Packs)。

ce-worktree

目的:建立隔离的 git worktree — 为新工作创建新分支,或将 worktree 附加到既有引用。极简技能:仅有 SKILL.md,无 references/。

3 个步骤

  1. 检测既有隔离 — 比较 git rev-parse --absolute-git-dir 与 (cd "$(git rev-parse --git-common-dir)" && pwd -P);不同 = worktree(或 submodule)。submodule 视作非隔离。
  2. 优先使用原生 worktree 工具 — 主机的 EnterWorktree、/worktree 或 --worktree 标志。永不 偷偷执行 git worktree add。
  3. Git 兜底 — git worktree add -b <branch> .worktrees/<branch> origin/<from-branch>。分支名由工作描述派生;永不采用不透明名。

硬规则

跨技能边界

FromTo何时
ce-plance-doc-reviewPhase 5.3.8 — Phase 5.4 之前强制
ce-plance-bakeoff可选的方案级规划
ce-plance-workPhase 5.4 菜单选项 1(默认)
ce-doc-reviewce-brainstorm / ce-plan文档接收时被分类为统一计划或需求
ce-workce-code-review独立发布(Step 4)
ce-workce-simplify-code独立发布(Step 3)
ce-workce-commit-push-pr独立发布(Step 9)
ce-workce-commit本地留守路径(debug 的本地修复路径)
ce-worktree(被使用于)ce-work、ce-dogfood、lfg(经由 ce-work 的工作区设置)