mcpField
C
ce-plan

ce-plan

github.com/everyincAgent 工作流25.8k3.8k 次安装今天更新
代码仓库

关于 ce-plan

ce-plan 是一项技术规划技能,用于将已商定的工作整理为计划,而不负责实施。它涵盖调研、技术决策、计划撰写、审查和后续交接。

主要功能

  1. 01选择计划输出契约
  2. 02调研并确定技术方案
  3. 03撰写和审查计划
  4. 04提供后续步骤交接

适用场景

  1. 01在实施前规划软件变更
  2. 02准备可持续维护的技术计划
  3. 03将已确定的方案转为执行步骤

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/everyinc/compound-engineering-plugin --skill ce-plan

安装后在 Claude Code 中输入/ce-plan确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
approach-altitude.md
bakeoff.md
deepening-workflow.md
final-review.md
html-rendering.md
intake.md
markdown-rendering.md
output-contracts.md
output-mode.md
plan-handoff.md
plan-sections.md
reasoning-elevation.md
research.md
resume.md
settled-decisions.md
structure.md
references/agents/
agent-native-planning-strategist.md
architecture-strategist.md
best-practices-researcher.md
data-integrity-guardian.md
framework-docs-researcher.md
git-history-analyzer.md
learnings-researcher.md
pattern-recognition-specialist.md
performance-oracle.md
repo-research-analyst.md
security-sentinel.md
slack-researcher.md
spec-flow-analyzer.md
web-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:输出、恢复与范围
  1. 先处理输出。 在解读任何阶段之前,先阅读 references/output-mode.md。该文件定义令牌解析、输出与确认的优先级、渲染器选择、产物位置,以及何时可以解析仓库。
  2. 恢复、深化、方法与领域。 执行前先阅读 references/resume.md。该文件定义如何恢复现有计划、丰富仅包含需求的计划、深化计划、进行方法层级规划,以及软件/非软件的分流。遵循其选择的任何终止路径;否则继续。
  3. 来源与范围。 在阶段 0.2 之前阅读 references/intake.md,并遵循其中流程直至阶段 0.7。该文件定义如何查找并保留上游产物、转入引导工作、处理阻塞性问题、确定深度和具名资源,以及综合规划范围;上述输出契约决定在其中处理。不得跳过尚未解决的决策点。
阶段 1-4:研究与撰写
  1. 收集上下文前先阅读 references/research.md。
  2. 解决问题或规划结构前先阅读 references/structure.md。
  3. 根据 references/plan-sections.md 和 output-mode.md 选定的格式渲染参考资料撰写。
阶段 5:审查、写入、深化与交接
  1. 预写审查前先阅读 references/final-review.md;该文件定义阶段 5.1 至 5.3.2。以头脑风暴为起点的交互式运行中,写入前须在聊天中向用户展示阶段 5.1.5 的范围综合:等待确认,或一行自动继续公告。
  2. 模型能力提升。 撰写前立即阅读 references/reasoning-elevation.md,在此边界处确定选择并遵循。激活状态确认完成,且所选调度或透明回退已确定之前,不得撰写。
  3. 在流水线模式下,若有证据表明会话早先确定的决策已失效,须停止写入。返回准确令牌 settled-decision-invalidated、该决策及原因;不得默默重新确定。
  4. 先写入计划,再展示选项,然后完成 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。渲染菜单、收到选择或宣布路径,都不算完成;须执行所选操作。

评论

支持 Markdown