SuperAPI AI 工具集

tech-decision

编程与开发

查看项目

更新于 10-16 05:58

技能介绍

用途

tech-decision 是一个用于系统性分析技术决策并得出综合结论的技能。当用户提出“技术决策”“该用哪个”“A 与 B(对比)”“比较分析”“库选择”“架构”等问题时,应使用该技能。

核心原则是结论先行:所有报告先呈现结论,再提供证据。

主要能力与使用场景

根据资料,该技能适用于以下决策类型:

  • 库/框架选型(React 与 Vue、Prisma 与 TypeORM)
  • 架构模式决策(单体与微服务、REST 与 GraphQL)
  • 实现方式选择(服务端与客户端、轮询与 WebSocket)
  • 技术栈决策(语言、数据库、基础设施等)

决策工作流

资料将其分为四个阶段。

阶段 1:问题定义

明确决策主题与上下文:

  • 识别主题:需要决定什么?
  • 识别选项:要比较哪些选择?
  • 建立标准:按什么标准评估?例如性能、学习曲线、生态、可维护性、成本等。
  • 根据项目特征设定优先级。

详细标准参见 references/evaluation-criteria.md。

阶段 2:并行信息收集

必须并行从多个来源收集信息:

  1. codebase-explorer 代理:分析现有代码库,识别模式/约束。
  2. docs-researcher 代理:研究官方文档、指南、最佳实践。
  3. Skill: dev-scan:收集社区意见(Reddit、HN、Dev.to 等)。
  4. Skill: agent-council:收集各种 AI 专家视角。
  5. [可选] Context7 MCP:按库查询最新文档。

阶段 3:综合分析

使用收集到的信息运行 tradeoff-analyzer 代理:

  • 整理每个选项的优缺点
  • 按评估标准评分
  • 整理存在冲突的观点
  • 基于来源评估可靠性

阶段 4:最终报告生成

使用 decision-synthesizer 代理生成结论先行的综合报告(详细模板见 references/report-template.md)。报告结构示例:

  • 标题:Technical Decision Report: [Topic]
  • 结论(执行摘要):建议方案 [Option X],附 1–2 句关键理由
  • 评估标准与权重:以表格列出标准、权重与说明
  • 方案分析:各方案的优点(标注来源,如官方文档、Reddit r/webdev)、缺点(标注来源,如 HN 讨论)、适合场景
  • 综合对比:以表格按标准对方案打分(示例使用星级与总分)
  • 推荐理由:逐条列出关键理由并标注来源
  • 风险与注意事项

使用的资源

代理(来自本插件):

代理 角色
codebase-explorer 分析现有代码库,识别模式/约束
docs-researcher 研究官方文档、指南、最佳实践
tradeoff-analyzer 整理优缺点,进行比较分析
decision-synthesizer 生成结论先行的最终报告

现有技能(通过 Skill 工具调用):

技能 用途 调用方式
dev-scan 来自 Reddit、HN、Dev.to 的社区意见 Skill: dev-scan
agent-council 收集各种 AI 专家视角 Skill: agent-council

快速执行指南

1. 简单对比(A 与 B)

用户提问:“React 与 Vue 哪个更好?”

执行步骤:

  1. Task docs-researcher + Task codebase-explorer(并行)
  2. Skill: dev-scan
  3. Task tradeoff-analyzer
  4. Task decision-synthesizer

2. 深度分析(复杂决策)

用户提问:“正在考虑使用哪个状态管理库”

执行步骤:

  1. Task codebase-explorer(分析当前状态)
  2. 并行执行:
    • Task docs-researcher(Redux、Zustand、Jotai、Recoil 等)
    • Skill: dev-scan
    • Skill: agent-council
  3. Task tradeoff-analyzer
  4. Task decision-synthesizer

注意事项

  • 提供上下文:结合项目特征、团队规模、现有技术栈可提高分析准确性。
  • 确认标准:先确认对用户而言重要的标准是什么。
  • 显示可靠性:标记不清晰或过时的来源。
  • 结论先行:始终先呈现结论。

限制

资料未提供该技能的收费、价格、具体平台支持范围或量化效果等信息。