SuperAPI AI 工具集

duck-design

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

duck-design 是一个面向软件开发团队的设计讨论引导工具,来自 sprngr/cantrips 技能集。它的定位不是替团队做技术决策,而是通过结构化的提问和对比,帮助团队把设计讨论引向更清晰、更可权衡的方向。其口号是“质疑一切、比较替代方案”,并带有一种“原始人模式常开”的直白风格。

用途 该工具主要用于技术方案评审、架构讨论和设计决策场景。当团队需要评估多种实现路径、识别潜在风险、挑战既有假设时,duck-design 提供了一套可复用的讨论框架。它不产出代码,也不直接给出“应该用 X”的结论,而是把选择权和权衡责任交还给团队。

主要能力

  1. 权衡分析框架:针对每一个设计选择,从构建复杂度、维护复杂度、性能、可靠性、灵活性、交付时间等维度,对多个选项进行对比。每个单元格填写“高/中/低/短”或简短理由,形成设计矩阵。
  2. 架构层面的假设挑战:聚焦系统级约束而非运行时取值。对每个决策追问:如果负载、数据或用户增长 10 倍会怎样?这个 API 变更是否向后兼容?如果出问题,回滚路径是什么?六个月后谁来维护?对于空值检查、空输入、过期缓存等运行时问题,则转交 duck-debug 处理。
  3. 替代方案建议模式:先简要呈现开发者已有方案,用一句话肯定其优势(不树立稻草人),用一句话指出具体弱点(不抽象),提出一个能解决该弱点的替代方案,并说明该替代方案引入的新权衡,最后问“你接受哪个权衡”。始终避免“你应该用 X”,而是“X 给你 Y,但代价是 Z,接受吗?”
  4. 决策提示:以问题而非处方的方式呈现。例如,面对深层嵌套条件时问“这些是在隐藏一个状态机,还是只需要守卫子句?”;面对模块紧耦合时问“这里的抽象成本是否值得引入接口?”;面对共享可变状态时问“这需要不可变性,还是消息传递就够了?”;面对非结构化控制流时问“状态机是否合理,还是只需要提前返回?”;面对破坏性 API 变更时问“版本化端点还是功能开关,你接受哪种表面积?”;面对循环依赖时问“依赖倒置还是外观模式,哪种间接层更合适?”

使用方式 该工具以技能形式提供,具体安装命令和调用方式在现有资料中暂未提供。从描述看,它通过对话式引导发挥作用,适合在代码评审、架构讨论或设计文档评审过程中使用。

适用场景 适用于需要多方案对比的技术选型、架构评审、API 设计讨论、模块解耦决策等场景。尤其适合团队在讨论中容易陷入“直接给结论”或“过早优化”时,用它来拉回权衡视角。

限制 不替团队做决定,只呈现选项;不提倡过早扩展(如微服务、新数据库、重型基础设施),仅标记为“以后考虑”;提及新技术前始终与当前技术栈比较;如果问题本质是调试问题而被包装成设计语言,则转交 duck-debug。