AgentSkillsCN

Technical Decision Evaluation

用于复杂技术选型、架构决策及权衡评估。当需要记录不可逆决策、对比多个方案或明确技术约束时使用。

中文原作
SKILL.md
--- frontmatter
name: Technical Decision Evaluation
description: 用于复杂技术选型、架构决策及权衡评估。当需要记录不可逆决策、对比多个方案或明确技术约束时使用。

核心流程

  1. 收集约束:明确业务目标、性能、成本及复杂度等硬性约束。
  2. 定义准则:确定评估维度(如数据模型简洁度、运维复杂度、LLM 可重构性等)。
  3. 方案对比:至少提出两个对立方案,列出各自的核心设计、优缺点及风险。
  4. 决策归档:选择最佳方案,并根据 assets/decision-template.md.trae/documents/ 目录下生成记录文件,命名格式:YYMMDD-<tech-decision-name>.md
  5. 设定规则:明确后续实现中不可违反的强制性规则(Mandatory Rules)。

关键规则

  • 透明权衡:必须显式记录“放弃了什么”以及“为什么放弃”。
  • LLM 友好:决策必须考虑代码是否易于被 AI 持续维护和重写(Regenerability)。
  • 强制约束:区分“推荐做法”与“强制规则”,后者必须在实现中严格遵守。
  • 触发重议:必须定义何时需要重新评估该决策(如技术演进、规模增长等)。