SuperAPI AI 工具集

writing-skills

写作与研究

查看项目

更新于 10-15 21:36

技能介绍

用途:writing-skills 将测试驱动开发(TDD)应用于流程文档的编写,用于创建新技能、编辑已有技能,或在部署前验证技能是否有效。其核心原则是:写技能就是写测试——先写测试用例(压力场景),观察其失败(基线行为),再写技能,观察测试通过,最后重构以堵住漏洞。铁律是:没有先失败的测试,就不写技能。

主要能力:提供 TDD 概念与技能创建的映射(测试用例对应子智能体压力场景,生产代码对应 SKILL.md,RED 对应无技能时智能体违规,GREEN 对应有技能时遵守,Refactor 对应堵漏并重测);说明何时该创建技能(技术不直观、跨项目复用、模式适用面广、他人受益),何时不该创建(一次性方案、已有标准实践、项目专属约定应使用 CLAUDE.md);区分技能类型(Technique 具体方法、Pattern 思维模型、Reference 参考资料);给出目录结构与 SKILL.md 模板;描述 RED-GREEN-REFACTOR 循环与按技能类型的测试方法;列出常见借口及其反驳与反模式。

使用方式:按 RED 阶段创建压力场景、在无技能情况下运行并逐字记录基线失败、识别合理化模式;GREEN 阶段命名只用字母数字连字符、描述以 Use when 开头并用第三人称、针对基线失败、只给一个优秀示例、在有技能情况下运行验证;REFACTOR 阶段识别新的合理化、加入明确反驳、反复重测。清单建议用 TaskCreate(旧版 Claude Code 用 TodoWrite)逐项跟踪,最后提交推送并考虑通过 PR 贡献。

适用场景与限制:适合需要跨项目复用、模式适用面广的技能编写与部署前验证。资料要求先阅读 ed3d-extending-claude:writing-claude-directives 获取基础指导,并使用 ed3d-extending-claude:testing-skills-with-subagents 获取完整测试方法。资料未提供具体安装命令、收费、价格或平台信息。