用途
ce-help 用于在 Compound Engineering(CE)中为用户定位,弄清用户当前所处的工作阶段,推荐能推动其前进的命令,并说明推荐理由。目标是让用户能够自行运行或调整正确的操作,或判断某个技能是否值得使用,而无需进一步帮助。除非用户明确要求执行具体工作本身,否则不会代替用户启动任何 CE 工作流。
工作边界
- 推荐命令,运行交给用户。许多 CE 技能会调度多个智能体或调用其他模型提供商,相关花费由用户决定。
- 可以读取文件、执行只读的 git 与 PR 检查、获取公开文档。
- 不修改任何文件。
- 若消息请求的是实际工作而非建议(例如“用 CE 修复不稳定的登录测试”,或用户同意你的推荐),则调用合适的技能直接执行。对于标记为 manual 的技能,智能体无法自行启动,需把调用形式交给用户自行输入。
问题路由
按问题类型查阅以下参考:
- 哪个技能负责某项工作、某技能做什么、是否值得使用:references/skill-map.md
- 从哪里开始、接下来做什么、技能之间如何衔接、是否使用 lfg:references/workflow.md,以及下文循环部分
- 安装、入门、费用、将 CE 适配到项目:references/starting-and-running.md
- 出现故障或意外:references/troubleshooting.md;若疑似 CE 缺陷且其中无对应条目,提交至 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>
在组合任何产物路径前,先确定 <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>,使用本技能自己的子目录,且不再读取 docs。
本技能仅在回答需要产物文件夹时解析 <root>,且不创建任何内容:文件夹缺失意味着尚无产物。无效的 docs_root 只中止该查找,报告问题并回答其余部分。Sources 下的 docs/ 路径是公开页面,不是产物路径。
资料来源
本技能中的参考只包含路由和稳定边界,不描述各技能的具体运作方式。每个技能的描述与指南页面拥有最终解释权,若与参考冲突以它们为准。上下文中缺失某技能不构成冲突,因为宿主常省略 manual 技能,且可能截断长列表。
不要凭对 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)上,manual 技能用 /skill:<name>,其余用默认形式。在 Devin 上使用 /compound-engineering:<skill>。只打印一种形式。
- 开头给出推荐及为何适合当前情况。
- 随后在有命令可运行时给出一个可直接运行的代码块命令;若选择取决于用户偏好,则为每个选项各给一个,填入用户细节:目标及如何判断完成,而非步骤列表,因为技能自带步骤。对于构建或修复类命令,若用户未提供完成校验,使用占位符。其他命令无需完成校验。
- 结尾附上支撑该建议的页面链接。
- 省略不影响用户行动的检出发现。仅在用户要求时展示完整地图。
适用场景
不确定该用哪个 CE 技能、不知从何开始、需要了解技能衔接、排查故障、了解安装/配置/费用,或在循环中定位下一步时使用。