本篇目标工具只是“锤子”而技能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 《木工完全指南》 老师傅的经验。二、为什么要封装 Skills1. 降低 Prompt 复杂度渐进式披露如果你把“发布上线”的所有步骤100 行字都写在 System Prompt 里Context 很快就爆了。封装成 Skill 后System Prompt 只需要一句“当用户想发布时调用DeployToProd技能。”只有当 AI 真的决定发布时它才会去读取这个技能的具体步骤。这叫渐进式披露Progressive Disclosure。2. 知识复用你可以把“如何排查 Java 内存泄漏”写成一个 Skill。以后任何新来的 AI Agent或者新同事只要加载了这个 Skill立刻变成排查专家。三、如何编写一个 SkillSKILL.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 或 TraeSystem: “你是一个开发者。请遵守skills/git_commit.md中的规范。”AI 会自动读取这个文件作为上下文。方法 B通过 MCP 动态加载企业级如果你搭建了 MCP Server可以把skills/目录作为一个 Resource 暴露出去。AI 可以在运行时动态查找“我想知道怎么提交代码有相关技能吗” - Server 返回git_commit.md的内容。五、本篇产出技能编写检查清单写 Skill 时对照这个表检查项为什么有明确的触发条件吗AI 得知道“什么时候”用这个技能。步骤是线性的吗AI 喜欢 Step 1, 2, 3不喜欢复杂的跳转。包含反例吗告诉它“不要写成什么样”如不要写中文 Commit。依赖的工具都齐了吗如果步骤里说“运行测试”AI 手里得有run_test工具。练习题把“周报”封装成 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、工具和记忆组合成一个能独立干活的“数字员工”。