writing-skills
当创建新 Skills、编辑现有 Skills，或在部署前验证 Skills 是否正常工作时使用。
技能说明obra/superpowers
当创建新 Skills、编辑现有 Skills，或在部署前验证 Skills 是否正常工作时使用。
技能简介
writing-skills 用于创建、编辑和验证 Skill。它将测试驱动开发（TDD）理念应用于技能文档编写：先观察 Agent 在无技能时的失败基线，再编写 SKILL.md 文档，最后验证 Agent 能正确遵从技能指导。
使用场景
- 创建新 Skill 或编辑现有 Skill
- 部署前验证 Skill 是否能正常工作
- 编写/优化技能描述（description），提升被 Agent 发现和加载的概率
- 将已验证的技术、模式沉淀为可复用的技能文档
使用方法
- 将个人技能存放在运行时的 skills 目录：Claude Code 为
~/.claude/skills/；Codex、Copilot CLI、Gemini CLI 也支持~/.agents/skills/跨运行时别名。 - 按 TDD 流程编写技能：
- RED：先运行基线场景，记录 Agent 在无技能时的违规行为
- GREEN：编写最小化 SKILL.md，针对具体违规点给出指导
- REFACTOR：验证 Agent 遵从技能后，继续寻找漏洞并循环补充
- SKILL.md 必须包含 YAML frontmatter（
name、description字段），正文建议包含 Overview、When to Use、Core Pattern、Quick Reference、Common Mistakes 等小节。
注意事项
- 核心原则：如果没有观察过 Agent 在无技能时如何失败，就无法确认技能是否教对了东西。
- description 字段只描述触发条件（何时使用），不要总结技能的工作流程，否则 Agent 可能跳过正文直接照做描述中的步骤。
- 技能是复用的技术、模式与参考指南，不是单次问题解决过程的叙述记录。