用途
tech-decision 是一个用于系统性分析技术决策并得出综合结论的技能。当用户提出“技术决策”“该用哪个”“A 与 B(对比)”“比较分析”“库选择”“架构”等问题时,应使用该技能。
核心原则是结论先行:所有报告先呈现结论,再提供证据。
主要能力与使用场景
根据资料,该技能适用于以下决策类型:
- 库/框架选型(React 与 Vue、Prisma 与 TypeORM)
- 架构模式决策(单体与微服务、REST 与 GraphQL)
- 实现方式选择(服务端与客户端、轮询与 WebSocket)
- 技术栈决策(语言、数据库、基础设施等)
决策工作流
资料将其分为四个阶段。
阶段 1:问题定义
明确决策主题与上下文:
- 识别主题:需要决定什么?
- 识别选项:要比较哪些选择?
- 建立标准:按什么标准评估?例如性能、学习曲线、生态、可维护性、成本等。
- 根据项目特征设定优先级。
详细标准参见 references/evaluation-criteria.md。
阶段 2:并行信息收集
必须并行从多个来源收集信息:
- codebase-explorer 代理:分析现有代码库,识别模式/约束。
- docs-researcher 代理:研究官方文档、指南、最佳实践。
- Skill: dev-scan:收集社区意见(Reddit、HN、Dev.to 等)。
- Skill: agent-council:收集各种 AI 专家视角。
- [可选] 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 哪个更好?”
执行步骤:
- Task docs-researcher + Task codebase-explorer(并行)
- Skill: dev-scan
- Task tradeoff-analyzer
- Task decision-synthesizer
2. 深度分析(复杂决策)
用户提问:“正在考虑使用哪个状态管理库”
执行步骤:
- Task codebase-explorer(分析当前状态)
- 并行执行:
- Task docs-researcher(Redux、Zustand、Jotai、Recoil 等)
- Skill: dev-scan
- Skill: agent-council
- Task tradeoff-analyzer
- Task decision-synthesizer
注意事项
- 提供上下文:结合项目特征、团队规模、现有技术栈可提高分析准确性。
- 确认标准:先确认对用户而言重要的标准是什么。
- 显示可靠性:标记不清晰或过时的来源。
- 结论先行:始终先呈现结论。
限制
资料未提供该技能的收费、价格、具体平台支持范围或量化效果等信息。