关于 ce-plan
ce-plan 是一项技术规划技能,用于将已商定的工作整理为计划,而不负责实施。它涵盖调研、技术决策、计划撰写、审查和后续交接。
主要功能
- 01选择计划输出契约
- 02调研并确定技术方案
- 03撰写和审查计划
- 04提供后续步骤交接
适用场景
- 01在实施前规划软件变更
- 02准备可持续维护的技术计划
- 03将已确定的方案转为执行步骤
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill ce-plan安装后在 Claude Code 中输入/ce-plan确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/approach-altitude.mdbakeoff.mddeepening-workflow.mdfinal-review.mdhtml-rendering.mdintake.mdmarkdown-rendering.mdoutput-contracts.mdoutput-mode.mdplan-handoff.mdplan-sections.mdreasoning-elevation.mdresearch.mdresume.mdsettled-decisions.mdstructure.mdreferences/agents/agent-native-planning-strategist.mdarchitecture-strategist.mdbest-practices-researcher.mddata-integrity-guardian.mdframework-docs-researcher.mdgit-history-analyzer.mdlearnings-researcher.mdpattern-recognition-specialist.mdperformance-oracle.mdrepo-research-analyst.mdsecurity-sentinel.mdslack-researcher.mdspec-flow-analyzer.mdweb-researcher.md详细介绍
创建技术计划
当前年份为 2026 年。
目标: 制定一份计划,用于执行并检查已商定的工作,同时保留其目标和约束。根据证据解决技术选型;已有的充分说明保持不变。ce-brainstorm 定义要做什么,ce-plan 规划如何做,ce-work 负责执行。之前的头脑风暴不是必需的。
明确调用始终会生成计划。 切勿将直接调用归类为“非规划任务”并转交出去。它可以选择以下任一输出约定;最精简的有效计划也可以只是聊天中的几句话。
研究、决策并编写计划——绝不实施。 不要编写生产代码、运行测试,也不要从执行期间的结果中获取经验。可以用方向性的伪代码和语法草图来传达设计;通过修改代码观察结果属于 ce-work 的工作。
强制完成约定
当输出约定的完成条件得到满足时,本次运行即告完成。凡是生成了计划文档或检查点的常规交互分支,在询问用户接下来要做什么之前,都不算完成。请求中已授权下一步操作的内容,就视为用户已给出答复。对于通过恢复检查后继续执行的持久化软件实现计划,本次运行只有在已展示 Phase 5.4 菜单且所选操作已实际触发时才算完成。对于 Direct,需说明变更并提供交接选项;对于 Chat brief,需在聊天中提供简报,并附上一行保存或转交 ce-work 的选项。两者都不展示 Phase 5.4 菜单。非软件计划和方法级计划以其参考工作流规定的交接结束。若本次运行只回答问题,除非参考流程要求保存或分享步骤,否则回答后即可结束。
写入文件、检查置信度,以及运行或明确跳过 ce-doc-review 都只是中间里程碑。在流水线模式下,只有当计划、置信度检查和非交互式文档审查状态都已返回给调用方后,本次运行才算完成;后续操作由调用方决定。
交互方式
通过当前工具列表中主机提供的阻塞式提问工具,一次只提一个问题。根据功能匹配;切勿为发现工具而探测面向用户的工具。如果列表中没有此类工具,或实际的问题调用出错,则在聊天中列出带编号的选项;切勿静默跳过必需的问题。如果未提供功能描述,则询问要规划什么并等待答复。
输出约定
在范围界定开始时(Phase 0.6)决定适用哪种输出约定,且必须在选择深度和撰写范围界定综合内容之前完成。仅当没有触发恢复路径(Phase 0.1),且来源检查(Phase 0.2)未发现上游文档时,才适用此约定。在不分派子 Agent 的前提下,对请求中提及的内容进行有限的内联读取,并据此选择以下一项:
- Direct — 工作可在一轮中说明、完成并验证,且不存在用户需要权衡的决策。用几句话说明变更,并提供交接给
ce-work或用户的选项;只有获得实施授权后才能开始执行,具体定义见references/output-contracts.md。 - Chat brief — 范围明确的工作,至多包含一个用户需要权衡的决策,且不存在风险面。在聊天中提供简报并停止。
- Durable — 其他所有情况。继续执行以下工作流。
references/output-contracts.md 定义了 Direct 和 Chat brief;选择其中任一项时都应阅读该文件。若阅读后仍无法确定层级,则选择更重的层级。如果阅读过程中发现用户需要权衡的决策、风险面或多轮验证,则在输出任何内容之前转为更重的层级。无论规模大小,以下情况都属于 Durable:本轮没有同步在线用户可在聊天中采取行动(流水线、无头模式、由目标或调度器驱动);请求措辞要求提供计划、计划文件或指定输出格式;请求要求继续现有计划中的某个事项;以及存在风险面——身份验证、支付、迁移、外部契约。
工作流
各阶段按顺序运行,除非某个引用将流程引向其他路径或提前结束。进入某个阶段时,须完整阅读该阶段要求的引用;在进入该阶段前阅读过,不算满足要求;最后步骤中指定的引用,到了相应步骤时也须重新阅读,即使此前已在上下文中。如果无法读取必需的引用,须在执行其所管辖的操作前停止,并报告阻碍因素和恢复路径;绝不可凭记忆重构缺失的规则。在流水线模式下,每次必需引用读取失败都须返回 status: blocked、phase、blocker 和 recovery_path;如果已有产物,还须包含 artifact_path 并保留该产物。即使已有产物,也须报告为阻塞。
阶段 0:输出、恢复与范围
- 先处理输出。 在解读任何阶段之前,先阅读
references/output-mode.md。该文件定义令牌解析、输出与确认的优先级、渲染器选择、产物位置,以及何时可以解析仓库。 - 恢复、深化、方法与领域。 执行前先阅读
references/resume.md。该文件定义如何恢复现有计划、丰富仅包含需求的计划、深化计划、进行方法层级规划,以及软件/非软件的分流。遵循其选择的任何终止路径;否则继续。 - 来源与范围。 在阶段 0.2 之前阅读
references/intake.md,并遵循其中流程直至阶段 0.7。该文件定义如何查找并保留上游产物、转入引导工作、处理阻塞性问题、确定深度和具名资源,以及综合规划范围;上述输出契约决定在其中处理。不得跳过尚未解决的决策点。
阶段 1-4:研究与撰写
- 收集上下文前先阅读
references/research.md。 - 解决问题或规划结构前先阅读
references/structure.md。 - 根据
references/plan-sections.md和output-mode.md选定的格式渲染参考资料撰写。
阶段 5:审查、写入、深化与交接
- 预写审查前先阅读
references/final-review.md;该文件定义阶段 5.1 至 5.3.2。以头脑风暴为起点的交互式运行中,写入前须在聊天中向用户展示阶段 5.1.5 的范围综合:等待确认,或一行自动继续公告。 - 模型能力提升。 撰写前立即阅读
references/reasoning-elevation.md,在此边界处确定选择并遵循。激活状态确认完成,且所选调度或透明回退已确定之前,不得撰写。 - 在流水线模式下,若有证据表明会话早先确定的决策已失效,须停止写入。返回准确令牌
settled-decision-invalidated、该决策及原因;不得默默重新确定。 - 先写入计划,再展示选项,然后完成
final-review.md定义的置信度流程。
停止。在阶段 5.3.8 和 5.4(文档审查与交接菜单)之前,立即阅读 references/plan-handoff.md。 Durable 计划必须进行文档审查,默认采用非交互模式(mode:non-interactive)。在交互式软件运行中,须逐字询问:"Plan ready at <absolute path to plan>. What would you like to do next?" 展示其菜单并等待。如果用户在后续轮次才给出选择,执行前须重新加载 references/plan-handoff.md。渲染菜单、收到选择或宣布路径,都不算完成;须执行所选操作。