SuperAPI AI 工具集

decision-eval

编程与开发

查看项目

更新于 10-15 17:22

技能介绍

用途:在 architect 提出 2 个以上架构备选方案后、创建 gate:arch 之前,自动对备选方案打分。

调用条件(需全部满足):docs/adr/ADR-.md 或 docs/architecture/ARCH-.md 中存在 2 个及以上具名备选方案(如 ## Alternatives Considered、## Options 或加粗前缀选项);architect 尚未创建 gate:arch;用户未表示跳过评分;PROJECT.md 中 project_size 不是 nano。任一条件不满足则静默跳过。

主要能力:读取最近的 ADR/ARCH 文档,确认备选方案数量,启动 decision-scorer 代理,依据 .great_cto/PROJECT.md 中的标准评分,输出加权评分表和推荐选择,保存到 docs/decisions/DECISION-<slug>-<YYYYMMDD>.md,并把推荐与次优结果反馈给 architect。

必要用法示例: TARGET=$(ls -t docs/adr/ADR-.md 2>/dev/null | head -1) [ -z "$TARGET" ] && TARGET=$(ls -t docs/architecture/ARCH-.md 2>/dev/null | head -1) VARIANT_COUNT=$(grep -cE "^**[A-Za-z]|^### [A-Za-z]|^- **[A-Za-z]" "$TARGET" 2>/dev/null || echo 0) 当 VARIANT_COUNT >= 2 时,调度 Agent: decision-scorer,Context 为文件路径,任务为按 PROJECT.md 标准评分并保存到 docs/decisions/。

跳过条件:project_size 为 nano、备选方案少于 2 个、用户消息含 skip scoring / skip decision-eval / no scoring,或目标文档是 fix/docs/chore 类。

与工作流集成:位于 agents/architect.md 的 Step 4(写 ADR)与 Step 5(创建 gate:arch)之间,由 architect 按名称调用。评分后 architect 可接受推荐进入 gate:arch,或在 ADR 新增 ## Scoring Override 段记录覆盖理由。

限制:文档未提供评分算法细节、权重定义方式、失败处理及代理权限范围,暂未提供。