SuperAPI AI 工具集

superpowers-writing-skills

写作与研究

查看项目

更新于 10-16 05:07

技能介绍

用途:本技能把测试驱动开发(TDD)应用到流程文档编写,指导创建、编辑和部署前验证技能。适用于需要复用、跨项目适用且对他人有价值的技巧、模式与工具文档。

主要能力:以 RED-GREEN-REFACTOR 循环编写技能。先写压力测试场景并观察基线失败,再编写技能文档(SKILL.md),验证智能体遵守后重构以堵住漏洞。核心原则是:若没有观察过智能体在无技能时的失败,就无法确定技能教得对。官方最佳实践另见 anthropic-best-practices.md。

技能类型与结构:分为技巧(具体步骤)、模式(思维方式)、参考(API、语法、工具文档)。目录为 skills/skill-name/SKILL.md,扁平命名空间。SKILL.md 含 YAML frontmatter,必填 name 与 description,总长不超过 1024 字符;name 仅用字母、数字和连字符。description 用第三人称,以 Use when... 开头,只描述触发条件,不总结工作流,尽量控制在 500 字符内。正文含概述、何时使用、核心模式、快速参考、实现、常见错误等。

使用方式:为便于未来发现,description 要覆盖关键词、症状与错误信息,命名用主动语态动词优先,如 creating-skills。常用技能需控制字数,频繁加载的技能建议 200 词以内,其他 500 词以内;大段参考拆到单独文件。引用其他技能时仅写技能名并加明确要求标记,如 REQUIRED SUB-SKILL: 或 REQUIRED BACKGROUND:,避免使用 @ 链接以免强制加载消耗上下文。流程图仅用于非显而易见的决策点或循环,可用 ./render-graphs.js 渲染 SVG。

适用场景:创建新技能、编辑现有技能、部署前验证。

限制:使用前必须理解 superpowers:test-driven-development。铁律为没有失败测试就不写技能,新技能和编辑均适用。面向不同技能类型(纪律约束、技巧、模式、参考)需采用不同测试方式,包括学术问题、压力场景、应用与变化场景、检索与缺口测试。常见跳过测试的借口均不成立,未测试不应部署。