ring:writing-skills

Writing Skills 是一套将流程文档转化为 AI 代理可执行与可测试代码的系统化方法论。通过将文档视为“生产代码”，并将交互情境视为“单元测试”，此技能为所有流程指南强制执行严格的 RED-GREEN-REFACTOR 循环。它专为工程师、系统架构师和提示工程师设计，确保 AI 代理在复杂工作流程中始终如一地执行，而不会在压力下偏离或合理化违规行为。流程始于定义基准失败情境，观察代理当前行为，撰写文档以解决具体差距，并持续迭代直到代理的表现对于常见失败模式达到绝对可靠。

• 实作文档创建的 RED-GREEN-REFACTOR 循环：定义失败情境、执行测试、撰写技能、并重构以填补漏洞。

• 利用子代理驱动的压力测试，将 AI 代理推向边缘情境，以验证对文档规则的遵守情况。

• 通过要求在创建文档前提供基准失败证据，有效防止代理进行“合理化”违规。

• 专注于创建可重复使用的技术、模式和参考指南，而非单次使用的解决方案。

• 提供 SKILL.md 结构化模板，包含名称与描述的元数据字段，确保通过代理搜索优化 (ASO) 进行高效发现。

• 最适用于需要高可靠性工作流、合规性要求高或复杂技术程序的场景。

• 不适用于一次性解决方案或已有现成文档的标准实务。

• 使用者需熟悉测试驱动开发 (TDD) 原则，以有效创建和重构压力测试情境。

• 文档应保持精简以优化 Token 使用效率；利用特定触发条件与症状来引导代理自动加载。

• 在“红色”阶段务必记录代理所有的具体合理化行为，以便在“绿色”阶段建立更强大、更健全的文档。