用途:writing-skills 把测试驱动开发(TDD)应用到流程文档编写中,用于创建与维护可复用的技能(SKILL.md)。技能是经过验证的技术、模式或工具参考指南,而非一次性问题叙述。
主要能力:以 RED-GREEN-REFACTOR 循环创建技能:先用子代理运行压力场景并记录代理在无技能时使用的原话式合理化理由(RED);针对这些具体违规编写最小技能(GREEN);再寻找新的合理化理由并逐一封堵、重测(REFACTOR)。作者强调铁律:没有先失败的测试,就没有技能,新增与编辑均适用,先写技能后测试须删除重来。
使用方式:技能存放在技能仓库(克隆到 ~/.config/superpowers/skills/)。采用平铺命名空间,每个技能一个目录,含必需的 SKILL.md 及可选支撑文件;SKILL.md 头部含 name、description、when_to_use、version、languages、dependencies 等字段,正文按 Overview、When to Use、Quick Reference、Implementation、Common Mistakes 等组织。when_to_use 以 when 开头,写具体触发症状而非语言特有症状,以提升被代理发现的概率。引用其他技能时只用路径名,不加 @ 前缀或 /SKILL.md 后缀,避免强制加载消耗上下文;重内容(100 行以上)与可复用工具拆分为独立文件。
适用场景:编写纪律约束型、技术型、模式型、参考型四类技能,分别用学术问题、压力场景、识别与应用场景、检索与缺口测试进行验证。
限制:需先有可运行子代理与本地仓库环境;技能不宜为一次性方案或已充分记录的通用实践;内容需控制字数以提高令牌效率;跨 GitHub Copilot、Claude Code、Codex 使用时需按各自目录约定放置。MCP 无必需服务器,缺失时使用回退提示词并依赖本地说明与随附资源。具体版本、依赖与价格等未在资料中提供。