mcpField
D
decision-eval

decision-eval

github.com/avelikiy开发10850 次安装今天更新
代码仓库

关于 decision-eval

Decision Eval 是一项开发技能，用于为 ADR 或架构文档中的备选方案评分。符合文档规定的条件时，它会调用 decision-scorer Agent，并向架构师呈现建议。

主要功能

  1. 01检测多个具名方案
  2. 02检查调用与跳过条件
  3. 03调用 decision-scorer
  4. 04将评分报告存入 docs/decisions/
  5. 05向架构师展示建议

适用场景

  1. 01比较 ADR 中的方案
  2. 02在 gate:arch 前评估备选项
  3. 03审阅建议并记录是否覆盖

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/avelikiy/great_cto --skill decision-eval

安装后在 Claude Code 中输入/decision-eval确认已加载。

详细介绍

决策评估——对架构方案进行自动评分

在架构师提出 2 个或更多方案后、创建 gate:arch 之前调用。

调用时机

仅当以下条件全部满足时，才调用此技能：

  1. 一份 ADR（docs/adr/ADR-*.md）或 ARCH 文档（docs/architecture/ARCH-*.md） 中包含一个列出 2 个或更多命名方案的部分（查找 ## Alternatives Considered、## Options 或以粗体前缀标记的方案，例如 **Option A:**）
  2. 架构师尚未创建 gate:arch
  3. 用户未说“skip scoring”、“no scoring”或“skip decision-eval”
  4. PROJECT.md 中的 project_size 不是 nano

如果任一条件不满足，则静默跳过（甚至不要提及）。

如何调用

阅读最新的 ADR 或 ARCH 文档，确认其中存在 2 个或更多方案，然后以文件路径作为上下文，启动 decision-scorer Agent：

# Identify target document
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)

# Confirm 2+ variants
VARIANT_COUNT=$(grep -cE "^\*\*[A-Za-z]|^### [A-Za-z]|^- \*\*[A-Za-z]" "$TARGET" 2>/dev/null || echo 0)

如果 VARIANT_COUNT >= 2，则调度该 Agent：

Agent: decision-scorer
Context: <TARGET file path>
Task: Score the architectural variants in <TARGET> against .great_cto/PROJECT.md criteria.
      Save output to docs/decisions/.

输出位置

decision-scorer Agent 会将结果保存到：

docs/decisions/DECISION-<slug>-<YYYYMMDD>.md

Agent 完成后，读取输出文件，并向架构师提供建议：

Decision scoring complete:
  Recommended: <variant name> (<score>/5.00)
  Runner-up:   <variant name> (<score>/5.00)
  Full report: docs/decisions/DECISION-<slug>-<YYYYMMDD>.md

Architect: review the scoring rationale before accepting or overriding the recommendation.

跳过条件

若符合以下任一条件，则不输出任何内容并继续下一步：

  • PROJECT.md 中的 project_size: nano
  • ADR/ARCH 文档中的方案少于 2 个
  • 用户消息中包含“skip scoring”、“skip decision-eval”或“no scoring”
  • 目标文档是修复 bug 或仅涉及文档的 ADR（检查标题是否包含“fix:”、“docs:”或“chore:”）

与架构师工作流的集成

此技能位于 agents/architect.md 中的第 4 步（编写 ADR）和第 5 步（创建 gate:arch）之间。架构师按名称调用它：

Invoke skill: decision-eval

评分完成后，架构师可以：

  • 接受建议 → 按建议的方案继续创建 gate:arch
  • 覆盖建议 → 在创建 gate:arch 之前，在 ADR 中新增一个 ## Scoring Override 部分并记录理由

评论

支持 Markdown