25｜Skills vs Tools：给 AI 传授“独门秘籍”

本篇目标：工具只是“锤子”，而技能（Skills）是“怎么用锤子造房子”。学会这一章，你就能把自己团队的 SOP（标准作业程序）打包成 AI 可执行的“技能包”。

一、Tool 和 Skill 到底有啥区别？

很多人会混淆这两个概念。

1. Tool（工具）：原子能力

• 性质：它是死的，它只是一个函数接口。
• 例子：read_file(path)（读文件）、run_sql(query)（查库）、send_email(to, body)（发邮件）。
• 特点：通用、无业务逻辑。谁都可以用read_file，但这不代表他知道该读哪个文件。

2. Skill（技能）：组合拳 + 经验

• 性质：它是活的，它是一套流程（Workflow）+知识（Knowledge）。
• 例子：DeployToProd（发布上线）。
  • 这个技能内部可能会调用：git_pull->run_tests->docker_build->k8s_apply。
  • 而且它包含了你的团队规范：“发布前必须检查测试覆盖率”、“发布后必须通知钉钉群”。
• 特点：高度定制化，包含了你的“独门秘籍”。

一句话总结：

• Tools= 锤子、锯子、螺丝刀。
• Skills= 《木工完全指南》 + 老师傅的经验。

二、为什么要封装 Skills？

1. 降低 Prompt 复杂度（渐进式披露）

如果你把“发布上线”的所有步骤（100 行字）都写在 System Prompt 里，Context 很快就爆了。
封装成 Skill 后，System Prompt 只需要一句：

“当用户想发布时，调用DeployToProd技能。”

只有当 AI 真的决定发布时，它才会去读取这个技能的具体步骤。这叫渐进式披露（Progressive Disclosure）。

2. 知识复用

你可以把“如何排查 Java 内存泄漏”写成一个 Skill。
以后任何新来的 AI Agent（或者新同事），只要加载了这个 Skill，立刻变成排查专家。

三、如何编写一个 Skill？（SKILL.md）

目前业界流行用 Markdown 来定义 Skill。

模板结构

# Skill Name: [技能名称，如 CodeReviewStandard] ## Description [简述：这个技能是干嘛的？什么时候用？] ## Steps (SOP) 1. [步骤 1] 2. [步骤 2] - 注意：[关键细节] 3. [步骤 3] ## Constraints - [红线 1] - [红线 2] ## Examples (Few-shot) User: [用户指令] Assistant: [AI 应该怎么做]

实战案例：编写“Git 提交规范”技能

你的团队要求 Git Commit 必须符合 Angular 规范（feat: ...）。

文件：skills/git_commit.md

# Skill: GitCommitStandard ## Description 用于生成符合团队规范的 Git 提交信息。当用户请求提交代码或写 Commit Message 时使用。 ## Format `<type>(<scope>): <subject>` ### Allowed Types - `feat`: 新功能 - `fix`: 修 Bug - `docs`: 文档 - `refactor`: 重构 (不改变逻辑) ## Steps 1. 分析 `git diff` 的内容。 2. 判断改动类型（是修 Bug 还是加功能？）。 3. 生成一行简短的英文描述（< 50 字符）。 4. 如果改动较大，补充 Body 部分。 ## Examples User: "我修改了登录逻辑，加了验证码" Assistant: `feat(auth): add captcha to login flow` User: "修复了首页图片不显示的 bug" Assistant: `fix(home): fix broken image rendering`

四、如何让 AI 学会这个 Skill？

方法 A：在 System Prompt 里引用（轻量级）

如果你用 Cursor 或 Trae：

System: “你是一个开发者。请遵守skills/git_commit.md中的规范。”
（AI 会自动读取这个文件作为上下文）。

方法 B：通过 MCP 动态加载（企业级）

如果你搭建了 MCP Server，可以把skills/目录作为一个 Resource 暴露出去。
AI 可以在运行时动态查找：“我想知道怎么提交代码，有相关技能吗？” -> Server 返回git_commit.md的内容。

五、本篇产出：技能编写检查清单

写 Skill 时，对照这个表：

练习题：把“周报”封装成 Skill

任务：你的团队周报需要包含：本周产出、下周计划、风险点。请把这个要求写成一个weekly_report.md。

# Skill: WeeklyReportGenerator ## Description Generate weekly reports based on user input or git logs. ## Structure 1. **Achievements**: What was done this week. 2. **Next Plan**: What to do next week. 3. **Risks**: Any blockers or delays. ## Constraints - Use bullet points. - Tone: Professional and concise. - No emojis. ## Example User: "我这周做了登录页，下周做注册页，目前没风险" Assistant: ### Achievements - Implemented Login Page UI and logic. ### Next Plan - Develop Registration Page. ### Risks - None.

下一步：我们已经有了工具（MCP）和技能（Skills）。现在，我们需要一个更强大的大脑来指挥它们——Agent（智能体）。
下一章我们将学习Agent 设计模式，看看如何把 LLM、工具和记忆组合成一个能独立干活的“数字员工”。