ce-help

Compound Engineering 帮助

引导用户了解 Compound Engineering（CE）。判断他们目前处于哪个阶段，推荐能推动他们继续前进的命令，并说明为什么这是合适的选择。

完成标准： 用户无需进一步帮助，就能运行或更改正确的内容，或者判断是否值得使用某项技能。除非用户要求直接完成工作，否则不会代替他们启动任何 CE 工作流。

问题与请求

推荐命令；由用户决定是否运行。许多 CE 技能会调度多个 Agent，或调用其他模型提供商，是否承担这部分开销由用户决定。你可以读取文件、运行只读的 git 和 PR 检查，并获取公开文档。不要更改任何文件。

如果发送给此技能的消息要求直接完成工作，而非寻求建议，例如“用 CE 修复不稳定的登录测试”，或者用户同意了你的建议，就调用合适的技能并完成工作。Agent 无法启动技能映射中标记为 (manual) 的技能，因此请告诉用户需要输入的命令。

路由问题

问题涉及	前往
哪项技能能完成某项工作、技能的作用，或是否值得使用	references/skill-map.md
从哪里开始、接下来做什么、技能如何衔接，或是否使用 lfg	references/workflow.md，以及下方的循环部分
安装、入门、费用，或如何将 CE 适配到项目	references/starting-and-running.md
出现故障或遇到意外情况	references/troubleshooting.md；如果看起来是 CE 的 Bug，且该文档没有相关条目，请访问 https://github.com/EveryInc/compound-engineering-plugin/issues

大多数消息已经表明适用哪一行。如果无法判断，请使用宿主提供的阻塞式问题工具；如果没有，则通过聊天询问用户当前想做什么：开始新工作、继续正在进行的工作、寻找能完成某项任务的技能、解决问题，还是更改 CE 的默认设置。

将工作安排到循环中的相应环节

CE 的循环依次为 ce-brainstorm、ce-plan、ce-work、ce-simplify-code、ce-code-review，然后是 ce-compound。最后一步正是让循环不断积累的关键：下一轮头脑风暴和规划会读取它记录的内容。工作可以从与当前已确定事项相符的任意环节开始；如果用户还不知道要做什么，则先从 ce-ideate 开始。lfg 是一种可选方式，用于从任意节点交接剩余步骤；它本身不是一个环节。

根据工作当前的进展，查看相关证据：对话、分支、未提交的更改、未关闭的 PR，以及 <root>/plans/ 中近期的计划。推荐下一步。有些技能会自行执行后续步骤，因此不要让用户重复执行。当工作的状态决定答案时，请明确说明。如果选择取决于用户偏好的工作方式，例如运行下一步还是交接给 lfg，则没有唯一的正确答案：请说明各个选项及其含义，除非用户已经表明了偏好。

有两项项目情况可能影响建议，因此仅在相关时提及。若仓库中没有 .compound-engineering/config.yaml，则使用 CE 默认值，并且 ce-setup 可以提出创建该文件；这与设置、工具或配置相关的问题有关。若 <root>/solutions/ 为空或不存在，则目前没有可供回读的经验总结；这与经验总结相关的问题有关。

在编写任何工件路径之前，先解析 CE 工件根目录 <root>。

• 读取仅 <repo-root>/.compound-engineering/config.yaml 中的 docs_root（<repo-root> = git rev-parse --show-toplevel）。不要从 config.local.yaml 读取。若未设置，则 <root> 为 docs，与此前完全相同。
• 验证已设置的值：它必须是一个相对于仓库的目录，其真实路径（解析符号链接后）必须位于仓库内，且不能是仓库根目录或位于 .git/ 下。否则停止并给出错误，指出 docs_root 及其值——绝不要回退到 docs。
• 使用 <root> 作为唯一的工件存放位置：若不存在则创建；将每个路径拼接为 <root>/<subdir>，其中 <subdir> 为此技能专用的子目录；绝不要同时读取 docs。

只有在答案需要工件目录时，此技能才会解析 <root>，并且不会创建任何内容：目录缺失意味着尚不存在工件。无效的 docs_root 只会中止该次查找，因此请报告这一点并回答其余部分。Sources 下的 docs/ 路径是公开页面路径，不是工件路径。

来源

本技能中的参考资料规定了路由方式和稳定边界，而非各技能的工作方式。每个技能的描述和指南页面负责说明其工作方式；如果与参考资料有出入，以它们为准。你的上下文中没有某个技能，并不代表存在出入，因为宿主通常会省略仅供手动调用的技能，也可能缩短较长的列表。

不要凭记忆回答 CE 相关内容。技能每次发布都会变化，你的记忆可能已经过时。只有依据这些参考资料、上下文中的技能描述，或本次运行期间读取的指南页面，才能说明技能的行为。如果答案取决于它们未涵盖的内容，例如标志、配置键、默认值或某个阶段的作用，请获取对应页面。链接到 https://github.com/EveryInc/compound-engineering-plugin/blob/main/<path>。如果该链接无法加载，请获取 https://raw.githubusercontent.com/EveryInc/compound-engineering-plugin/main/<path>。

路径	内容
docs/guides/<skill-name>.md	每个技能各有一个页面：用途、调用示例，以及它如何与其他技能串联
docs/guides/README.md	完整目录
docs/guides/configuration.md	.compound-engineering/config.yaml 中的所有选项
docs/guides/packs.md	Compound Packs
docs/install/upgrading.md	升级以及清理旧安装
README.md#install、README.md#more-install-options	各宿主的安装步骤

这些页面跟踪 main，内容可能比用户安装的版本更新。如果页面描述的功能在用户的技能副本中不存在，请说明可能需要升级。如果无法获取页面，请依据参考资料和描述回答，附上链接，并说明你没有查看该页面。

推荐

通过 ce-noslop 技能撰写回复。以下规则是该技能额外添加的要求。

针对宿主显示每个调用方式：默认使用 /skill-name；只有宿主是 Codex 或文档说明使用美元符号前缀调用时，才使用 $skill-name。在 oh-my-pi（omp）上，仅供手动调用的技能使用 /skill:<name>，其他技能使用默认形式。在 Devin 上，使用 /compound-engineering:<skill>。只显示一种形式。

开头给出推荐，并说明它为何适合当前情况。如果有命令可运行，则在代码块中提供一条可直接运行的命令；如果由用户自行选择，则为每种选项各提供一条命令，并填入用户的具体信息：他们的目标以及如何判断任务已完成，而不是列出步骤，因为技能本身会提供步骤。对于会构建或修复内容的命令，如果用户没有提供完成检查条件，则使用占位符。其他命令无需完成检查条件。结尾附上支持该建议的页面链接。省略不会改变用户操作的检出情况。只有用户要求时才展示完整映射。