用途:这是一个指导创建新 Claude Code Skill 的技能,当用户想新建技能、添加技能或询问如何为 Claude 编写技能时使用。
主要能力与流程:
- 先获取最新最佳实践(必需):用 WebFetch 读取 https://code.claude.com/docs/en/skills 与 https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices。
- 判断是否应合并进已有技能(必需):用 ls -la .claude/skills/ 查看现有技能,按主题相关性、子主题、工作流相似度决定合并或新建。
- 拆分已有技能:文件大于 10 KB 或 1000 行、使用场景差异大、工作流独立、触发词不同时拆分;相关度高、共享概念、文件小于 5 KB 时保留在一起。给出 Token 节省公式与拆分策略(保守、适中、激进)。
- 收集需求:询问要自动化的任务、触发条件、项目级或用户级、所需工具。
- 创建结构:标准结构为 .claude/skills/1k-<skill-name>/SKILL.md 加 references/rules/*.md;单主题可用仅 SKILL.md 的简单结构。
- 应用最佳实践:命名用 1k- 前缀、小写字母数字连字符、不超过 64 字符、避开保留词;描述用第三人称、含触发关键词、不超过 1024 字符;SKILL.md 正文控制在 500 行内,细节放规则文件。
- 输出后运行 Token 分析自检:python3 development/skills-analysis/analyze-skills-tokens.py --sort-by-size,并给出 Token 数量对应的处理建议。
适用场景:为 OneKey 等项目创建或重构 Claude Code Skill,管理技能合并与拆分,优化技能 Token 占用。
限制:资料主要面向 OneKey 项目约定(1k- 前缀、特定技能分类),其他项目需自行调整;未提供收费、价格或平台支持信息。