用途:创建新技能、编辑现有技能,或在部署前验证技能是否有效。核心原则是把测试驱动开发(RED-GREEN-REFACTOR)套用到流程文档上:先写测试用例(带子智能体的压力场景),看它失败(基线行为),再写技能文档,看测试通过(智能体遵守),最后重构(堵住漏洞)。若未观察到智能体在无技能时失败,就无法确认技能教的是对的东西。使用前提是必须先理解 superpowers:test-driven-development,本技能只是把 TDD 迁移到文档。个人技能存放在各智能体专属目录(Claude Code 为 ~/.claude/skills,Codex 为 ~/.codex/skills)。
主要能力:给出何时该创建技能(技术不显而易见、跨项目复用、模式普适、他人受益)、何时不该创建(一次性方案、已有充分文档的常规做法、项目专属约定应放 CLAUDE.md、可用正则或校验自动化的机械约束)。区分技能类型:技术(有步骤的具体方法)、模式(思考问题的方式)、参考(API、语法、工具文档)。规定目录结构(skills/技能名/SKILL.md,重参考或可复用工具拆成单独文件)。规定 SKILL.md 结构:frontmatter 仅 name 与 description 两个字段、合计不超过 1024 字符;description 用第三人称、以“Use when...”开头,只写触发条件,不要总结工作流,尽量控制在 500 字符以内。还提供 CSO(Claude Search Optimization)要点:关键词覆盖、动词优先命名、token 效率目标(入门工作流每篇少于 150 词、高频加载技能合计少于 200 词、其他少于 500 词,可用 wc -w 检查)、跨技能引用只用技能名并标注必要性、避免 @ 链接以免强制加载耗上下文。
流程图使用:仅用于非显而易见的决策点、可能过早停止的流程循环、A 与 B 的选择;参考材料用表格、代码示例用代码块、线性步骤用编号列表。可视化可用目录内脚本渲染:./render-graphs.js ../some-skill 或加 --combine。代码示例主张一个可运行、注释充分、来自真实场景的示例,不做多语言实现或填空模板。
测试与铁律:铁律是“没有失败测试就不写技能”,新建和编辑同样适用;违规需删除重来,不能把未测试的改动留作“参考”。不同技能类型测试方式不同:纪律约束型用学术问题与压力场景,技术型用应用与变体场景,模式型用识别与反例,参考型用检索与缺口测试。针对跳过测试的常见借口逐一给出反驳,并列出应对合理化说辞的做法(明确封堵漏洞、尽早加入基本原则、建立合理化对照表),还引用说服原则文档作为研究基础。
限制:必须遵守上述前置条件与测试要求;frontmatter 只支持 name 与 description;不要输出 HTML。资料未提供具体收费、价格、平台与效果数据。