SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 06:24

技能介绍

用途:本技能用于创建新技能、编辑已有技能,或在部署前验证技能是否有效。其核心是把测试驱动开发(TDD)应用到流程文档上:先写测试用例(用子代理构造压力场景),观察失败(基线行为),再写技能文档,观察通过(代理遵守),最后重构(堵住漏洞)。核心原则是:如果没有先观察代理在无技能时失败,就无法确定技能教的是对的东西。

主要能力:给出技能的定义与边界(技能是可复用的技术、模式、工具、参考指南,不是一次性解决问题的叙事);提供 TDD 映射表(测试用例对应压力场景,生产代码对应 SKILL.md,RED 对应无技能时违规,GREEN 对应有技能时遵守,重构对应堵漏洞);说明何时创建技能(技术不直观、会跨项目复用、模式适用面广、他人受益)与何时不创建(一次性方案、已有充分文档的标准实践、项目特定约定、可用正则或校验自动化的机械约束);区分技能类型(技术、模式、参考);规定目录结构(扁平命名空间,SKILL.md 必需,重参考或可复用工具才拆文件);给出 SKILL.md 结构与 YAML frontmatter 字段约束(name 必填、最多 64 字符、小写字母数字连字符、须与父目录同名;description 必填、最多 1024 字符;license、compatibility、metadata、allowed-tools 可选);强调 Claude 搜索优化(CSO),description 只写触发条件、不总结工作流,否则代理可能只读描述而不读正文;给出关键词覆盖、动词优先命名、token 效率目标(入门工作流每篇少于 150 词,高频加载技能总计少于 200 词,其他少于 500 词);说明交叉引用其他技能时只用技能名并标注必需性,不用 @ 链接以免强制加载消耗上下文;规定流程图仅用于非显然决策点、流程循环和 A/B 选择,参考材料用表格列表;代码示例只给一个完整可运行、注释解释原因的真实例子;文件组织分自包含、带可复用工具、带重参考三类。

使用方式:需先理解 superpowers-ruby:test-driven-development 技能,它定义了 RED-GREEN-REFACTOR 循环。铁律是:没有先失败的测试就不写技能,新技能和编辑都适用;先写技能后测试则删除重来。测试按技能类型区分:纪律约束型用学术问题、压力场景、多重压力组合;技术型用应用场景、变体场景、信息缺失测试;模式型用识别场景、应用场景、反例;参考型用检索场景、应用场景、缺口测试。可用 wc -w 检查字数,用 render-graphs.js 渲染流程图,例如 ./render-graphs.js ../some-skill 或加 --combine。

适用场景与限制:适用于编写可复用技能文档并验证其有效性。官方最佳实践见 anthropic-best-practices.md,说服原理见 persuasion-principles.md。资料未提供具体收费、价格、平台支持范围或效果数据。