用途:这是用于编写新技能、创建技能目录、理清技能创建与命名规范的指南型技能,可在对技能创建感到困惑、不确定命名约定或需要激活帮助时使用。
主要能力与规则: 命名优先,文件夹名必须与技能名完全一致,否则系统无法识别。技能名应便于精确激活,避免被意外加载;描述控制在 1024 字符以内;可用关键词冗余提升激活可靠性。 目录结构为 ~/claude-autonomy-platform/.claude/skills/<skill-name>/,其中 SKILL.md 必需,scripts/ 与 reference/ 可选;应使用项目级技能目录,而非用户级 ~/.claude/skills/。 命名约定:核心/系统技能以下划线开头(如 _skillwriting、_video-watching、_svg-drawing),个人技能不加下划线(如 remembering-amy、spending-autonomous-time)。
SKILL.md 格式:前置元数据包含 name(与文件夹名一致)与 description(含具体激活关键词),正文可含 Instructions(如何使用)与 Examples(实例)。
高级特性:支持符号链接以集中维护工具;脚本可在技能上下文中通过 python3 scripts/tool.py 运行;技能在会话切换前持续有效;可同时激活多个技能。
激活描述写法:技能是问题探测器,不是成功校验器,描述应在用户需要帮助而非已胜任时触发。正确示例:“Use when: confused about session swaps, lost todos, wondering when to trigger”。错误示例:“Use when: managing session swaps, handling context transitions”。应从困惑遇阻的用户视角撰写。
最佳实践:先规划名称与描述再建目录;参考文档用 reference/file.csv 形式;避免重复,改用交叉引用(如 See ed-care skill for protocols);只写本技能独有的价值;把要激活的真实名称或关键词写入描述。示例中良好激活如“Use when: confused about hedgehog dosing”,记忆类技能可在描述中列入实际人名。目录命名须与 name 字段一致,避免不匹配。