Agent的Skills编排方案应如何设计？

## 作用 Agent 的 Skills 编排方案不应把 Skill 理解为“更长的提示词”，而应把重复出现、需要专业判断的任务沉淀为可发现、可执行、可验证、可复用、可治理的组织能力。 核心定义是： - `Skill = Prompt + Workflow + Context + Constraint` - Skill 的质量由以下因素共同决定： - 能力边界 - 执行质量 - 工程可用性 - 三者是乘法关系，任一项接近零，整体能力就接近零。 设计编排方案时，需要解决单条提示词的三个问题： - **不可组合**：单条提示词是线性、封闭的，难以拆成子模块复用。 - **不可维护**：缺少版本、依赖、测试和影响范围分析，修改风险不可控。 - **不可移交**：隐含前提停留在编写者脑中，其他人无法稳定复用。 ## 原理 ### 1. 明确六类构件的职责边界 Skills 编排不能让一个组件承担所有职责，应按以下方式分工： - **Agent：目标负责人** - 理解目标 - 动态规划 - 选择能力 - 处理异常 - 对最终结果负责 - **Workflow：流程控制器** - 管理固定步骤 - 条件分支 - 重试 - 审批 - 回滚 - 状态流转 - **Skill：专业方法包** - 沉淀专家方法 - 业务规则 - 检查清单 - 参考资料 - 脚本入口 - 验收标准 - **MCP：连接协议层** - 用标准协议暴露工具、资源和 Prompt 模板 - 解决 Agent “可以连接什么”的问题 - **脚本：确定性执行单元** - 执行校验、转换、统计、哈希、脱敏等可计算、可断言的操作 - 保证相同输入得到相同输出 - **普通软件：生产基础设施** - 管理长期状态、权限、交易、并发、SLA、审计和一致性 可以概括为： > Agent 负责目标，Workflow 负责流程，Skill 负责方法，MCP 负责连接，脚本负责确定性动作，软件负责生产基础设施。 ### 2. Skill 应封装完整工作方法 一个 Skill 不应只包含提示词，而应包含完成一类任务所需的最小完整能力包： - **Prompt**：说明模型这一轮应如何判断和生成。 - **Workflow**：定义执行步骤、分支、重试、审批或回滚。 - **Context**：提供业务背景、参考资料、检查清单和必要上下文。 - **Constraint**：明确边界、权限、禁止事项、合规要求和验收标准。 ### 3. 编排时坚持“模型思考，程序验证” 方案设计应区分推理判断和确定性控制： - 让模型决定“怎么想”： - 理解任务 - 选择 Skill - 进行专业判断 - 生成动作建议 - 让程序证明“对不对”： - 用脚本做校验、断言和确定性计算 - 用 Workflow 控制步骤、重试、审批和回滚 - 用验收标准判断结果是否合格 - 让权限系统决定“能不能做”： - Agent 可以提出动作 - 是否允许执行必须由外部权限系统和生产系统控制 ### 4. 使用 MCP 标准化工具接入 Skill 中的工具不应随意堆叠私有 API，应通过 MCP 统一接入外部工具、资源和 Prompt 模板，避免每个系统都建设私有适配层。 工具设计应遵循： - 少而精，不把底层 API 1:1 暴露给模型。 - 使用命名空间划清工具边界。 - 返回有意义的上下文，优先返回自然语言而非无解释的机器 ID。 - 优化 token 效率，支持分页、过滤、截断和结构化响应。 - 错误信息应支持模型自纠，而不是只返回错误码。 - 工具描述要足够清晰，像给新同事写文档。 - 控制工具数量，避免工具集臃肿和功能重叠。 ### 5. 建设 SkillOps 治理能力 Skills 编排还需要工程化治理，而不是只维护提示词文档： - **可发现**：通过标准目录和 Skill Card 描述能力、适用场景、输入输出和边界。 - **可组合**：将复杂任务拆成可复用的 Skill、Workflow、脚本和工具。 - **可版本化**：记录 Skill 版本、依赖关系和变更历史。 - **可测试**：为执行结果、关键约束和验收标准建立测试。 - **可评估**：修改 Skill 后能够判断效果变好还是变坏。 - **可移交**：把专家脑中的隐含前提显式写入 Context、Constraint 和检查清单。 - **可审计**：记录 Skill 被谁、在什么任务中、以什么参数调用，以及执行结果。 - **可权限控制**：高风险动作必须经过审批、授权或系统拦截。 ### 6. 总体设计原则 - 不要把几十页流程规则全部塞进系统提示词。 - 不要把权限控制写死在 Skill 中。 - 不要让大模型执行固定计算或强一致性操作。 - 不要把 MCP 当成业务流程引擎。 - Skill 负责沉淀“这类任务应该怎么做”，Workflow 负责“按什么顺序执行”，Agent 负责任务闭环。