Skills 技能系统

来源：腾讯云培训认证中心 · CodeBuddy 架构师认证课程 · ch6

第 六 章 · Chapter 6

Skills 技能系统

本 章 学 什 么

• 理解 Agent Skills 的核心价值与「先触发再加载」机制

• 掌握 SKILL.md 的写法、三级加载机制、三种触发方式

• 动手跑通一次 Skill 的"配置 → 触发 → 验证"完整闭环

• 分清 Skills 和 MCP 各自管什么，能在两者间做选择

有些任务你是不是经常反复做？整理会议纪要、判断报销材料、生成固定格式的页面——每次都要重新交代一遍很累。Skills 就是把这套经验直接打包好，AI 一遇到这个场景就自动按流程走。一次配置，永久生效。

6.1 背景与起源

为什么不直接用 Prompt

把要求写进 Prompt 也可以，但长期用下来有三个问题：

• 每次都要重复写一大段协作规则

• Prompt 写太密，模型反而容易忽略关键要求

• Token 消耗会蹭蹭往上涨

Prompt 适合临时交代，Skills 更适合沉淀那些要反复用的方法。CodeBuddy 也支持 Agent Skills——即使用不了 Claude，照样可以用 Skills 的全部能力。

6.2 概念与核心机制

Agent Skills 是给 AI 配的一套**「标准操作流程」**——模块化的能力包，包含指令、元数据，还可以带脚本、模板、参考资料。AI 在需要的时候自动拿来用。

三大优势

• 专精——在特定任务上表现更稳定

• 减少重复——不用每次都重写一大段协作规则

• 整合能力——把经验、流程、模板打包成可反复用的模块

核心就两个词：稳定、复用。

先触发再加载 · 考点

关 键 机 制

AI 不是一上来就把所有 Skill 内容全塞进上下文，而是先只看 Skill 的元数据（主要是 description）。等用户的请求跟某个 description 对上了，才去加载完整指令和资料。所以装很多 Skill 也没事，不会一开始就把上下文撑爆。

Token 节省——只在触发时才加载，Token 消耗大幅降低。跨平台复用——作为开放标准，同一个 SKILL.md 可在 Claude、CodeBuddy 等平台用，写一次到处用。

6.3 SKILL.md 与实操

SKILL.md 基本格式

一个目录就是一个技能名，目录里必须有一个叫 SKILL.md 的文件。文件名必须存在，且大小写敏感。文件开头要有 YAML 元数据，至少写 name 和 description。

description 是触发入口 · 实操踩坑最多

"处理会议"——太笼统，AI 不一定知道啥时候用。 "将会议记录、讨论内容或聊天记录整理为结构化项目会议纪要，包含决策、待办事项和风险点"——触发就精准多了。

三级加载机制

**设计哲学：**按需分阶段加载，不是一股脑全塞进来——指令负责灵活指导，代码负责可靠性，资源用来查事实。Skills 因此既轻量又强大。

实操 · 会议纪要 + 报销 Skill

在 .codebuddy/skills/ 下建两个技能目录：meeting-minutes 用来总结会议、expense-reimbursement 用来查报销标准。每个目录下放一个 SKILL.md。

meeting-minutes · 会议纪要 Skill

name：meeting-minutes。description："将会议记录总结成项目风格的会议纪要文档"。 Input：会议文本、背景、输出偏好——缺一项先问。 Output：固定 6 栏目——背景与目标 / 结论摘要 / 决策 / 待办（含 Owner/Deadline）/ 未决问题 / 风险与依赖。 Procedure：判断信息足够 → 生成纪要 → 检测费用内容 → 若有则调用 expense-reimbursement Skill。

三个关键设计点：

• Output 结构设计成可以直接贴到飞书 / Confluence / 语雀

• 待办必须包含 Owner 和 Deadline——缺了就标注 UNKNOWN 并追问

• 检测到费用相关内容时，自动调用 expense-reimbursement Skill——这就是 Skill 间协作

expense-reimbursement · 报销 Skill

description 关键词：报销标准、所需材料、审批步骤。 Input 四项必填：expense_type（费用类型）/ Amount（金额）/ occurrence_date（发生日期）/ pre_approved（是否预批）。 Output 五项：reimbursable（是否可报销，YES/NO/NEED_MORE_INFO）/ policy_reference（适用标准引用）/ approval_chain（审批链分支）/ required_documents（材料清单）/ common_rejection_reasons（常见驳回原因）。 硬规则：严禁瞎编政策——reference.md 里没写的就输出 NEED_MORE_INFO。 reference.md（三级资源）：费用类型对应的标准 / 金额阈值的审批链 / 按类型区分的材料清单 / 例外和驳回原因。用到才加载。

三种触发方式 · 重点考点

**记忆口诀：**description 匹配 = AI 自动判断；glob = 按文件类型自动加载；@skill/name = 你手动点名。

触发流程四步

• 元数据匹配——AI 启动时加载所有 Skill 的 name 和 description，请求来了判断匹配哪个

• 指令加载——匹配上后才读 SKILL.md 正文（Input/Output/Procedure/Acceptance）

• 资源引用——执行中需要时再按需加载 reference.md 等三级资源

• 结构化输出——按 Output 定义的固定结构生成，所有必填字段都得有，缺了明确标注

这就是稳定、可复现、可验收的来源。

下面这段视频从零创建一个 Skill 完整闭环：建目录 → 写 SKILL.md → list skills 确认 → 输入触发并验证输出结构。

6.4 Skills vs MCP

Skills 管流程规范，MCP 管外部能力。

最 强 组 合

Skills 指挥流程，MCP 提供手和眼睛。报销 Skill 例：先按 Skill 的流程把字段问清楚，再通过 MCP 去查制度或单据状态，最后按模板输出可执行清单。

快速判断

• 「让 AI 每次写周报时自动用固定格式：本周完成 / 下周计划 / 需要协助」→ Skills

• 「让 AI 回答问题时能查公司内部知识库」→ MCP

6.5 练习与自测

作业要求

作业重点不是"写一个文件"，而是证明你的 Skill 能被触发、能稳定输出。

选题 A · SOP Skill——从会议纪要 / 报销答疑 / 周报整理三选一。准备真实或模拟的输入材料（会议聊天 ≥10 轮，或描述 ≥150 字）。用一句"可复制的提问"触发 Skill，拿到结构化输出。

选题 B · Web Skill——让 AI 生成一个单页落地页 index.html + style.css，能双击浏览器打开。页面至少包含 Hero 标题区、卖点 3 条、FAQ 3 条、CTA 按钮。

**截图要求：**输入截图、输出截图（必须能看到固定结构）、Skill 被调用的证据（list skills 列表，或输出明显遵守 Skill 定义的固定结构）。

必交感想 + 评判标准

感想文档 AgentSkills感想.docx（1 页以内）回答四个问题：选了 SOP 还是 Web？怎么判断 Skill 被调用了、生效了？最大不稳定点是啥？Agent Skills 和 MCP 有什么区别？

SOP Skill 评判

输出必须出现固定结构（背景 / 决策 / 待办 / 风险）；待办字段必须有 Owner 和 Deadline；信息缺了要标 UNKNOWN 不能编；如果涉及费用话题，应该能联动触发报销 Skill。

Web Skill 评判

页面能用浏览器直接打开；至少 4 个模块（Hero / 卖点 / FAQ / CTA）；代码结构清晰，CSS 可维护；要有验收 Checklist 或固定栏目证明 Skill 生效。

6.6 核心收获

本章小结

• 核心价值——稳定、复用、可验收，从临时 Prompt 升级为可复用 SOP

• 三级加载——元数据始终加载 → 指令触发时加载 → 资源按需加载，先触发再加载，既省上下文又不影响能力

• 三种触发——description（自动判断）/ glob（按文件类型）/ @skill/name（手动点名）

• Skills vs MCP——Skills 管流程规范（怎么做），MCP 管外部能力（用什么做）。组合使用最强

• 实操闭环——SKILL.md 配置 → list skills 验证 → 输入触发 → 结构化输出验收

下一模块进入**「MCP 集成与工具开发」**——让 AI 直接查你的数据库、访问 GitHub、搜索互联网，从"封闭空间里的助手"变成"能连接一切的 Agent"。