SuperAPI AI 工具集

writing-design-plans

设计与创作

查看项目

更新于 10-15 21:36

技能介绍

用途:在头脑风暴完成后,把已验证的设计追加到已存在的设计文档中,并补全 Summary 与 Glossary 占位内容,形成可归档、可被后续实现计划引用的设计文档。

主要能力:设计文档位于 docs/design-plans/YYYY-MM-DD-<topic>.md,由 starting-a-design-plan 第三阶段创建,本技能负责追加正文。正文包含 Architecture、Existing Patterns、Implementation Phases、Additional Considerations 等章节。实现阶段建议不超过 8 个,每个阶段用 <!-- START_PHASE_N --> 与 <!-- END_PHASE_N --> 标记包裹,便于 writing-implementation-plans 逐个解析。阶段需写明 Goal、Components、Dependencies、Done when;涉及功能性的阶段必须包含验证对应验收标准的测试,基础设施阶段以可运行、可构建、可部署为完成标准。契约(API 端点、服务接口、数据库模式、消息格式)可完整规范并含类型代码块,但不写实现代码。

使用方式:先由 starting-a-design-plan 创建文档并确认 Definition of Done,再调用本技能追加正文;随后生成 Acceptance Criteria 并取得人工确认,最后生成 Summary 与 Glossary 替换占位符。写作风格建议使用 house-style:writing-for-a-technical-audience。

适用场景:需要把设计决策固化为可长期引用、可被多个实现计划依赖的文档时。

限制:不写实现代码、函数体、测试代码与逐步操作指令;不包含假设性的“锦上添花”功能;若阶段超过 8 个,需在 Additional Considerations 中说明需拆分为多个实现计划。具体安装命令与收费信息暂未提供。