构建 Claude Code 的经验：我们如何使用 Skills
来源：Thariq Shihipar (Anthropic)，2025-03-18
作者背景
Thariq Shihipar (@trq212) — Claude Code 团队工程师，Skills 功能核心推动者。曾联合创建开源学术发布平台 PubPub，Y Combinator W20 批次。
核心观点
Skills 已成为 Claude Code 中使用最广泛的扩展点之一。 Anthropic 内部活跃使用的 Skills 已有几百个。
常见误解：Skills "只不过是 markdown 文件"
实际情况：Skills 是文件夹，可以包含：
- 脚本
- 资源文件
- 数据文件
- 动态钩子（hooks）
智能体可以发现、探索和使用这些内容。
9 类 Skills 分类体系
1. 库与 API 参考
帮助正确使用某个库、命令行工具或 SDK。
示例：
billing-lib— 内部计费库的边界情况、容易踩的坑internal-platform-cli— 内部 CLI 工具的每个子命令及使用场景frontend-design— 让 Claude 更好地理解设计系统
2. 产品验证
描述如何测试或验证代码是否正常工作。
技巧：
- 让 Claude 录制输出过程的视频
- 在每一步强制执行程序化的状态断言
示例：
signup-flow-driver— 在无头浏览器中跑完注册→邮件验证→引导流程checkout-verifier— 用 Stripe 测试卡驱动结账 UItmux-cli-driver— 针对需要 TTY 的交互式命令行测试
3. 数据获取与分析
连接数据和监控体系的 Skills。
示例：
funnel-query— 注册→激活→付费转化需要关联哪些事件cohort-compare— 对比两个用户群的留存或转化率grafana— 数据源 UID、集群名称、问题→仪表盘对照表
4. 业务流程与团队自动化
把重复性工作流自动化为一条命令。
示例：
standup-post— 汇总任务追踪器、GitHub 活动和 Slack 消息→生成站会汇报create-<ticket-system>-ticket— 强制执行 schema + 创建后的工作流weekly-recap— 已合并 PR + 已关闭工单 + 部署记录→格式化周报
5. 代码脚手架与模板
为特定功能生成框架样板代码。
示例：
react-component— 带测试、story、样式的新组件api-endpoint— 带验证、错误处理、文档的新端点
6. 领域知识
在特定领域编码时的最佳实践和注意事项。
示例：
security-sensitive— 处理认证/授权代码时的安全 checklistperformance-critical— 性能敏感代码的测量和优化指南
7. 调试与诊断
排查特定类型问题的系统化方法。
示例：
memory-leak-detector— 内存泄漏排查步骤slow-query-analyzer— 数据库慢查询分析流程
8. 集成与部署
与外部系统的集成模式。
示例：
aws-deploy— AWS 部署的完整流程stripe-webhook— Stripe webhook 处理和测试
9. 团队约定
编码规范、命名约定、项目结构等。
示例：
naming-conventions— 项目命名规范folder-structure— 目录组织约定
Skills 编写技巧
1. 从真实工作流开始
不要凭空设计 Skill，先观察自己或团队的重复性工作。
2. 保持小而专注
一个 Skill 解决一类具体问题，而不是试图成为全能手册。
3. 包含可运行代码
尽可能提供可以直接运行的脚本或命令，而不仅是描述。
4. 使用渐进式披露
把最常用的信息放在前面，详细参考放在后面。
5. 定期更新
Skills 会随项目演进，定期 review 和更新保持其准确性。
关联
- claude-code/overview — Claude Code 概述
- harness-engineering/skills-into-loops — Skills Into Loops
- product-trends/ai-pm-onboarding — AI PM 实践