logo
0
0
WeChat Login

docs(governance): 治理层 × rules/.archived/feedback 双向打通#15

Merged
created 2 weeks ago
main
docs/governance-feedback-bridge
Edit
OverviewCommits
1
Files changed
7
Attachments

用户反馈

整体缺少了和 rules 中 feedback 的联合点

前一个 PR(#14)建立了治理层,但没有与已存在的 rules/.archived/feedback/ FB 归档机制做连接。这导致:

  • 复盘 SOP 引用时用文字描述,没有实际链接到归档事实源
  • FB 状态机(OPEN/REJECTED/FIXED)与治理层的(OPEN/RESOLVED/ACCEPTED)术语不一致
  • FB 模板在两处各写一遍,存在漂移风险
  • 质量仪表盘 P2 #18 指标"FB 转化率"无具体测量算法
  • 治理层 4 份文档(delivery/quality/fitness/tooling)与 FB 归档零引用
  • 缺少"何时由谁创建 FB"的硬约束

修复方案

1. 把 FB 归档 README 升级为治理层事实源

rules/.archived/feedback/README.md 从 36 行扩到 123 行,包含 7 节完整规格:

  • §一 状态机(唯一定义):OPEN → RESOLVED / ACCEPTED
  • §二 什么时候必须创建 FB(6 条触发条件 + Agent 约束)
  • §三 FB 归档硬约束(7 段落模板)
  • §四 索引表(10 条历史 FB + LESSONS 反模式双向链接列)
  • §五 转化率算法(配合仪表盘 #18 指标)
  • §六 与其他治理文档的关联图
  • §七 新团队初始化 FB 机制的 4 步

2. retrospective-sop 去重

§4.3/4.4/4.5 不再重复 FB 模板 / 状态机 / 索引描述,统一改为"见 rules/.archived/feedback/README.md §X"。单一事实源原则。

3. 其他 4 份治理文档与 FB 归档建立引用

文档新增引用
delivery-lifecycle.md§流程断点的 FB 追溯:哪些阶段卡壳必须产出 FB
quality-dashboard.mdP2 #18/#19 指向 FB 算法;§4.1 单一事实源清单新增门禁 18-19 = FB 归档
architecture-fitness.md技术债表新增"触发 FB"列;复盘纪律补"FB 对应的债若未清理回 FB 重审"
tooling-landscape.md§4.4 告警 → FB 归档联动:P0/P1 告警必须产 FB
governance/README.md新增"事实源:FB 归档"章节 + 关联图

4. 术语统一

FB 状态机旧用 REJECTED/FIXED,治理层定义为 ACCEPTED。本 PR 后:

  • 统一到 OPEN → RESOLVED / ACCEPTED
  • 仅保留一处"三个术语取代早期文档中的 REJECTED/FIXED"作迁移说明

联合点核对结果

治理层 6 文档 (含 governance/README)        FB 归档 README
     │                                           │
     │  32 处引用 →                              │
     │                                           │
     │          ← 12 处反向引用                  │
     │                                           │
     │          ↕ 7 处 LESSONS 反模式双向链接 ↕

三层事实源结构

rules/.archived/feedback/README.md
     │ §一 状态机唯一定义
     │ §三 模板唯一规格
     │ §四 索引(唯一事实表)
     │ §五 转化率唯一算法
     ↑
     │ 被引用
     │
┌─── governance 5 份治理文档 ────┐
│  retrospective-sop → 产出机制 │
│  delivery-lifecycle → 流程断点│
│  quality-dashboard → #18 指标 │
│  architecture-fitness → 技术债 │
│  tooling-landscape → 告警联动 │
└───────────────────────────────┘
     │
     │ 双向映射
     ↓
LESSONS.md §二 反模式对照表

改动统计

 7 files changed, 194 insertions(+), 78 deletions(-)

核心 gain:

  • 消除 3 处重复定义(FB 模板、状态机、索引描述)
  • 新增 6 处引用路径(从治理层指向事实源)
  • 新增 1 处关键链路(FB ↔ LESSONS 反模式双向)
  • 填 1 处算法空白(FB 转化率具体计算公式)

自举验证

  • read_lints 0 错误
  • ✅ 本地 Docker JDK 17 真实编译:15/15 单元测试 PASS + BUILD SUCCESS
  • ✅ 联合点核对:治理层 32 处引用 FB、反向 12 处、LESSONS 双链 7 处、旧术语已统一

抽象化判据

本 PR 的所有新增引用都用相对路径(rules/.archived/feedback/README.mdgovernance/xxx.md),不绑定具体项目。迁移到新项目时目录结构不变即可直接生效。

is using the squash method to merge intof356c8af
docs(governance): 治理层 × rules/.archived/feedback 双向打通 (#15)
added 2 commits
Merge PR #16: 重置为脚手架——清空项目数据保留 .codebuddy 三层框架
docs(governance): quality-dashboard 初始化阈值 + 新增 §七 可执行测量命令
feat(ci): 接入 CNB 流水线 + 7 个 POSIX shell 自举检查脚本
added 2 commits
docs(checkpoint): 回填 PR #29 CNB 首绿实测 + 事实更正 + 隐藏 bug 记录
docs(meta): T-08 闭环——交叉引用同步 + 轮次 12 档案

Successfully merged and closed

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