Skill Development Rules 是一份针对 Claude 技能(Skill)开发流程的规则说明,适用于在 .claude/skills/ 目录中维护技能文件的人员。其核心目标是让技能定义保持简洁、可维护、可触发,并避免与实现细节混杂。
用途
该规则用于指导如何组织与编写技能文件,尤其是 SKILL.md 的结构,以及技能与触发配置、脚本目录之间的配合方式。
SKILL.md 结构要求
规范采用“DO / DON'T”的形式。
应做的事(DO):
- 保持
SKILL.md简洁,少于 200 行; - 包含清晰的“When to Use”(何时使用)章节;
- 提供可直接复制粘贴的 bash 命令;
- 引用
scripts/目录处理 MCP 操作; - 在
skill-rules.json中添加触发条件(triggers)。
不应做的事(DON'T):
- 在
SKILL.md中写入实现细节; - 在多个技能之间重复内容;
- 创建技能时不在
skill-rules.json中配置对应触发条件; - 使用不需要的
allowed-tools。
MCP 包装技能
对于包装 MCP 脚本的技能,规则补充:
- 使用
allowed-tools: [Bash, Read]来限制能力; - 指向
scripts/目录中的脚本; - 包含参数文档。
适用场景
适用于在 Claude 环境中编写、组织或审查技能文件时,作为一致性与结构约束的参考。
限制
资料仅包含上述规则文本,未提供安装命令、配置示例、工具版本要求、收费信息或平台兼容性说明,这些内容暂未提供。