用途:这是一个以指南为先的计划执行技能,不把包安装隐藏在自身模板中,而是先指向与当前 CI/CD 管理的技能包版本块匹配的包与指南界面,再通过适用的 Loom Agent Plan-Execution Orchestrator(AO)运行时执行计划。
主要能力:选定绑定版本后,检测一个受支持的主机 RID,获取并校验该确切发布的 AO 自包含包,安全解压,然后直接运行 ao.exe --guide(Windows)或 ao --guide(Unix)。在规划或下游工作前,校验 JSON 版本与可读的 guide_path。包内携带英文文档,apphost 不内嵌指南页。
使用方式:官方执行权威为 AO,仅直接 ao.exe run/ao.exe resume(Windows)或 ao run/ao resume(Unix)算作官方技能运行。调用方需在一次 CLI 调用前在磁盘上准备完整输入集并关闭所有输入文件,仅传路径(如 --script-file、--input-file、--workflow-file 等),不内联传脚本源码、JSON 或补丁文本。首选输入为至少 10 行非空内容的丰富计划,回退输入为详细计划文档路径;请求过短则引导进入计划模式或要求详细计划文件。
适用场景:面向业务交付物的计划执行,遵循业务结果优先规则;当计划内容明确指向业务执行输出时,须以业务结果为完成目标,不得漂移为仅 AO 元执行活动。
限制:AO 仅支持 CLI,直接执行解压后的 apphost,无需 MCP 注册或预检。若包校验、解压、apphost 启动或指南执行失败,须以失败证据停止,不得从 stderr 记录成功。Windows PowerShell 5.1 包通道模式下,.nupkg 按 ZIP 处理,不可直接用 Expand-Archive;HTTP 探测需加 -UseBasicParsing。repo-src-debug 本地源码覆盖仅用于仓库内调试,不构成第二官方执行权威。当前发布 AO 包运行时版本为 0.3.324。