SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 20:21

技能介绍

用途:本技能面向创建新技能、编辑已有技能或在部署前验证技能是否有效的场景,把测试驱动开发(TDD)方法应用到流程文档写作中。核心原则是:如果没有先观察智能体在没有该技能时失败,就无法确认技能教的是正确内容。使用前要求先理解 superpowers:test-driven-development 技能,其中定义了 RED-GREEN-REFACTOR 循环。

主要能力:给出技能的定义与边界(技能是可复用的技术、模式、工具和参考指南,而非一次性问题解决叙事);提供 TDD 映射(测试用例对应子智能体压力场景,生产代码对应 SKILL.md,RED 对应无技能时违规,GREEN 对应有技能时遵守,重构对应堵漏洞);说明何时创建技能(技术不直观、跨项目复用、模式通用、对他人有益)与何时不创建(一次性方案、已有标准实践、项目特定约定、可用正则或校验自动化的机械约束)。

使用方式:技能目录采用扁平命名空间,每个技能一个目录,包含必需的 SKILL.md,必要时附支持文件。SKILL.md 的 YAML frontmatter 仅支持 name 和 description 两个字段,总长不超过 1024 字符;name 只用字母、数字和连字符;description 用第三人称,只描述何时使用,以“Use when...”开头,不总结技能流程。正文建议包含 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等部分。个人技能存放于智能体专属目录,如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.codex/skills。

适用场景与限制:适用于纪律约束型、技术型、模式型和参考型技能,不同类型需不同测试方式。铁律是“没有失败测试就不写技能”,对新建和编辑同样适用。资料未提供具体收费、价格或平台支持范围等信息。