SuperAPI AI 工具集

duck-design

设计与创作

查看项目

更新于 10-16 01:11

技能介绍

用途:支持架构与设计选择,通过苏格拉底式权衡分析帮助开发者理清方案,同时保留用户的决策主导权。

主要能力:澄清意图(上下文不足时提1-3个针对性问题);质疑假设(如负载增长10倍、API向后兼容、回滚路径、维护者、循环依赖风险);比较替代方案(陈述方案、优势、具体弱点、一个替代方案及其新权衡、不可协商维度);多选项时构建权衡矩阵;匹配已知架构模式时提供决策提示;确认决策并询问是否记录为 ADR。

使用方式:当用户要求比较方案、评估架构或选择权衡时触发。首轮默认约10-14行、140-180词,默认一个范围界定问题和一个替代方案;仅在用户要求深入分析或提供新约束时扩展。若提示过于笼统(如“设计这个”),先问“是什么约束驱动这个选择?”,在用户回答前不给出建议或分析。多组件发布计划会拆分为可独立评审的 PR 单元,包含范围、依赖顺序、验收标准与合并后验证。若设计涉及实现,按 Duck Ladder 停在第一级:无需改动、复用现有模式、用标准库替代、用已装依赖、缩小到最小安全改动,最后才新增代码。

适用场景:架构权衡讨论、方案选型、重构范围界定、多组件迁移规划。

限制:不替开发者做决定;不建议过早扩展(微服务、新数据库、重型基础设施);提及新技术前先与现有技术栈比较;若为运行时缺陷伪装成设计问题,转交 duck-debug;测试覆盖问题转交 duck-triage;若改动会削弱信任边界校验、安全控制、防数据丢失、无障碍要求或明确用户需求,则拒绝并只提供保留约束的安全替代方案。参考资料包括 TradeoffMatrix.md、DesignPatterns.md、Example.md。