用途:按 Steinberger 标准给生成的 CLI 打分,并对两个 CLI 做并排比较。
主要能力:支持三种模式——不带参数对当前 CLI 重新评分、按名称或路径对单个 CLI 评分、输入两个标识符做对比评分。评分输出为 JSON,包含 api_name、steinberger 各维度分数、总分、百分比、总体等级与 gap_report。维度分两层:Tier 1 基础设施(Output Modes、Auth、Error Handling、Terminal UX、README、Doctor、Agent Native、Local Cache、Breadth、Vision、Workflows、Insight,均按 /10);Tier 2 领域正确性(Path Validity、Auth Protocol、Data Pipeline Integrity、Sync Correctness 按 /10,Type Fidelity、Dead Code 按 /5)。
使用方式:需 Go 1.26.9 或更新版本,且 PATH 中有 cli-printing-press 二进制(安装命令 go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest)。运行前需执行 setup 契约,确认二进制位于 PATH、解析 scope 变量并捕获 PRINTING_PRESS_BIN 绝对路径,后续调用使用该绝对路径;还需用 <PRINTING_PRESS_BIN> version --json 检查版本不低于 min-binary-version 4.0.0。评分核心命令为 cli-printing-press scorecard --dir <路径> --json,找到 spec 时可加 --spec <spec路径>;对比模式并行执行两次 scorecard。名称会依次在库目录、运行状态与归档状态中解析,多个匹配时给出编号菜单选择。
限制与注意事项:无 spec 时 spec 相关维度标记为 N/A 并从分母中剔除,JSON 中仍编码为 0,需依赖 unscored_dimensions 区分;scorecard 不运行二进制,执行证明由 verify 和 dogfood 负责;learn loop 默认开启,仅内部目录存在不加分,评分看 teach/recall/learnings 注册与非空实体查找种子。错误处理会报告二进制缺失、命令失败、目录不存在或 JSON 解析失败。