6. Claude 技能(Skills)系统完整指南。Anthropic 发布的 "The Complete Guide to Building Skills for Claude",从基础到高级覆盖全了。核心:把对 Claude 的定制化做成可复用的文件夹,不再每次对话都重说一遍偏好和流程。1. 本质:Skill = 一个文件夹 + SKILL.mdSkill 的结构极其朴素:- SKILL.md(必须有):Markdown 写的指令 + YAML frontmatter- scripts/:可选,Python/Bash 之类的可执行脚本- references/:可选,按需加载的文档- assets/:可选,模板、字体等YAML frontmatter 最关键——它就是告诉 Claude "什么时候该用这个技能"。字段只有 name(kebab-case)+ description(必须包含触发条件描述)。比如:description: Analyzes Figma design files and generates developer handoff docs. Use when user uploads .fig files, asks for "design specs", or says "design-to-code handoff".写得好的 description 同时包含:干什么 + 什么时候用 + 具体用户可能说的话。2. 三种 Skill 类型Anthropic 总结了实践中最常见的三类:第一类:文档 & 资源创建。不需要外部工具,纯靠 Claude 内置能力生成高质量输出——前端页面、演示文稿、报告之类。关键是内嵌 style guide 和质量检查清单。第二类:工作流自动化。多步骤流程,有验证门控。比如 skill-creator 本身就是这个类型的代表。第三类:MCP 增强。这是最有意思的一类——你的 MCP server 提供了工具访问能力,Skill 教 Claude 怎么用这些工具。Kitchen 比喻很形象:MCP 是厨房设备,Skill 是菜谱。3. 渐进式披露是核心设计哲学三层加载机制,token 效率拉满:第一层:frontmatter 始终加载,只给 Claude 足够判断是否需要这个技能的信息第二层:SKILL.md 正文在 Claude 认为相关时才加载第三层:references/ 里的文件按需发现,不主动塞进上下文4. 最佳实践写 instruction 时记住一点:"你是在教一个聪明的人,不是在编程一台机器"。- 给出 direction 而不是 exhaustive rules。"Look for repeated code" 比列一百条命名-规则管用得多- 解释 why,让 Agent 能推理而不是机械执行- feedback 要零摩擦,直接在 PR 上评、在 issue 上评,不要额外提交步骤- keep skills small,大逻辑拆成多个小 skill 组合- improver skill 高度可复用,别重复造轮子5. 五个生产级模式文章还总结了五种 pattern:- 顺序工作流编排 —— 明确步骤依赖,每步做校验- 多 MCP 协调 —— 跨服务的数据传递 + 分阶段验证- 迭代优化 —— 初稿 → 质检 → 修正循环 → 知道什么时候停- 上下文感知的工具选择 —— 决策树选工具,透明化理由- 领域智能注入 —— 合规检查、风险控制等专业判断嵌进流程6. 总结Claude 的技能体系把「连接能力」(MCP)和「领域知识」(Skill)解耦了。MCP 负责通到外部服务,Skill 负责教 Claude 怎么用得好。分开管,各司其职,这套架构思路值得参考。来源:resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf#how i ai# #程序员#