ghost-exo

exo

exo 工作流生命周期的统一入口。此技能是一个路由器。它会将请求归类为三种意图之一，加载共享底层内容，然后加载匹配的意图方案并遵循其步骤。

前提条件

Exo 是一个 Agent 工作流平台。每种意图都会通过 exo MCP 服务驱动它。

选择连接

通常会同时存在多个 exo 连接，每个工作区一个，有时同一部署上也会有多个连接。开始任何操作之前，先枚举本次会话中的 exo MCP 服务。

如果恰好有一个连接，就使用它。如果有多个连接，请通过结构化提问工具询问用户选择哪个，并暂停操作，直到用户作出回答，因为选错连接会将内容写入错误的工作区。执行某种意图的过程中不要切换连接。如果目标发生变化，请从头开始。

在选定的服务上调用 whoami。此调用会确认连接并返回工作区 ID。请报告该 ID，让用户知道即将修改哪个工作区。如果没有 exo MCP 工具，或者 whoami 调用失败，请读取 resources/bootstrap.md 并按其说明操作，然后再次调用 whoami。成功之前不要对意图进行分类。

scripts/exo-skill.py 通过 REST 访问同一个工作区，也必须访问同一个工作区。它会从进程环境中读取 EXO_API_URL、EXO_API_KEY 和 EXO_WORKSPACE_ID，如果未设置，则使用 --profile 指定的配置文件，该文件路径为 ${XDG_CONFIG_HOME:-~/.config}/exo/<name>.env。每次调用时都要使用你所选 MCP 服务的名称传入 --profile，以确保两者不会指向不同的工作区。

始终先阅读

阅读 resources/common.md。其中包含每种意图都会用到的共享底层内容：遍历运行的读取原语、用于确定技能可使用哪些工具以及如何声明这些工具的工作器能力规则、DTO 探索规范、每个步骤都必须遵循的输出、指标、完成状态和记忆运行时契约、无法探测的节点，以及关于改进意图为何内联读取调试方案而不调用它的说明。

对意图进行分类

如果请求涉及	意图	阅读
某次特定运行为何失败、某个 run_id 的运行出了什么问题、诊断一次运行	debug	intents/debug.md
改进、迭代、优化或加快现有工作流，并依据其近期运行情况进行调整	improve	intents/improve.md
将想法转化为新工作流，构建、创建或搭建工作流，或基于 Agent 模板 slug 进行构建	build	intents/build.md

只能选择一种。如果请求确实无法明确区分意图，请通过一个问题询问用户要选择哪种意图，不要猜测。

用户交互

无论这里将其称为什么，都应通过 harness 的结构化提问工具向用户提出每个问题。不允许通过自由文本提问，也不允许使用项目符号列表或“Q1/Q2/Q3”形式的提示，即使问题看起来是开放式的。将开放问题归纳为具体选项，并允许用户输入自定义答案。将相关问题合并到一次调用中，让用户填写结构化表单，而不是在对话中逐条回复。遵守当前工具的限制；只有在没有结构化工具可用，或答案本质上必须是自由文本时（例如名称、指标或路径），才直接以文字提问。这适用于意图消歧、intents/build.md 中的构建问询、intents/improve.md 中的提案和重新运行关卡，以及 intents/debug.md 中任何用于消歧候选项的提示。

在每个审批、生产写入、凭证和重新运行关卡，都必须要求用户明确作答。绝不可为这些问题附加自动解决机制。

不同意图之间的边界是有意设置的关卡，而非需要消除的阻力。构建以首次运行结束后，不会自动继续进入改进，因为用户决定何时从构建阶段进入迭代阶段。改进流程发现运行失败时，应在流程内直接执行调试步骤，而不是切换意图，因为诊断是循环中的子流程，而非单独的请求。

路径

意图文件中的所有路径均相对于此技能的根目录：可执行文件位于 scripts/，共享文档和模板位于 resources/，三个配方位于 intents/。agents/ 存放各 harness 的接口元数据，配方不会读取这些数据。