文档中心

AgentKit

技能

技能概述

技能是基于文件系统构建的可复用能力单元，也是 Agent 的核心能力组件。它用于将业务知识、执行流程、工具脚本、操作规范和配套资源等进行标准化封装，使 Agent 能够像调用本地函数一样，按明确边界加载并执行指定能力。

通过将技能添加到技能空间，并进一步集成到目标 Agent 中，可以快速扩展 Agent 的任务处理范围，提升交付一致性、执行稳定性和业务适配效率。

对于开发者：技能提供了一种将提示词、工具调用约束、任务步骤编排和业务逻辑沉淀为工程化资产的方法。

对于业务人员：技能降低了能力复用和业务经验沉淀的门槛，使已有的 PRD、SOP、操作手册等资料可以逐步转化为可被 Agent 直接使用的能力单元。

为什么需要技能

通过技能，能够把散落在文档、脚本、工具调用、人工经验里的碎片化能力沉淀为标准化资产，形成可供 Agent 检索、加载与执行的能力资产，一次构建便可在多任务、多会话中复用，保障任务执行效果统一。

能力复用

同一类能力可在多个 Agent 之间共享，避免围绕相似任务重复编写提示词、脚本或操作规则，减少重复建设，提升能力沉淀的复用率。

能力治理

通过技能统一封装后，能力边界、依赖关系、输入输出契约和执行约束可集中管理。技能不再是分散于文档、脚本和人工经验中的隐性知识，而是可管理的显性资产。

版本稳定性

技能支持版本化发布。发布后的版本可固化某一阶段的能力定义和资源内容，便于在生产环境中稳定引用，同时支持后续按版本迭代，降低能力变更带来的不确定性。

能力分发与范围控制

通过技能空间，可按团队、业务域或运行环境组织技能集合，并控制技能的分发范围，在提升共享效率的同时，避免不适用的能力被错误调用。

推荐场景

技能适用于封装可复用的 Agent 能力。当任务执行流程具备标准化、重复性特点，且对输出结果的可靠性有明确要求时，可将其封装为技能，供 Agent 调用。

典型场景

流程与执行标准化

将审批、数据处理等稳定任务流程沉淀为标准执行单元。

封装工具使用约束、权限边界等，降低 Agent 任务执行的不确定性。

输出规范与一致性

将提示词策略和回答规范固化为统一能力，确保不同 Agent 输出口径一致。

基于固定标准、模板或领域知识生成报告与方案。

知识与资产沉淀

将业务知识、操作手册、 SOP 等转换为可复用能力资产，降低重复培训与重复配置成本。

实现复杂文档智能化生成、结构化解析与自动化处理。

能力共享与系统集成

在多个 Agent 之间共享同一类能力，支持跨团队、跨场景快速复用。

与外部 API、数据库等资源实现稳定交互。

使用实践

在 Agent 中集成技能后，通过自然语言指令即可触发技能完成对应任务。

实践项	说明
流程标准化执行	将稳定的业务流程封装为技能后，Agent 可按标准步骤自动完成任务，减少人工干预与执行偏差。案例 1：输入“对线上服务 order-service 发起一次巡检”，Agent 调用巡检技能，按预设步骤依次检查服务健康状态、接口响应与告警记录，并输出巡检报告。案例 2：输入“发起审批流程，申请人为张三，审批类型为权限变更”，Agent 调用审批技能，自动填写审批单并提交至对应审批链路。
输出规范管控	将提示词策略和回答规范固化为技能后，不同 Agent 在相同场景下可输出一致的内容结构与口径。案例：输入“生成本次迭代的上线通知”，Agent 调用通知生成技能，按预置模板输出包含版本号、变更内容、影响范围和联系人的标准化上线通知。
知识与 SOP 资产化	将操作手册、业务规则和 SOP 封装为技能后，Agent 可直接基于沉淀的知识完成任务，无需重复配置。案例：输入“按照数据安全规范检查这份接口文档是否存在敏感字段暴露问题”，Agent 调用数据安全审查技能，对照内置 SOP 逐项检查并输出合规性报告。
跨 Agent 能力共享	同一技能可发布至多个技能空间，供不同 Agent 复用，支持跨团队快速复制最佳实践。案例：将「日志摘要生成」技能发布至运维团队与研发团队的技能空间后，两个团队的 Agent 均可直接调用该技能完成日志摘要生成，无需各自重复开发。

基本概念

概念	说明
技能	技能是面向特定任务封装的标准化能力单元，整合任务所需的知识说明、执行流程、代码脚本、关联资源等。Agent 可像调用函数库一样，按需、稳定地执行各类专项任务。对比面向一次性任务的对话级 Prompt，技能具备更高的抽象层级；依托按需加载能力，还可省去多轮对话过程中重复信息的输入，提升任务执行效率。
技能空间	技能空间用于按团队、业务域、环境或场景组织技能集合，是技能分发和范围控制的重要载体，同一个技能可加入一个或多个技能空间，供对应 Agent 在运行时按需发现与调用。

工作原理

封装

将特定任务所需的知识、流程、脚本与资源进行标准化封装，形成独立的能力单元。

将技能发布至技能空间，使其对 Agent 可见；未加入技能空间的技能无法被调用。

触发

Agent 接收到自然语言指令后，通过技能空间发现并匹配目标技能，完成调用。

执行

技能按封装的流程与约束完成任务，并将结果返回给 Agent。

权限边界

归属与访问控制

技能的权限范围由技能所有权（决定谁拥有、编辑维护该技能）、空间分发权限（决定技能投放的能力空间及可访问成员）、Agent 调用权限（限定可用该技能的 Agent）。技能支持归属于个人、团队或组织，归属范围决定其可见与可发布范围。

技能空间的访问隔离

技能空间用于管理可被 Agent 集成和调用的技能集合。只有已加入目标技能空间的技能，才可在该空间关联的 Agent 或 Runtime 中被选择和使用。不支持跨空间直接调用。

调用与管理权限区分

技能的调用权限不等同于技能的管理权限。具备调用权限的 Agent 可在运行时使用已配置的技能，但不代表具备修改、发布或删除该技能的权限。

与其他组件的关系

技能与其它组件的关系可以概括如下：

组件	作用定位	与技能的关系
技能	面向任务的能力封装单元。	定义能力边界、知识结构与执行规则。
Tool	可调用动作的执行载体。	被技能选择、组织和约束使用。
MCP	外部工具与服务的标准接入协议。	为技能提供可扩展的外部能力来源。
Runtime	Agent 的运行与调度环境。	在任务执行时发现、加载并调用技能。