W
writing-skills

writing-skills

obra
2026-04-06

在创建新技能、编辑现有技能或在部署之前验证技能是否有效时使用


简介

writing-skills 技能为创建和评估其他 AI 技能提供了一个元框架。它通过将提示词工程视为一项纪律严明、测试驱动的工程任务,解决了开发者编写低效、臃肿或过于具体的 AI 提示词的问题。

核心理念

“编写技能就是将测试驱动开发(TDD)应用于流程文档。”如果在没有特定指令的情况下,你没有观察到 AI 代理在任务中失败,就不应该将该指令硬编码为一项技能。

安装与调用指南

https://github.com/obra/superpowers

工作流程解析 (SOP)

阅读原始 SKILL.md

  • TDD 映射:该技能直接将 TDD 的概念映射到提示词工程(例如,测试用例 = 子代理面临的压力场景,生产代码 = SKILL.md)。
  • 观察失败(基线测试):在编写任何文档之前,作者必须运行一个基线场景,准确记录 AI 为了绕过最佳实践而使用的各种借口和辩解。
  • 何时创建技能:指示用户仅为那些不直观且具有广泛适用性的技巧创建技能,明确建议不要为一次性的解决方案或特定项目的约定编写技能。
  • SKILL.md 结构:规定了新技能的严格格式,例如要求描述必须使用第三人称,并以“在……时使用(Use when…)”开头,以确保清晰的触发条件。

技能设计评价

  • 人类经验 SOP 化的亮点:将测试驱动开发(TDD)的原则巧妙地应用于编写文档和提示词工程的过程中。明确界定了何时应该创建技能,何时应依赖现有标准实践的清晰标准。
  • 潜在的局限性:将文档编写完全等同于软件测试(要求首先具备失败的基线场景),对于记录简单直观的实用模式来说可能显得过于繁重。
  • 优质技能的评判标准:它迫使创作者通过验证 AI 代理在没有该技能时确实会失败,来经验性地证明该技能的价值,从而确保只有真正必要且有效的约束才会被固化为技能。