编写 Skills

来自 Superpowers 项目的 Skill 编写指南，将测试驱动开发（TDD）方法应用于流程文档的创建。该 Skill 教导如何通过系统化的测试和验证流程，创建有效的 Skills 文档。

核心原则

如果你没有观察到 agent 在没有 skill 的情况下失败，就无法确定 skill 教授了正确的内容。

这是 TDD 应用于文档的核心理念：必须先证明问题存在，然后通过 skill 解决问题，最后验证 skill 的有效性。

什么是 Skill？

Skill 是经过验证的技术、模式或工具的参考指南，帮助未来的 Claude 实例找到并应用有效方法。

Skill 不是简单的说明文档，而是经过测试验证的最佳实践。它记录了在特定场景下被证明有效的方法，确保 AI agent 能够一致地应用这些方法。

TDD 流程

1. 编写测试用例

使用 subagent 创建压力场景，测试 agent 在没有 skill 指导下的行为。设计能够暴露问题的测试场景。

2. 观察失败

运行测试，观察 agent 的基线行为。记录 agent 在没有 skill 时如何失败或表现不佳。这建立了改进的基准。

3. 编写 Skill

基于观察到的失败，编写 skill 文档。明确说明正确的方法、模式和技术。提供清晰的指导和示例。

4. 观察通过

使用新编写的 skill 重新运行测试。验证 agent 现在能够正确遵守 skill 的指导。确认 skill 解决了之前观察到的问题。

5. 重构

根据测试结果改进 skill。堵住漏洞，澄清模糊之处。确保 skill 在各种场景下都有效。

必备背景

必须首先理解 TDD 方法论。如果不熟悉测试驱动开发，需要先学习 TDD 的基本概念和实践。

TDD 的核心是：红（测试失败）→ 绿（测试通过）→ 重构（改进代码）。将这个循环应用于文档创建，确保 skill 的有效性。

Skill 存储

个人 skill 存放在 agent 特定目录：

• Claude Code 的 ~/.claude/skills
• 项目特定的 skills 目录

Skill 结构

标题和描述：清晰说明 skill 的目的和适用场景。

核心原则：阐述 skill 的基本理念和指导思想。

详细步骤：提供具体的操作步骤和方法。

示例：包含实际示例，展示 skill 的应用。

注意事项：说明常见陷阱和需要避免的错误。

应用场景

创建新 Skill：为新的工作流程或技术创建 skill 文档。通过 TDD 流程确保 skill 的有效性。

改进现有 Skill：识别现有 skill 的不足，通过测试和重构改进。

验证 Skill 有效性：定期测试 skill，确保它们在实际使用中仍然有效。

团队协作：为团队创建共享的 skill 库，统一工作方法。

应用价值

该 Skill 通过将 TDD 方法应用于文档创建，确保 Skills 的质量和有效性。不再依赖猜测或假设，而是通过实际测试验证 skill 的价值。

对于构建 AI agent 系统的团队，这种方法确保了 agent 行为的一致性和可预测性。经过验证的 skills 成为可靠的知识库，指导 agent 在各种场景下的行为。

通过系统化的测试和验证流程，该方法降低了 skill 失效的风险，提高了 AI 系统的整体质量和可靠性。