SuperAPI AI 工具集

awesome-design-doc

设计与创作

查看项目

更新于 10-16 06:22

技能介绍

用途:把功能请求或架构问题转化为团队可执行、未来读者可追溯的决策文档。适用于“设计 X”“如何构建 Y”“写设计文档/ADR/RFC”等场景,或评审中标记出需要 ADR 的承重决策。可逆的日常选择不应触发。

主要能力:先写可测试的功能需求与约束(规模、延迟、一致性、可用性、合规、运维方),做量级估算并标注假设;先画契约(API/事件、数据模型与不变量)再谈内部实现;生成 2–3 个真实备选方案并按需求激活的权衡轴评估;给出与需求标签绑定的推荐、翻转条件与设计上限;先做反向风险推演,再列非目标、风险与缓解、迁移/发布顺序与回滚(含数值触发条件与不可逆点);必要时为实施者写 brief,描述接口与行为契约而非文件路径。

使用方式:按输出格式交付 Markdown 文件,放入仓库既有文档约定目录(如 docs/adr/、docs/design/),文件名遵循所在目录约定,不覆盖已有文档。ADR 采用 Status、Context、Decision、Alternatives considered、Consequences 等结构。交付前按自检清单核对占位符、章节完整性、备选数量、需求标签覆盖等。

限制:资料未提供具体安装命令、收费、平台或效果信息;不适用于可逆的日常选择。