用途:本技能用于创建新技能、编辑现有技能,或在部署前验证技能是否有效。核心原则是:如果没有看到代理在没有技能时失败,就无法确认技能教了正确的东西。使用前需要先理解“测试驱动开发(TDD)”,即红-绿-重构循环。
主要能力:把TDD映射到技能编写——测试用例对应子代理压力场景,生产代码对应技能文档SKILL.md,测试失败(红)对应代理在无技能时违反规则,测试通过(绿)对应代理遵守技能,重构对应堵住漏洞。技能分为技术、模式、参考三类。强调SKILL.md结构:YAML frontmatter只支持name和description两个字段,总共最多1024字符;name只用字母、数字和连字符;description用第三人称,只写何时使用(触发条件、症状),不要总结工作流程。
使用方式:创建技能时按红色(写失败测试、记录基线行为)、绿色(写最低限度技能)、重构(补漏洞)三个阶段进行,配套清单要求用TodoWrite为每项建立待办。可参考官方指南anthropic-best-practices.md;测试方法见testing-skills-with-subagents.md;渲染流程图可运行./render-graphs.js ../some-skill 或加 --combine 合并。技能存放位置:Claude Code为~/.claude/skills,AI代理为~/.agents/skills。检查字数可运行wc -w skills/path/SKILL.md。
适用场景:技术不直观、可重复引用、模式通用、他人受益的情况适合创建技能;一次性方案、已有详细记录的标准实践、项目专属约定(应放CLAUDE.md)、可用正则或验证强制执行的机械约束不适合。
限制:缺少失败测试就不应创建或编辑技能,没有例外;描述不总结工作流程,否则代理可能只读描述而跳过技能正文;文档要精简、避免多语言示例和讲故事;引用其他技能时只用技能名,避免@链接导致提前加载占用上下文。资料未提供具体收费、价格或平台信息。