Skip to content

v6.31.0 — release-cut 一致性门（tag-orphan 硬门）+ retro 持久化 + SSOT 文档同步

Latest
Latest

Choose a tag to compare

View all tags
@pcliangx pcliangx released this 19 Jul 07:39
v6.31.0
e38a2aa
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

[v6.31.0] — 2026-07-19 — release-cut 一致性门（tag-orphan 硬门）+ retro 持久化 + SSOT 文档同步

Why：落地 retro v6.30.0 §5 AI-1（tag-orphan 机械门）+ 修首份 retro 跑出的 meta 问题（retro 被 gitignore、跨 release 数据无法持久化 = issue #31 根因）+ 把 release-cut 门与 v6.30.0 防膨胀层同步进 SSOT 文档。延续 v6.30.0「反 written≠working」主题——给 tag-orphan（v6.29.0 曾 4 天声明未 tag）装硬护栏，并让 retro 自己能持久化。

Added

  • release-cut 一致性硬门（retro v6.30.0 §5 AI-1）：.claude/scripts/agf-release-cut-precheck.sh——release-cut 时刻跑（打 tag 后），断言 CHANGELOG 顶版 ## [vX.Y.Z] 有对应 git tag，失配 exit 2；fail-open（非 git 仓 / 无 CHANGELOG / 无版本头 → skip）。不放 lint-all pre-commit——避「CHANGELOG 节已 commit、tag 未打」正常 release 窗口 false-positive（AI-1 原文拟「lint-all 加 ~5 行」，实现取独立门）。versioning.md 加 step 4b；4 单测（非 git / 已 tag / orphan / 无 CHANGELOG）。
  • retro 模板量化占位（issue #31 最小可行内核）：docs/reviews/retro-_TEMPLATE.md §1 cycle time 标注；§2 加 AC 通过率 / 返工次数 / UAT 结论 / bug 逃逸 / verdict 分布 / ADR-030 膨胀指标量化占位 + 「模板内 release 相关项标 N/A」说明——首次真实产品 release 时数据形状近零成本自然捕获。

Changed

  • 版本 retro 入库（修 retro skill Step 7 的 written≠working + issue #31 根因）：.gitignore 加例外 !docs/reviews/retro-v*-*.md——版本级 retro 作为跨 release 学习 SSOT 入库（v6.24.x churn 策略曾把整个 docs/reviews/* gitignore，致 retro 无法持久化、§0 action 继承 / §4.1 跨版趋势失效）；audit/verify 报告仍本地 churn。retro-v6.30.0 作为首份版本级 retro 同 PR（#45）入库。
  • SSOT 文档同步：CLAUDE.md 加 release-cut 门路由；docs/known-limitations.md 加 precheck 行（hard-block）；docs/product-workflow.md 加 step 4b 指针 + retro-v* 入库注；docs/team-capability-map.md §1.3 加 release-cut 行 + 补 v6.30.0 漏更的「防 AI 代码膨胀治理层」note（advisory 串 / review 复用审计 / 趋势观测 / release-cut）。

Migration steps

  • fork / clone 用户：拉取本版本即获得 agf-release-cut-precheck.sh——以后切 release 打 tag 后跑一次（versioning step 4b），锁死 tag-orphan。retro-v* 现随模板入库（下游 retro 跨 release 可累积）。零破坏性变更，既有流水线无调整。
  • 已装 AGF 的目标项目：无强制动作；新 precheck 是 release-cut 时手动门，不影响日常 dev。

Verification

  • lint-all.sh 全过：98 文件 / 测试套（含新 test-agf-release-cut-precheck.sh 4 断言）。
  • test-install.sh：通过 29 / 警告 1（known-gap）/ 失败 0（MINOR DoD 门，本 release 实跑）。
  • 本 release 自身 dogfooding（待跑，post-merge step 4b）：打 v6.31.0 tag 后跑 agf-release-cut-precheck.sh，证顶版↔tag 一致（该门首例真用）。

Cost 档位：Medium（maintainer-direct；retro + AI-1 + doc sync + #31 收尾；token 实数见 maintainer /usage，非 DoD 门）

Assets 2
Loading