src-Claude-Skill-编写实战
来源 skill claude 教程 开发
来源数 1 Fri Apr 10 2026 08:00:00 GMT+0800 (China Standard Time)
src-Claude-Skill-编写实战
原始来源： raw/260311-Claude-Skill-编写与实战指南-洛小山-公众号.md
作者： 洛小山、林哲韬（译）
日期： 2026-03-11
原文：Anthropic The Complete Guide to Building Skills for Claude
一句话摘要
Anthropic 官方 Claude Skill 构建指南的中文翻译，涵盖从规划设计、MCP 增强、测试迭代到分发共享的完整实战手册。
关键收获
- Skill 核心原则：
- 渐进式披露：YAML 元数据（始终加载）→ SKILL.md 正文（触发时加载）→ 链接文件（按需读取）。
- 可组合性：不要假设自己是唯一可用的 Skill。
- 可移植性：Claude.ai、Claude Code、API 行为一致。
- MCP vs Skill 的厨房比喻：MCP 提供专业厨房（工具/食材/设备），Skill 提供食谱（一步步说明怎么做出有价值的成果）。
- 三类常见用例：
- 文档与资产创建（frontend-design）
- 工作流自动化（skill-creator）
- MCP 增强（sentry-code-review）
- YAML 前置元数据最关键：
description决定 Skill 的可发现性，结构应为 [它做什么] + [何时用] + [核心能力]。 - 指令结构推荐：Goal → Workflow → Constraints → Examples → Error Handling。
- 测试迭代：触发测试 → 功能测试 → 性能对比（with/without skill）。
- 故障排查：上传失败检查 SKILL.md 大小写、YAML 格式、kebab-case；不触发则优化 description；触发太频繁加负面触发词。
提及的实体
- 洛小山
- 林哲韬