src-Claude-Skill-编写实战

来源 skill claude 教程开发来源数 1 Fri Apr 10 2026 08:00:00 GMT+0800 (China Standard Time)

原始来源： 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；触发太频繁加负面触发词。