SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-16 05:44

技能介绍

用途:在创建新技能、编辑现有技能或部署前验证技能时使用。核心是把测试驱动开发(TDD)迁移到流程文档:先写压力测试场景并观察代理在没有技能时失败(RED),再编写技能文档,观察代理在技能存在时遵守(GREEN),最后重构以封堵漏洞。核心原则是:如果没有先看到代理在没有该技能时失败,就无法确认技能教会了正确的东西。使用前必须理解 superpower-planning:tdd,其中的 RED-GREEN-REFACTOR 循环是本技能的基础。

主要能力:覆盖何时创建技能(非显而易见、可跨项目复用、广泛适用、他人受益);技能类型划分(技巧、模式、参考);目录结构(每个技能一个目录,含必填 SKILL.md,重参考或可复用工具拆分为独立文件);SKILL.md 结构与 frontmatter 仅支持 name 和 description 两个字段,总计不超过 1024 字符。强调 Claude 搜索优化:description 只写“何时使用”(以 Use when... 开头),不要总结技能工作流,否则 Claude 可能只读描述而跳过正文。还涉及关键词覆盖、动词优先命名、token 效率(常用技能 <150/200/500 词目标)、交叉引用(只用技能名并标注必选)、流程图仅用于非显而易见决策、代码示例宜少而精、文件组织。

使用方式:按 RED-GREEN-REFACTOR 编写与验证;用三类技能对应的测试方式(纪律型用学术问题和压力场景,技巧型用应用与变体场景,模式型用识别场景,参考型用检索场景);可用 wc -w 检查词数,用 render-graphs.js 渲染流程图:./render-graphs.js ../some-skill 或加 --combine。铁律:没有失败测试就不写技能,对新技能和修改同样适用。

适用场景:为代理编写可复用技能、修改既有技能、部署前验证。限制:需要先掌握 TDD;技能格式字段有限;测试成本不可省;不适用于一次性方案、已有良好文档的标准实践、项目专属约定或可用正则/校验机械约束的规则。资料中未提供收费、价格、支持平台等信息。