writing-skills

Writing-skills 提供了一套基于测试驱动开发 (TDD) 的结构化方法，专门用于建立、优化和验证软件代理技能。该系统将文档视为代码，要求开发者在起草实际文档之前，通过子代理设定特定的压力场景，以建立代理行为的基准。这确保了每个技能都经过实证验证——观察代理在没有技能的情况下失败、编写技能来解决该失败、并通过后续测试验证合规性。它专为在 Claude Code 或 Codex 等环境中构建自定义技能的工程师和高级用户而设计，确保文档具有可操作性、准确性，并能抵御幻觉或误解。

• 实现流程文档的 RED-GREEN-REFACTOR 循环。

• 支持建立压力测试场景以验证技能的有效性。

• 提供扁平且可搜索的命名空间，用于管理复杂的代理专用技能。

• 将文档分为技术、模式和参考类型以实现模块化。

• 利用 YAML 前置元数据（frontmatter）进行机器可读的触发条件设置。

• 防止“工作流总结”陷阱，避免代理忽略逻辑而选择过度简化的描述。

• 在起草任何内容之前，务必先运行基准测试，以观察代理原始的解释方式。

• 使用此技能来建立可重复使用的技术、模式或工具，而非处理一次性问题或项目特定的约定。

• 如果任务可以通过正则表达式或自动化验证来解决，请优先考虑自动化而非手动编写文档。

• 使用以“Use when...”开头的明确触发条件来构建文档。

• 维持严格的模块化目录结构，以便于查找和整合。

• 与 Claude Code 或 Codex 环境搭配使用，以标准化开发周期中的代理行为。

• 确保文档保持简洁，优先采用可操作的模式和代码比较，而非叙事性描述。