用途
Example Skill 是一个演示型技能,用于展示 Claude Code 技能应遵循的结构与格式。它的定位是参考资料,而非解决某类具体业务问题的能力型技能。当你在创建新技能、需要一份可参照的范本时,或想理解技能的结构规范与最佳实践时,可以查阅此技能。
主要能力
根据资料,该技能可以:
- 演示规范的 YAML frontmatter 格式
- 展示内容结构方面的要求
- 提供附带资源(bundled resources)的示例
- 说明技能文档的最佳实践
何时使用
资料列出的适用情形包括:
- 创建新技能并需要参考示例
- 理解技能结构与最佳实践
- 学习如何将资源与技能一起打包
核心原则
- 原则一:目的清晰。技能应有明确、定义良好的用途,“何时使用”一节应让人一眼看出该技能适用于什么场合。
- 原则二:渐进式披露。内容应从高层概览逐步过渡到具体实现,先给出“何时使用”和“本技能做什么”,再深入工作流程。
- 原则三:可操作的工作流。提供可直接照着执行的逐步流程,并包含示例与反面模式。
使用方式(工作流程)
- 识别需求:判断当前任务是否适合使用该技能。
- 阅读文档:阅读技能文档,理解其能力与限制。
- 应用技能:按工作流步骤执行。
- 验证结果:检查技能是否达成了预期结果。
在示例场景中,资料给出创建“代码审查”新技能的做法:先参考本示例技能结构,再使用模板 steve/templates/AGENT_SKILL.template.md,填入领域相关内容,必要时添加附带资源。
最佳实践
- 让技能聚焦于单一领域或单一能力
- 包含清晰的示例和使用场景
- 记录反面模式,以避免常见错误
- 在资源确有价值时将其一并打包
反面模式
- 创建试图包揽一切、范围过宽的技能
- 跳过“何时使用”一节
- 缺少示例或使用场景
- 未记录附带的资源
附带参考文件
该技能在 references/ 目录中包含参考文件:
structure-guide.md:详细的结构指南examples.md:更多示例
限制
资料未提供该技能的价格、收费模式、平台支持范围、实际运行效果等信息,暂未提供。除文档中列出的文件与模板路径外,资料未描述其他安装命令或额外依赖。