SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-16 00:31

技能介绍

用途:当设计已完成、需要为工程师产出详细实现任务时使用。该技能假设执行者对代码库几乎没有上下文,因此要求把每个任务所需信息写清楚,包括要改哪些文件、相关代码、测试与文档、以及如何测试。

主要能力与要求:计划需以固定头部开始,包含功能名、目标、架构与技术栈;必须先写测试部分,说明如何验证行为,并注明“我会在添加任何实现行为之前编写所有测试”。测试应针对真实行为,不应只测数据结构、类型或 mock。计划需按小任务拆分,遵循 DRY、YAGNI、TDD;不直接写代码,但细节要足以让必要代码显而易见;除非明确要求,否则不写文件到磁盘。

使用方式:先阅读 Guidelines,再创建计划;考虑向后兼容、边界情况、需要澄清的问题,并强调如何测试;最后把计划呈现给用户。计划中若出现绝对路径,必须考虑可能已创建的 worktree。计划结尾需包含测试细节、最多 10 条实现细节要点,以及待解答的问题或顾虑。

适用场景:设计已定、需要交给缺乏代码库背景的工程师执行时。限制:资料未提供具体安装命令、平台支持、收费或价格信息。