最佳实践

编写简洁可靠的 Claude Agent Skills。

Agent Skills specification · Claude documentation

本站指南已对照当前官方参考核对，并非官方文档全文翻译。

源码在这里作为文档呈现。本站尚未执行或测试这些工作流程。

本页目录

这是 ClaudeSkills 原创指南，已于 2026-10-04 对照以下参考资料核对，并非官方文档全文翻译。

让触发条件具体

说明任务与使用情境。准备一个应触发的示例和一个相近但不应触发的请求，比较描述能否正确区分。

写清输入、步骤与完成标准。详细资料放入独立文件并直接链接，说明何时停止、补充信息或检查输出。

开放规范要求 name 与 description。名称应与目录一致，仅用小写字母、数字与连字符，最长 64 字符；描述必须非空，最长 1024 字符。compatibility 与 license 等可选字段可明确环境与授权。

使用具有代表性的输入并检查产物，加入含糊请求、缺失文件和不应触发的任务。记录结果，不把未经测试的源码宣称为已通过。