SuperAPI AI 工具集

tech-decision

编程与开发

查看项目

更新于 10-15 10:24

技能介绍

用途

Tech Decision 用于评估技术提案、回答“我们是否应该用 X 替代 Y”这类问题、比较工具以及评估架构建议。它的目标是把随意的技术讨论,转化为清晰、有数据支撑、团队可以据此行动的分析。

主要能力

技能按照固定流程执行:

  1. 输出设置:在项目根目录创建 project-decisions/ 目录,并按 YYYY-MM-DD-短描述.md 格式生成文件名。
  2. 理解提案:从问题或讨论中提取被提议的变更、提出者、要解决的问题、当前状态、触发原因以及受影响方;同时扫描代码库,查找当前工具与提议工具的引用、现有集成与依赖、已有决策记录和相关配置。
  3. 框定决策:写出中立的决策陈述,列出约束条件(时间线、预算、团队产能、技术约束),并至少识别三个选项:保持现状、提议的变更、混合或替代方案。
  4. 分析每个选项:包括可行性分析(能否做到、是否具备技能与工具、是否与现有技术栈集成、有无阻碍、是否经过验证)、工作量与时间线(研究、概念验证、实现、迁移、测试、文档、上线各阶段的人天估算)、成本分析(月度服务费、一次性工程投入、持续维护、培训、迁移成本、风险成本,并汇总第一年与第二年的总成本)、风险评估(供应商锁定、团队知识、可扩展性、可靠性、安全、数据完整性、回滚、兼容性、维护负担、合规等,并给出可能性、影响与缓解措施)、影响分析(代码库、API 契约、数据库、基础设施、CI/CD、监控、文档、团队工作流、其他团队、最终用户)。
  5. 对比矩阵:按权重对“解决问题、实现工作量、持续成本、风险、可扩展性、团队经验、可逆性”等标准打分,计算加权得分,并总结每个选项的优缺点与未知项。
  6. 给出建议:根据决策框架输出“推进 / 先做限时调研 / 推迟 / 不做”,并说明推荐选项、理由、关键因素、收益、取舍与成功条件。
  7. 后续步骤:根据建议类型给出不同的行动清单、时间线、成功指标与回滚触发条件。
  8. 保存输出:始终把完整分析保存为 Markdown 文件到 project-decisions/ 目录,并自动生成或更新索引 README.md。

使用方式

该技能以技能形式提供,具体安装与调用方式暂未提供。使用时,用户提出技术提案或决策问题,技能会按上述流程执行分析,并最终在项目根目录的 project-decisions/ 目录下生成决策文档。文档包含日期、状态、提出者、决策者、背景、决策、选项、对比矩阵、建议、风险与缓解、后续步骤以及决策日志。

适用场景

  • 评估“是否应该用 X 替代 Y”的技术提案
  • 比较不同工具或技术方案
  • 评估架构建议
  • 需要把技术讨论沉淀为可追溯的决策记录
  • 需要量化成本、工作量、风险与影响范围

限制

  • 具体安装命令、调用方式、收费与价格信息暂未提供。
  • 技能依赖代码库扫描来获取上下文,若代码库不可访问或信息不足,分析可能受限。
  • 分析结果的质量取决于输入信息的完整性与准确性。
  • 技能不替代团队决策,最终决定仍需由决策者做出。