logo

Agent 架构中的 Know-how 与 Skill 设计方法

作者:php是最好的2026.11.16 10:21浏览量:1

简介:本文系统解释 Agent 架构中 Know-how 的定义、价值与实现方式,重点说明为什么不能把全部业务规范都塞进系统提示词,以及如何通过 Skill、分层知识、按需加载和资源引用,让 Agent 在具备工具执行能力的同时,掌握规范化的做事方法。读者将了解工具与 Skill 的区别、Skill 的组成、运行流程、适用场景和设计注意事项。

agent-">一、Know-how 在 Agent 架构中是什么

在 Agent 架构中,Know-how 指的是 Agent 针对特定任务所需要掌握的专业方法、业务规则、操作规范、判断标准和经验性知识。它回答的不是“能不能做”,而是“应该怎么做、做到什么程度才算正确”。

例如:

  • 需求分析应该采用什么结构;
  • 需求文档必须包含哪些字段;
  • 原型设计需要遵循哪些交互规范;
  • 代码应该使用什么目录结构和命名方式;
  • 发布前需要检查哪些事项;
  • 发生异常时应该按照什么顺序定位问题;
  • 什么情况下需要向用户澄清,而不能直接执行。

这些内容共同构成了 Agent 的工作方法。

从技术视角看,Know-how 是一组可被 Agent 理解和执行的过程知识与约束规则;从业务视角看,它是团队经验、岗位规范和组织流程的数字化沉淀;从使用视角看,它决定了 Agent 的输出是否符合目标场景的质量要求。

因此,一个真正可用的垂直 Agent,不仅需要具备调用工具的能力,还需要理解特定领域中“什么是正确的做法”。

二、为什么 Agent 需要独立设计 Know-how

Agent 通常由模型、工具、上下文、记忆和任务规划等部分组成。工具解决的是执行问题,例如读取文件、写入内容、访问数据、运行任务或提交变更;但工具本身不会告诉 Agent 哪种执行方式更合理。

可以把 Agent 的工作能力分为两个层次:

  1. 动作能力:能够执行某项操作;
  2. 方法能力:知道在什么场景下执行什么操作,以及如何判断结果是否合格。

例如,一个 Agent 可能拥有读取代码文件的工具,但这并不意味着它知道:

  • 需要先读取哪些文件;
  • 应该按照什么顺序理解代码;
  • 修改前是否必须保留原有行为;
  • 修改后需要执行哪些检查;
  • 输出结果应该采用什么格式。

如果只有工具,没有 Know-how,Agent 往往会出现“能做但做得不对”的问题。它可能完成了动作,却没有遵循组织规范;可能输出了看似完整的文档,却遗漏关键字段;也可能修改了代码,却没有完成必要的验证。

反过来,如果只有 Know-how,没有工具,Agent 虽然知道应该怎么做,却无法读取实际数据、修改文件或执行验证。因此,工具和 Know-how 是互补关系。

可以用一个简单公式表示:

Agent 的有效工作能力 = 工具能力 × Know-how 能力

这里采用乘法而不是加法,是因为其中任何一项明显不足,整体效果都会受到限制。

三、为什么不建议把全部 Know-how 放进系统提示词

最直接的做法,是把所有规范、模板、流程和注意事项全部写进系统提示词,让 Agent 在每轮任务中都能看到。这种方式实现简单,但并不适合复杂场景。

1. 上下文成本持续增加

假设一个需求规范包含约两千个词元,原型规范和代码规范也各包含约两千个词元,那么三个规范同时常驻,就会占用较大的上下文空间。

当 Agent 只在执行代码任务时,需求规范和原型规范通常并没有直接作用,却仍然会被重复传入。随着规范数量增加,系统提示词会越来越长,带来以下问题:

  • 每次调用都产生重复的上下文开销;
  • 有效任务信息在上下文中的占比下降;
  • 长文本可能挤压用户输入、工具结果和历史对话;
  • 复杂任务中更容易出现信息遗漏;
  • 维护提示词的成本不断增加。

2. 无关信息会干扰任务判断

模型并不是看到的信息越多,表现就一定越好。与当前任务无关的内容可能造成注意力分散。

例如,当前任务只是生成接口说明,却同时加载了完整的视觉规范、测试规范和发布流程,Agent 可能会:

  • 误把其他阶段的要求应用到当前任务;
  • 在不需要时提出额外步骤;
  • 混淆多个规范之间的优先级;
  • 生成过度复杂的结果。

因此,Know-how 的关键不只是“存下来”,还包括“在正确的时机提供正确的知识”。

3. 规范难以独立维护

当所有规则都集中在一个系统提示词中时,任何规范的修改都可能影响整个 Agent。不同团队、不同任务、不同版本的要求也容易相互耦合。

更合理的方式,是让每类 Know-how 具备独立的生命周期:

  • 可以单独新增;
  • 可以单独修改;
  • 可以单独测试;
  • 可以单独版本管理;
  • 可以单独控制适用范围。

四、Skill 是 Know-how 的标准化承载方式

Skill 可以理解为 Agent 可按需加载的一组任务方法与领域规范。它不是单纯的知识文档,也不是普通的提示词片段,而是围绕某一类任务组织起来的、可被 Agent 识别和执行的工作方法。

一个 Skill 通常会描述:

  • 它解决什么问题;
  • 什么时候应该使用;
  • 任务执行需要经过哪些步骤;
  • 每一步应该关注什么;
  • 输出结果需要满足哪些标准;
  • 哪些文件、模板或示例可以进一步参考;
  • 遇到异常或信息不足时如何处理。

Skill 的核心思想是:

先通过简短信息判断是否相关,再在确有需要时加载完整规则,最后按任务需要读取更详细的资源。

这是一种渐进式披露机制,可以避免所有知识同时进入上下文。

五、Skill 的三层结构

第一层:元数据层

元数据是 Skill 的索引信息,通常长期保留在 Agent 可见范围内,但内容应尽量简洁。

元数据至少应包含:

  • Skill 名称;
  • 一句话用途说明;
  • 适用任务;
  • 触发条件;
  • 资源位置或引用标识。

例如:

  1. 名称:需求分析规范
  2. 用途:用于将用户的业务目标整理为结构化需求文档
  3. 适用场景:需求梳理、功能拆解、验收标准生成

元数据的作用不是承载完整知识,而是帮助 Agent 快速判断“当前任务是否需要这个 Skill”。

第二层:规则正文层

当 Agent 判断某个 Skill 与当前任务相关时,再加载 Skill 的正文内容。正文通常包括:

  1. 目标与适用范围;
  2. 输入要求;
  3. 标准执行流程;
  4. 输出格式;
  5. 质量检查项;
  6. 例外情况;
  7. 禁止行为;
  8. 与其他 Skill 的协作关系。

正文应当尽量明确、可操作,避免只写抽象口号。例如,“生成高质量需求文档”并不能直接指导 Agent;更有效的写法是明确要求包含业务背景、目标用户、核心流程、功能边界、异常分支和验收条件。

第三层:资源层

资源层存放较大或较具体的辅助材料,包括:

  • 文档模板;
  • 示例文件;
  • 检查清单;
  • 字段定义;
  • 术语表;
  • 流程图说明;
  • 常见错误案例;
  • 版本差异说明。

这些内容不需要在每次任务中全部加载。Agent 只有在执行到相关步骤时,才读取对应资源。

例如,生成需求文档时可以先加载规则正文;当需要确定文档格式时,再读取模板;当需要进行交付前检查时,再读取检查清单。

六、Skill 的典型运行流程

一个按需加载的 Agent,通常可以按照以下流程工作:

第一步:识别任务意图

Agent 先分析用户请求,确定任务属于需求编写、代码修改、数据处理、问题排查还是其他类型。

第二步:匹配 Skill 元数据

Agent 根据任务意图、关键词、上下文和已有状态,匹配可能适用的 Skill。此时只读取简短的名称和用途信息。

第三步:加载相关规则

如果判断某个 Skill 确实适用,Agent 再加载该 Skill 的完整正文,获取具体执行步骤和约束。

第四步:按需读取资源

当正文要求使用模板、示例或检查清单时,Agent 通过读取能力获取对应资源,而不是一次性加载全部文件。

第五步:调用工具执行动作

在理解规范后,Agent 再调用读取、写入、计算、查询或验证等工具完成任务。

第六步:按照 Skill 进行自检

任务完成后,Agent 根据 Skill 中的质量标准检查输出是否完整,确认是否遗漏字段、违反格式或跳过必要步骤。

这一流程将“理解方法”和“执行动作”分开,使 Agent 的行为更接近一个遵循组织规范的专业人员。

七、工具与 Skill 的区别

工具和 Skill 经常被混淆,但二者处于不同层次。

对比维度 工具 Skill
核心含义 执行动作的能力 完成任务的方法
解决问题 能不能做 应该怎么做
典型内容 读、写、查询、运行、提交 流程、规范、模板、判断标准
使用方式 被 Agent 调用 被 Agent 理解和遵循
主要风险 参数错误、权限不足、执行失败 流程错误、规范遗漏、结果不合格
类比 手、脚和执行器 经验、手册和工作方法

例如,“读取规范文件”是一项工具能力,它只能让 Agent 获取文件内容;而“需求规范”是一项 Skill,它告诉 Agent 需求文档应该包含哪些章节、如何组织内容以及如何判断是否完整。

可以把二者的关系概括为:

工具负责把事情做出来,Skill 负责指导事情应该如何做。

一个完整的 Agent 任务通常需要经历以下链路:

  1. 用户目标
  2. ↓
  3. 任务识别
  4. ↓
  5. 匹配 Skill
  6. ↓
  7. 加载执行规范
  8. ↓
  9. 选择并调用工具
  10. ↓
  11. 生成结果
  12. ↓
  13. 依据 Skill 自检

八、适合使用 Skill 的典型场景

1. 需求工程

可以通过 Skill 固化需求文档结构、用户故事写法、验收条件、异常流程和范围边界,减少需求表达不完整的问题。

2. 软件设计与编码

可以沉淀目录结构、命名规则、接口约束、错误处理方式、日志要求和测试标准,使 Agent 生成的代码更符合团队习惯。

3. 运维与故障排查

可以将故障定位流程、风险确认步骤、变更审批要求和回滚方案写入 Skill,避免 Agent 在高风险操作中跳过必要检查。

4. 数据处理

可以定义数据清洗规则、字段映射关系、缺失值处理方式、结果校验标准以及敏感信息保护要求。

5. 内容审核与交付检查

可以使用 Skill 统一检查内容完整性、格式一致性、敏感信息、引用规范和交付前置条件。

九、Skill 设计中的关键注意事项

1. 明确适用边界

Skill 应该清楚说明什么时候使用、什么时候不使用。边界不明确会导致 Skill 被错误触发,增加上下文负担。

2. 规则必须可执行

不要只写“保证质量”“符合规范”等抽象要求,应将其转化为具体检查项和操作步骤。

3. 控制单个 Skill 的职责范围

一个 Skill 最好围绕一类相对稳定的任务设计。过大的 Skill 会重新变成“巨型提示词”,过小的 Skill 又会造成匹配和管理成本上升。

4. 处理优先级冲突

当多个 Skill 同时生效时,需要定义优先级。例如,安全规范通常应高于普通格式规范;用户明确要求可能需要与默认规范进行协调。

5. 资源与规则分离

规则正文负责说明如何工作,模板和示例负责提供参考材料。二者分离后,既便于维护,也能减少不必要的上下文加载。

6. 建立版本管理机制

规范会随着业务和团队实践变化,因此 Skill 应保留版本信息,并明确变更内容、生效范围和兼容关系。

7. 避免把权限伪装成知识

Skill 可以说明某项操作需要授权或审批,但不能代替真正的权限控制。工具层仍然需要独立完成身份认证、访问控制、操作审计和风险拦截。

十、总结

Agent 架构中的 Know-how,是让 Agent 从“能够执行动作”进化为“能够按照专业方法完成任务”的关键能力。工具提供执行手段,Skill 提供工作方法;工具解决“能做什么”,Skill 解决“应该怎么做”。

将全部 Know-how 固定写入系统提示词,虽然实现简单,但容易造成上下文膨胀、注意力稀释、维护困难和规则混用。更合理的设计是采用 Skill 进行分层管理:

  • 用元数据长期保留任务索引;
  • 用正文承载完整执行规范;
  • 用资源文件保存模板、示例和检查清单;
  • 根据任务需要逐步加载相关内容;
  • 在执行完成后依据规则进行自检。

对于垂直 Agent 而言,工具和 Skill 缺一不可。只有把执行能力、专业规范、资源引用和质量验证组合起来,才能让 Agent 在具体业务场景中稳定、可控、可维护地完成任务。

发表评论

活动