logo
0
0
WeChat Login

docs(governance): quality-dashboard 初始化阈值 + 新增 §七 可执行测量命令#26

Merged
created 2 weeks ago
main
feature/quality-dashboard-init-thresholds
Edit
OverviewCommits
2
Files changed
3
Attachments

关闭 LESSONS §六 新团队落地第 3 步「初始化 quality-dashboard 的阈值」
这条长期悬空的待办——把"棘轮策略:先测后填"从口号变成可执行命令。

改动

§二 P1 表

  • #10/#11/#12 的 <按首次测量填> 占位改为实测保底值 + 示例
    • #10 行覆盖率 83%(本仓库 scaffold skills 实测)
    • #11 行+分支覆盖率 80%
    • #12 核心业务覆盖率 96%(renderers/ 子目录)
  • #14 技术债数量:18(grep TODO/FIXME/XXX/HACK)
  • 新增 #15 规则派生声明覆盖率(12/12 = 100%)
  • 新增 #16 抽象化残留数(15 处命中 / 0 真实残留)
  • #15 / #16 明确标注为"纯文档/规则仓库 / 治理仓库"可选指标

§三 P2 表

  • 原 #15~#19 重编号为 #17~#21(给 P1 新增的 #15/#16 腾位)

§四 单一事实源

  • 更新门禁编号映射(#13-14 / #15-16 / #17-19 / #20-21 分段说明)

§五 反模式

  • "等 owner"的门禁引用 #16#18(P2 重编号后)
  • 新增一条反模式:"初始化阈值时抄理想值而不测真实水平"

§六 迁移步骤

  • "19 项"改为更准的"三类结构,项数视项目形态可增减"
  • 明确 #15/#16 对纯规则仓库才有意义

新增 §七:本仓库(纯文档/规则/Agent Harness)的具体执行

这是本次最核心的产出:

  • §7.1 把 9 个 P0 门禁映射到本仓库可执行命令(py_compile /
    unittest / validate_skill_meta / --list-stacks 等)
  • §7.2 给出 P1 棘轮初始化的 5 条 copy-paste 即可跑的测量命令
    (coverage / grep / ls + grep)
  • §7.3 4 步首次落地 SOP(测 → 填 → CI → 4 周复盘)
  • §7.4 本仓库 2026-05 首次测量示例值表,含"自举小启示"——
    修改本仪表盘本身会让 #14/#16 波动

LESSONS §六 维度表

  • quality-dashboard 行描述从"5 项棘轮"改为"7 项棘轮 + §七 可执行测量"
  • 新团队落地第 3 步指向 §七 的测量命令

交付前硬门禁(全部通过)

  • ✅ Python 真实编译(25/25 测试通过)
  • ✅ _meta.json schema 校验(9/9 通过)
  • ✅ 覆盖率实测:80% 行+分支、83% 行、96% 核心业务
  • ✅ §七 每条测量命令都真实跑过,数字与 §7.4 / §二 示例一致
  • ✅ 元原则抽象化自验证(前一个 commit 修复了唯一真实残留)
is using the merge method to merge into0d4778d0
合并来自 feature/quality-dashboard-init-thresholds 的合并请求 #26

Successfully merged and closed

branch can be safely deleted
Reviewer
None yet
Assignee
None yet
Label
None yet
Participant