Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity
gitlink-cli/skills/gitlink-gatekeeper/examples/scorecard-sample.md

4.0 KiB
Raw Blame History

评分卡样例（scorecard-sample）

这是 gitlink-gatekeeper 渲染到 PR 评论的 评分卡 的样例输出，严格套用 REFERENCE.md 第 6 节模板。 本样例对应一个 REQUEST_CHANGES（含硬门禁失败）案例，用于展示模板的全部分区（硬门禁、Must fix、Should fix、Nits、Strengths、Next steps 同时出现）。 数值来自默认策略 gatekeeper.yaml（权重 40/20/15/15/10，blocker=100/major=25/minor=5/nit=1，pass=85、request_changes=60），可按第 3–5 节算法逐项复算。

输入快照（用于复算）

信号 值
变更文件总数 changed_files 6
匹配 source_globs 的源码文件 changed_src 4
匹配 test_globs 的测试文件 changed_tests 0
AI 审查发现 0 blocker / 1 major / 2 minor / 1 nit
PR 描述 非空，长度 64 字符（≥30）
关联 Issue 否（body 无 #<n>）
commits 共 4 条，符合 Conventional Commits 的 3 条
CI 状态 passing

逐维复算

  • review_findings（权重 40）：penalty = 25(major) + 2×5(minor) + 1(nit) = 36； score = 40 × max(0, 1 − 36/40) = 40 × 0.1 = 4
  • test_coverage（权重 20）：changed_src=4 > 0 且 changed_tests=0 → score = 0
  • pr_hygiene（权重 15）：描述≥30 ✓(+1/3)；关联 Issue ✗(0)；体量 changed_files=6 ≤ max_changed_files/2 = 40 ✓(+1/3) → 命中比例 2/3； score = round(15 × 2/3) = round(10.0) = 10
  • commit_quality（权重 15）：conforming/total = 3/4；score = round(15 × 3/4) = round(11.25) = 11
  • ci_status（权重 10）：passing → score = 10
  • 总分：4 + 0 + 10 + 11 + 10 = 35

硬门禁判定

门禁 配置 命中？
forbid_blocker_findings true 否（无 blocker）
require_ci_pass true 否（CI passing）
require_tests_for_src_changes true 是（changed_src=4>0 且 changed_tests=0）
require_linked_issue false —（未启用）
max_changed_files 80 否（6 ≤ 80）

hard_gate_failed = true → 裁决直接 REQUEST_CHANGES（无视总分；本例总分 35 < 60 亦指向 REQUEST_CHANGES，结论一致）。

渲染的评分卡（回写到 PR 的正文）

## 🛡️ Gatekeeper Report — PR #128 feat(auth): add refresh-token rotation

**Verdict: ❌ REQUEST_CHANGES**  ·  Score: 35/100  ·  policy: gatekeeper.yaml@v1

| Dimension | Weight | Score | Notes |
|-----------|:------:|:-----:|-------|
| Review findings | 40 | 4/40 | 0 blocker / 1 major / 2 minor / 1 nit |
| Test coverage   | 20 | 0/20 | 4 src / 0 test files |
| PR hygiene      | 15 | 10/15 | desc ✓ / linked issue ✗ / size ✓ |
| Commit quality  | 15 | 11/15 | 3/4 conventional |
| CI status       | 10 | 10/10 | passing |

### ⛔ Hard gate failures (1)
- `require_tests_for_src_changes`: 改动了 4 个源码文件，但本 PR 未包含任何测试文件

### 🔴 Must fix (1)
- [major] 刷新令牌轮换未对旧令牌做失效处理，存在重放风险 — internal/auth/refresh.go:88

### 🟡 Should fix (2)
- [minor] `rotateToken` 缺少超时上下文，可能阻塞请求 — internal/auth/refresh.go:54
- [minor] 错误信息直接回显内部字段名，建议脱敏 — internal/auth/handler.go:131

### 🔵 Nits (1)
- [nit] 导出函数 `NewRotator` 缺少 doc 注释 — internal/auth/refresh.go:22

### ✅ Strengths
- commit 历史清晰，3/4 符合 Conventional Commits
- CI 全绿，PR 描述完整

### Next steps
1. **补测试**：为改动的 4 个源码文件添加单元测试，解除 `require_tests_for_src_changes` 硬门禁
2. 修复 major 重放风险后重新触发 gatekeeper
---
*Generated by gitlink-gatekeeper · policy-as-code PR gate · re-run after changes*

复算提示：把上表「输入快照」的数值代入 REFERENCE.md 第 3 节公式即可重现每一维得分；硬门禁按第 4 节逐项比对；最终裁决按第 5 节判定树得出。同策略 + 同输入 → 同评分卡（确定性）。