SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 21:39

技能介绍

用途:该技能面向编写、修改和部署前验证 AI 智能体技能(Skill)的场景,核心思路是把测试驱动开发(TDD)应用于流程文档:先写测试用例(用子智能体构造压力场景),观察失败(无技能时的基线行为),再编写技能文档,观察测试通过(智能体遵守规则),最后重构以堵住漏洞。核心原则是:如果没有亲眼看到智能体在没有该技能时失败,就无法确认技能教的是对的内容。

主要能力:给出技能的定义与边界(技能是可复用的技术、模式、工具和参考指南,而非一次性解决问题的叙事);提供 TDD 与技能创建的映射表;说明何时该创建技能(技术不直观、会跨项目复用、模式适用面广、对他人有价值)以及何时不该创建(一次性方案、已有充分文档的标准实践、项目专属约定、可用正则或校验自动化的机械约束);区分技能类型(技术、模式、参考);规定目录结构与 SKILL.md 结构(YAML frontmatter 必填 name 和 description,总计不超过 1024 字符,name 仅用字母、数字和连字符,description 用第三人称且只描述何时使用、以 Use when 开头、尽量不超过 500 字符);强调描述字段不要概括技能流程,否则智能体可能只读描述而不读正文;给出关键词覆盖、动词优先命名、token 效率、交叉引用、流程图使用、代码示例和文件组织等写作规范;并针对纪律约束型、技术型、模式型、参考型技能分别给出测试方法,以及应对智能体合理化借口的加固手段。

使用方式:资料要求使用前必须先理解 superpowers:test-driven-development 技能,它定义了 RED-GREEN-REFACTOR 循环;官方技能编写最佳实践见 anthropic-best-practices.md。个人技能存放在智能体专属目录(Claude Code 为 ~/.claude/skills,Codex 为 ~/.agents/skills/)。可用 wc -w skills/path/SKILL.md 检查字数,用 ./render-graphs.js ../some-skill 或加 --combine 渲染流程图。铁律是:没有先失败的测试就不写技能,对新建和编辑同样适用。

适用场景与限制:适合需要沉淀可复用技术、模式或参考文档并希望验证其有效性的智能体工作流。资料未提供具体收费、价格、平台支持范围或效果数据,暂未提供。