SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 01:50

技能介绍

用途:该技能面向“技能(Skill)”的编写与维护,把测试驱动开发(TDD)方法应用到流程文档上。核心原则是:如果没有先观察智能体在缺少该技能时的失败行为,就无法确认技能教的是正确内容。使用前要求先理解 superpowers:test-driven-development 技能,它定义了 RED-GREEN-REFACTOR 循环。

主要能力:给出技能的定义与类型(技术、模式、参考),说明何时应创建技能(非显而易见、可跨项目复用、适用范围广、对他人有益),何时不应创建(一次性方案、已有充分文档的标准做法、项目特定约定、可用正则或校验自动化的机械约束)。提供目录结构(skills/skill-name/SKILL.md 及必要的支撑文件)、SKILL.md 结构(YAML frontmatter 仅支持 name 和 description,总计不超过 1024 字符;name 仅用字母、数字和连字符;description 用第三人称、以“Use when...”开头、只描述触发条件而不总结工作流)。还涵盖 Claude 搜索优化(关键词覆盖、动词优先命名、token 效率目标)、跨技能引用写法、流程图使用场景、代码示例选择、文件组织方式,以及针对不同类型技能(纪律约束型、技术型、模式型、参考型)的测试方法。

使用方式:按 RED-GREEN-REFACTOR 流程操作——先写压力场景测试并观察基线失败,再编写技能文档,然后验证智能体是否遵守,最后重构以堵住漏洞。铁律是“没有失败的测试就不写技能”,对新建和编辑同样适用。可用 wc -w skills/path/SKILL.md 检查字数,用 ./render-graphs.js 渲染流程图。

适用场景:创建、编辑或部署前验证技能时使用。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分内容(如 persuasion-principles.md、anthropic-best-practices.md)仅被引用,未给出完整内容。