File contents 技能(Skill)
一句话定义:一种标准化的能力封装,通过将特定领域的 Prompt、工具调用权限和工作流程逻辑进行组合,赋予 AI 智能体(Agent)解决特定复杂问题的定式。
科普速读
解决问题:建立 AI 执行能力与治理边界。
适用场景:用于工具调用、规则控制和多步任务执行。
使用边界:没有权限和审计机制时风险较高。
概览
技能 的价值不在于概念本身,而在于它能解决真实工程问题:稳定性、可解释性和可协作性。科普视角下,理解它等于理解 AI 研发流程里的一个关键环节。
核心定义
标准定义
在智能体开发架构中,技能是指一种显式的、可调用的功能单元。它通常包含三部分:指令定义(如何理解任务)、元数据(什么时候该被触发)以及执行器(对应的代码逻辑或 API 调用)。
通俗解释
把它理解为“AI 工程中的一个基础控制点”:它帮助团队减少随机性、提升复用性,并把经验沉淀成可执行的方法。
背景与发展
起源
提出背景 :早期 AI 只会聊天。为了让它具备实际工作能力,开发者开始给它权限去运行 Python 代码、搜索网页,这些最初的插件演变成了现在的“技能”。
关注重点 :如何实现技能的模块化与可移植性,让一个团队积累的“专家经验”能跨项目复用。
演进
1.0 阶段(硬编码) :开发者在后台写死 AI 能调用的函数,死板且难扩展。
2.0 阶段(插件/工具) :出现类似 ChatGPT Plugins 的生态,但触发逻辑往往依赖模型随机选择。
3.0 阶段(语义化技能体系) :利用 MCP (Model Context Protocol) 等协议,技能成为具备自我描述能力的独立组件,能被智能体按需编排。
工作机制(How It Works)
注册(Registration) :技能将其能力描述、输入参数要求告知 Agent。
意图识别(Intent Recognition) :Agent 在接到需求时,分析是否需要动用某个特定技能。
参数填充(Parameter Filling) :Agent 从上下文中提取技能运行所需的关键参数。
执行与反馈(Execution & Feedback) :运行技能逻辑,并将结果返回给 Agent 进行最终决策。
在软件测试与开发中的应用
测试用例生成技能 :内置了业务逻辑覆盖、边界值检查等专家的思考链路。
性能诊断技能 :能自动登录监控后台、拉取慢查询日志并分析潜在瓶颈。
文档自动化技能 :根据代码变动,自动通过特定模板更新 Markdown 文档。
优势与局限
优势
复用性极高 :写好一次“修复 Lint 错误”的技能,所有项目都能用。
行为可控 :通过在技能里限制 Prompt,能有效约束 AI 生成的风格,防止其乱改一气。
解耦设计 :逻辑升级时,只需要更新某个“技能包”,不需要重新部署整个 AI 助手。
局限与风险
冲突风险 :如果两个技能的触发条件太相似,Agent 可能会选错技能。
过载风险 :给 Agent 挂载过多的技能,会导致上下文窗口被元数据占满,降低推理准确性。
调试困难 :当一个复杂的任务由多项技能交织完成时,很难定位是哪一个技能环节出了问题。
与相近术语对比
维度
技能 (Skill)
AI 智能体 (Agent)
模型上下文协议 (MCP)
层级
具体的武器/招数
使用武器的人
武器与人的连接协议
独立性
极高,可被多次复用
低,通常绑定具体任务
极高,作为基础设施存在
构成
指令 + 逻辑
规划 + 记忆 + 工具
资源 + 传输 + 接口
实施建议(Best Practices)
原子化设计 :一个技能只做好一件小事(例如:专门负责检查 SQL 注入)。
编写“优质描述” :技能的描述文字是给模型看的,必须清晰、具体,甚至包含什么时候不该 使用该技能。
版本化管理 :像管理镜像或库文件一样管理技能,确保生产环境的稳定性。
常见误区(Pitfalls)
以为技能就是 Prompt :一个成熟的技能往往包含底层逻辑代码。纯 Prompt 往往在处理数据结构时不够严谨。
技能写得太宽泛 :说“这个技能能做所有事情”等于废话,AI 会在需要时忽略它。
FAQ
Q1: 新手需要马上掌握这个术语吗?
A: 建议先理解核心目的,再结合实际项目逐步使用。
Q2: 如何判断是否真的用对了?
A: 看三件事:交付更稳、返工更少、团队协作更顺畅。
相关资源
相关词条
术语元数据
别名:Agent skill
标签:AI Vibe Coding、Wiki
参考来源
1 --- 2 name: zh-cn 3 description: 技能(Skill) 4 --- 5 6 # 技能(Skill) 7 8 > 一句话定义:一种标准化的能力封装,通过将特定领域的 Prompt、工具调用权限和工作流程逻辑进行组合,赋予 AI 智能体(Agent)解决特定复杂问题的定式。 9 10 ## 科普速读 11 12 - 解决问题:建立 AI 执行能力与治理边界。 13 - 适用场景:用于工具调用、规则控制和多步任务执行。 14 - 使用边界:没有权限和审计机制时风险较高。 15 16 ## 概览 17 18 `技能` 的价值不在于概念本身,而在于它能解决真实工程问题:稳定性、可解释性和可协作性。科普视角下,理解它等于理解 AI 研发流程里的一个关键环节。 19 20 ## 核心定义 21 22 ### 标准定义 23 24 在智能体开发架构中,技能是指一种显式的、可调用的功能单元。它通常包含三部分:指令定义(如何理解任务)、元数据(什么时候该被触发)以及执行器(对应的代码逻辑或 API 调用)。 25 26 ### 通俗解释 27 28 把它理解为“AI 工程中的一个基础控制点”:它帮助团队减少随机性、提升复用性,并把经验沉淀成可执行的方法。 29 30 ## 背景与发展 31 32 ### 起源 33 34 - **提出背景**:早期 AI 只会聊天。为了让它具备实际工作能力,开发者开始给它权限去运行 Python 代码、搜索网页,这些最初的插件演变成了现在的“技能”。 35 - **关注重点**:如何实现技能的模块化与可移植性,让一个团队积累的“专家经验”能跨项目复用。 36 37 ### 演进 38 39 - **1.0 阶段(硬编码)**:开发者在后台写死 AI 能调用的函数,死板且难扩展。 40 - **2.0 阶段(插件/工具)**:出现类似 ChatGPT Plugins 的生态,但触发逻辑往往依赖模型随机选择。 41 - **3.0 阶段(语义化技能体系)**:利用 MCP (Model Context Protocol) 等协议,技能成为具备自我描述能力的独立组件,能被智能体按需编排。 42 43 ## 工作机制(How It Works) 44 45 1. **注册(Registration)**:技能将其能力描述、输入参数要求告知 Agent。 46 2. **意图识别(Intent Recognition)**:Agent 在接到需求时,分析是否需要动用某个特定技能。 47 3. **参数填充(Parameter Filling)**:Agent 从上下文中提取技能运行所需的关键参数。 48 4. **执行与反馈(Execution & Feedback)**:运行技能逻辑,并将结果返回给 Agent 进行最终决策。 49 50 ## 在软件测试与开发中的应用 51 52 - **测试用例生成技能**:内置了业务逻辑覆盖、边界值检查等专家的思考链路。 53 - **性能诊断技能**:能自动登录监控后台、拉取慢查询日志并分析潜在瓶颈。 54 - **文档自动化技能**:根据代码变动,自动通过特定模板更新 Markdown 文档。 55 56 ## 优势与局限 57 58 ### 优势 59 60 - **复用性极高**:写好一次“修复 Lint 错误”的技能,所有项目都能用。 61 - **行为可控**:通过在技能里限制 Prompt,能有效约束 AI 生成的风格,防止其乱改一气。 62 - **解耦设计**:逻辑升级时,只需要更新某个“技能包”,不需要重新部署整个 AI 助手。 63 64 ### 局限与风险 65 66 - **冲突风险**:如果两个技能的触发条件太相似,Agent 可能会选错技能。 67 - **过载风险**:给 Agent 挂载过多的技能,会导致上下文窗口被元数据占满,降低推理准确性。 68 - **调试困难**:当一个复杂的任务由多项技能交织完成时,很难定位是哪一个技能环节出了问题。 69 70 ## 与相近术语对比 71 72 | 维度 | 技能 (Skill) | AI 智能体 (Agent) | 模型上下文协议 (MCP) | 73 | :--- | :--- | :--- | :--- | 74 | **层级** | 具体的**武器/招数** | 使用武器的**人** | 武器与人的**连接协议** | 75 | **独立性** | 极高,可被多次复用 | 低,通常绑定具体任务 | 极高,作为基础设施存在 | 76 | **构成** | 指令 + 逻辑 | 规划 + 记忆 + 工具 | 资源 + 传输 + 接口 | 77 78 ## 实施建议(Best Practices) 79 80 - **原子化设计**:一个技能只做好一件小事(例如:专门负责检查 SQL 注入)。 81 - **编写“优质描述”**:技能的描述文字是给模型看的,必须清晰、具体,甚至包含什么时候**不该**使用该技能。 82 - **版本化管理**:像管理镜像或库文件一样管理技能,确保生产环境的稳定性。 83 84 ## 常见误区(Pitfalls) 85 86 - **以为技能就是 Prompt**:一个成熟的技能往往包含底层逻辑代码。纯 Prompt 往往在处理数据结构时不够严谨。 87 - **技能写得太宽泛**:说“这个技能能做所有事情”等于废话,AI 会在需要时忽略它。 88 89 ## FAQ 90 91 ### Q1: 新手需要马上掌握这个术语吗? 92 93 A: 建议先理解核心目的,再结合实际项目逐步使用。 94 95 ### Q2: 如何判断是否真的用对了? 96 97 A: 看三件事:交付更稳、返工更少、团队协作更顺畅。 98 99 ## 相关资源 100 101 ### 相关词条 102 103 - [ai-agent](https://inaodeng.com/zh-cn/AIWiki/ai-agent/) 104 - [model-context-protocol-mcp](https://inaodeng.com/zh-cn/AIWiki/model-context-protocol-mcp/) 105 - [rules-cursorrules](https://inaodeng.com/zh-cn/AIWiki/rules-cursorrules/) 106 107 ### 术语元数据 108 109 - 别名:Agent skill 110 - 标签:AI Vibe Coding、Wiki 111 112 ## 参考来源 113 114 - [MCP docs (tools/connectors context)](https://docs.anthropic.com/en/docs/mcp) 115 - [Cursor rules docs (reusable behavior control)](https://docs.cursor.com/context/rules)
naodeng/naodeng.com.cn/tree/main/src/content/aiwiki/zh-cn commit da7cb96088
Frequently asked questions How do I install the Zh Cn skill? Run npx skillmds@latest add naodeng/zh-cn in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Zh Cn skill do? 技能(Skill) It is listed under Coding & Dev Tools on SkillMD.
Is Zh Cn safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Zh Cn? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Zh Cn free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Zh Cn? naodeng (@naodeng) published this skill. Their other Agent Skills are listed on their SkillMD profile.