Decision Frameworks

🎯 结构化决策,告别拍脑袋选型

工程决策结构化方法论,涵盖库选型、架构对比、自研/采购决策、优先级排序、可逆性分析及ADR文档模板,提升技术决策质量与可追溯性。

收藏
6.9k
安装
2.6k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Decision Frameworks 是一套系统化的工程决策方法论,帮助技术团队在面临复杂选择时建立理性、可追踪的决策流程。核心用法包括:

1. 加权评分矩阵 — 对3个以上选项按多维度打分加权,消除主观偏好
2. Build vs Buy 决策树 — 通过核心差异化、成熟度、集成成本三层判断自研或采购

3. 库/框架评估清单 — 9项硬性指标(维护活跃度、社区规模、Bundle体积、TS支持、破坏性变更历史、许可证、安全审计、文档质量)快速筛选依赖

4. 架构对比表 — 覆盖单体vs微服务、SQL vs NoSQL、REST vs GraphQL、SSR/CSR/SSG、Monorepo vs Polyrepo等经典场景的权衡维度

5. RICE优先级评分 — (Reach × Impact × Confidence) / Effort 量化排序需求

6. 可逆性检查(Two-Way Door) — 识别单向门(高成本回退)与双向门(低成本试错)决策,差异化投入分析精力

7. ADR轻量模板 — 标准化记录重大技术决策,支持状态流转与版本追溯

显著优点

  • 对抗认知偏误:显式化权重与评分机制,有效抑制HiPPO(最高薪者意见)、从众效应、沉没成本谬误
  • 加速决策节奏:双向门决策可"快速决策-发布-度量-迭代",避免分析瘫痪
  • 降低长期维护成本:库选型前的9项检查大幅减少技术债务引入
  • 团队对齐工具:结构化输出便于跨角色沟通,减少决策反复讨论
  • 知识资产沉淀:ADR形成可审计的决策历史,支撑新人 onboarding 与季度复盘

潜在局限

  • 量化幻觉风险:权重与评分仍含主观判断,过度信任数字可能忽视质性因素
  • 上下文依赖:部分框架(如微服务适用条件)需结合团队规模、域名成熟度调整
  • 轻量级场景过重:简单决策使用完整流程反而降低效率,需灵活裁剪
  • 工具链依赖:ADR需配套版本控制与检索机制,否则易成文档垃圾

适合人群

  • 技术负责人/架构师:面临技术栈选型、架构演进决策
  • 工程经理:需要团队对齐框架、优先级排序方法
  • 全栈/前端工程师:评估UI框架、构建工具、部署方案
  • 开源维护者/平台团队:制定内部工具采纳标准

常规风险

  • 决策僵化:过度依赖模板可能抑制创造性方案涌现,需保留"直觉校验"环节
  • 指标游戏:为凑高分而操纵权重,违背框架初衷
  • ADR腐化:决策后续状态更新不及时,导致文档与实现脱节,反而误导后人

安全解读

核心用法

decision-frameworks 是一套面向工程团队的结构化决策工具集,以 Markdown 文档形式提供,无可执行代码。核心功能覆盖:

1. 决策矩阵模板:加权评分法,适用于 3+ 方案对比,量化权重×评分得出最优解
2. 自建 vs 采购框架:决策树+因素对比表,帮助判断核心差异化能力应自建还是外购

3. 库/框架选型清单:8 维度评估(维护活跃度、社区规模、包体积、TS 支持、破坏性变更史、许可证、安全审计、文档质量)

4. 架构对比表:单体 vs 微服务、SQL vs NoSQL、REST vs GraphQL、SSR/CSR/SSG、Monorepo vs Polyrepo

5. 优先级方法:RICE 评分(Reach × Impact × Confidence / Effort)与 MoSCoW 分类(Must/Should/Could/Won't)

6. 可逆性检查:区分「单向门」(不可逆,需深度分析)与「双向门」(可快速回退)

7. ADR 模板:轻量级架构决策记录格式,用于沉淀决策上下文与后果

显著优点

  • 零代码风险:纯 Markdown,无函数调用、无依赖、无网络请求
  • 即开即用:模板可直接复制到 Notion/Confluence/Linear 使用
  • 决策纪律:强制量化评分,减少 HiPPO(最高薪资者意见)和乐队花车效应
  • 可逆性思维:帮助团队识别哪些决定可以「快速试错」,哪些必须「三思后行」
  • 知识沉淀:ADR 模板确保决策上下文可追溯,避免重复争论

潜在缺点与局限性

  • 模板化陷阱:矩阵评分可能过度简化复杂权衡,需结合领域经验「sanity-check」
  • 无自动化集成:不提供与 Jira/Linear 等工具的 API 集成,需手动搬运
  • 权重主观性:评分标准与权重由人设定,可能引入隐性偏见
  • T3 来源:维护者为个人开发者 wpank,虽仓库公开透明,但长期维护承诺未知
  • 无版本管理:Skill 本身未提供决策历史版本控制机制

适合人群

  • 技术负责人/架构师:需要系统化评估技术选型
  • 产品经理:需要 RICE/MoSCoW 方法对需求进行量化优先级排序
  • 工程师:面临「这个库该不该引入」「这个服务该不该拆分」等具体决策
  • 团队:需要建立决策纪律,减少会议争论与决策反复

常规风险

  • 过度分析:框架可能诱发「分析瘫痪」,需设定决策截止日期
  • 文档债务:ADR 若只写不读,会成为形式主义,建议季度回顾
  • 适用边界:框架适用于「多选项可量化对比」场景,对创新探索型决策(0→1 突破)指导有限

Decision Frameworks 内容

手动下载zip · 7.1 kB
README.mdtext/markdown
请选择文件