solo

Solo

Solo 是一款用于管理编码 Agent 和项目级协调状态的桌面应用。只能通过其 MCP 服务访问；Solo 没有 CLI。

Pi 行为

如果在 Pi 环境下运行（通过 PI_CODING_AGENT=true 检测），请使用 pi-soloterm 扩展工具来使用 Solo MCP 服务功能：

• solo_status — 验证 SoloTerm/MCP 是否可用、身份信息及功能支持情况。
• solo_task — 启动由 Solo 管理的编码 Agent/进程，并向其发送提示词。对于并行工作，请使用一次调用并传入 tasks: [...]。
• solo_scratchpad — 列出、读取或写入 Solo 便笺。
• solo_todo — 在可用时管理 Solo 待办事项；否则回退到 Pi 会话。

首先调用 solo_status。如果报告状态为就绪，请使用相关的 solo_* 工具继续操作——这些工具是在 Pi 环境下完整支持 Solo MCP 的工具；pi-soloterm 是桥接工具。

如果缺少必需的 solo_* 工具，请告知用户安装/启用 pi-soloterm。如果 solo_status 报告 Solo MCP 不可用，请告知用户运行 Solo 并启用设置 → MCP。

非 Pi 行为

如果不是在 Pi 环境下运行，请直接使用当前运行环境提供的 Solo MCP 工具。如果不清楚确切的工具名称，请查看 MCP 工具目录。

功能工具

除核心项目/进程管理外，Solo 还提供可选的功能工具——便笺、待办事项、计时器和键值存储；这些功能受 Solo 设置控制。便笺、待办事项和计时器通常继承 MCP 服务的启用状态；键值工具可能需要单独启用。请从 MCP 工具目录中查找确切的工具。

启动的 Agent

启动新 Agent 时，请留意其问题和权限请求；仅批准完成你提供的提示词所必需的请求。

除非用户指定其他 Agent，否则应使用当前进程启动时所用的同名 Agent 工具来启动工作 Agent——请按下一节所述进行解析。

简单任务的例外情况：改用低一级的 Agent。如果当前进程运行的是 fable Agent，则使用 sol 启动简单任务的工作 Agent；如果运行的是 sol，则使用 terra。简单任务指机械性工作，且结果范围明确、可验证，例如查找文件或符号、运行一次性命令并报告输出、获取或总结单份文档。任何需要判断的工作——编写或审查代码、调试、多步骤研究——都属于实质性工作，应由当前进程的 Agent 工具处理。

用于委派技能的 Agent 调度

当其他技能（例如审查团）通过 Solo 调度其工作 Agent 时，请先确认是否可用，再执行调度：使用 solo_status（Pi）或 whoami（直接 MCP）进行探测。仅能看到工具并不能证明可用——只有探测确认此进程由 Solo 管理且可生成 Agent 时，才能继续。如果探测失败或无法生成 Agent，请将此情况告知委派工作流，而不是执行调度。

生成的工作 Agent 必须使用启动当前进程时所用的同一个命名 Agent 工具运行，而不能只使用相同的执行框架。多个命名 Agent 工具可能封装同一个执行框架，同时设置不同的配置标志、模型或参数；通用默认项只按执行框架类型解析，因此依赖默认项可能会在不知情的情况下将工作 Agent 调度到不同的 Agent。

调度前，先解析当前进程配置的 Agent 工具。在 Pi 下，使用 solo_status 返回的进程 ID 调用 solo_process status；将其进程名称和启动命令与 solo_status 报告的已启用 Agent 工具匹配，并且仅接受完全匹配的工具名称作为权威结果。在每次 solo_task 中显式传入该工具作为 agentTool。如果选定的 Agent 工具已定义 model 或 thinking，则不要单独传入这些覆盖项。使用直接 MCP 时，采用 whoami 返回的等效 Agent 工具标识，并在每次生成 Agent 时显式传入。如果无法明确确定当前进程对应哪个已启用的工具，请停止并询问用户要使用哪个已启用的 Agent 工具。

如果委派技能提供了自己的验收层，请在每次 solo_task 中传入 acceptance: "none"，以禁用 Solo 验收关卡。