writing-skills

# 编写技能 (Writing Skills) ## 概述 **编写技能是将测试驱动开发 (TDD) 应用于流程文档。** **个人技能存储在特定于智能体的目录中（Claude Code 为 `~/.claude/skills`，Codex 为 `~/.codex/skills`）** 你需要编写测试用例（带有子智能体的压力场景）、观察它们失败（基准行为）、编写技能（文档）、观察测试通过（智能体合规）并重构（关闭漏洞）。 **核心原则：** 如果你没有观察到智能体在没有技能的情况下失败，你就不知道该技能是否教授了正确的内容。 **必需背景：** 在使用此技能之前，你必须了解 superpowers:test-driven-development。该技能定义了基本的 RED-GREEN-REFACTOR（红-绿-重构）循环。此技能将 TDD 适配到文档编写中。 **官方指导：** 有关 Anthropic 官方技能创作最佳实践，请参阅 anthropic-best-practices.md。本文档提供了补充模式和指南，以完善此技能中以 TDD 为中心的方法。 ## 什么是技能？ **技能**是针对经过验证的技术、模式或工具的参考指南。技能帮助未来的 Claude 实例查找并应用有效的方法。 **技能是：** 可重用的技术、模式、工具、参考指南 **技能不是：** 关于你曾经如何解决某个问题的叙述 ## 技能的 TDD 映射 | TDD 概念 | 技能创建 | | ----------------------- | ------------------------------------------------ | | **测试用例** | 带有子智能体的压力场景 | | **生产代码** | 技能文档 (SKILL.md) | | **测试失败 (RED)** | 智能体在没有技能的情况下违反规则（基准） | | **测试通过 (GREEN)** | 智能体在有技能的情况下合规 | | **重构** | 在保持合规的同时关闭漏洞 | | **先写测试** | 在编写技能之前运行基准场景 | | **观察失败** | 记录智能体使用的确切合理化理由 | | **最小代码** | 编写解决这些特定违规行为的技能 | | **观察通过** | 验证智能体现在合规 | | **重构循环** | 寻找新的合理化理由 → 填补 → 重新验证 | 整个技能创建过程遵循 RED-GREEN-REFACTOR。 ## 何时创建技能 **在以下情况创建：** - 技术对你来说不是直观明显的 - 你会在不同项目中再次引用此内容 - 模式适用范围广