DeclarAgent YAML 代理手册 MCP 工具

问题：LLM 工具调用里的 YAML 代理手册，不能直接“裸跑”

在大模型（LLM）的工具调用流程中，YAML 代理手册（agent runbook）常被用来定义多步骤工作流——比如数据处理、接口调用、文件操作的组合。但直接执行这类手册，会踩几个具体的坑：

• 验证缺失：手册的 YAML 结构、字段映射、步骤依赖没经过校验，执行到一半才发现配置错误，浪费调用成本还可能引发副作用；
• 破坏性操作无拦截：手册里可能包含删除文件、修改线上配置这类不可逆步骤，一旦 LLM 直接触发，没有中间审批环节，风险直接落地；
• 复用性差：即使手册逻辑正确，也只能在当前 LLM 对话里用，想复用给 MCP 兼容客户端时，还要手动拆步骤，又多了一层维护成本。

技能如何工作：验证、试运行、审批，再暴露成 MCP 工具

这个技能围绕 DeclarAgent 构建，把 YAML 代理手册的处理拆成四个核心环节，每个环节都对应一个“降低风险”的节点：

• 结构化验证：先对 YAML 手册做语法和逻辑校验——检查步骤顺序是否合理、字段是否符合 DeclarAgent 的规范、必要参数是否齐全，避免带着结构错误进入执行阶段；
• dry-run（试运行）：不实际触发手册里的操作，只模拟执行流程，输出每一步的预期结果和潜在风险（比如某一步可能访问的外部接口），让开发者提前看到执行路径；
• 破坏性步骤审批：如果手册里包含“删除”“修改”“提交”这类不可逆操作，技能会单独标记这些步骤，执行前需要人工确认，不会让 LLM 直接跳过审批环节；
• 可选 MCP 暴露：如果需要把手册复用给 MCP 兼容客户端，技能能把验证通过的手册封装成 MCP 工具，客户端直接调用，不用重新解析 YAML 逻辑。

整个过程不需要改现有 LLM 工具调用的框架，只要把 YAML 手册交给技能处理，就能从“未验证的配置”变成“可审计、可复用的 MCP 工具”。

适用边界：先确认环境和手册质量

不是所有 YAML 代理手册都能直接用这个技能，几个注意点要提前明确：

• 环境要求：需要提前安装 Go（DeclarAgent 的运行时依赖），MCP 暴露模式还要求客户端支持 MCP 协议；
• 手册质量前提：如果手册本身逻辑混乱（比如步骤无关联、参数缺失严重），技能能帮你发现结构问题，但不会主动修正手册逻辑，需要开发者先优化手册；
• 不替代最终审批：技能的“破坏性步骤审批”是中间拦截，最终还是要靠开发者确认每一步风险，不能用它替代人工审核；
• 复杂手册适配：如果手册涉及大量第三方服务依赖（比如云厂商 API），试运行只能模拟基础流程，实际执行时还要验证服务权限和网络连通性。