dev-manager-tauri/.blueprint/modules/governance-feedback-loop.md
lanrtop cbc1d46c4e
All checks were successful
Push & PR Check / check (push) Successful in 52s
fix(mcp-inject): inject 链路空路径单点防护——补齐 07-15 空路径事故第二入口
辩证收缩实战产出:清理污染文件时追问「删文件是不是正确动作层」,
发现 473cf7e 只拦了 apply 链路,inject 链路 project_root() 对空串
win_path 穿透(ok_or_else 拦 NULL 不拦空串),settings.json/
liangjing.json 正是经此写进 src-tauri/。

- validate_registered_path 单点校验:拒空串/空白/相对路径(顺带堵
  相对路径解析到 cwd 的边角),WSL 分支拒空 wsl_path
- 2 条回归测试驻军(纯函数无 DB,cargo test 105 全绿)
- 台账同步:污染文件已移出、两条空路径僵尸登记已注销

Rules-Applied: R06,R07
2026-07-18 10:24:03 +09:00

7.3 KiB
Raw Permalink Blame History

治理反馈闭环

老板-员工手册隐喻:用户发现子项目不足 → 告诉炼境(结构化落账)→ 炼境更新"企业文化与员工手册"CONVENTIONS 规则 + 接入包模板)→ 批量分发给子项目 → 飞轮观测新规则是否生效。

为什么

  • 现在用户发现子项目问题只能在会话里口头说(如 2026-07-06 的 group_id 探路问题),不落任何结构化通道,问题→体系改进全靠当次会话的执行力,跨会话就丢
  • 治理管线已存在大半blueprint-governance 的规则编辑与批量同步、blueprint-feedback 的梦核蒸馏、onboarding-pack 的模板版本化分发),但三处断环让"反馈驱动体系进化"没有闭合

三个缺口(待 /architect 细化)

① 治理反馈入口

  • 现状:append_project_note 挂单项目、无类型标记,是"员工工作日志"而非"给老板的管理反馈"
  • 方向:report_governance_feedback 类入口MCP 工具优先UI 上报按钮可后置),记录:哪个项目、什么问题、疑似哪条规则/模板缺陷;落 project_notes 加类型字段或独立治理账本表
  • 形态待定MCP 工具 vs UI 按钮 vs 笔记类型约定三选或组合architect 阶段定)

② 反馈进入梦核蒸馏

  • 现状梦核吃被动数据commit 指标、复盘笔记、停滞模块、高风险 scope
  • 方向:用户主动治理反馈作为梦核 prompt 的高权重数据段(老板亲口说的问题 > 统计推断的问题),蒸馏产出规则修订/模板修订建议

③ 接入包批量重分发

  • 现状:sync_blueprint_rules 有批量,但接入包 apply_onboarding_pack 单项目一次一发;模板更新后无"全员换发新手册"动作
  • 方向:批量 re-apply复用 ONBOARDING_MANAGED 块安全覆写机制),输出报告:哪些项目更新了哪些块、哪些跳过/失败

闭环全景

发现问题 → ① 结构化落账 → ② 梦核蒸馏 → 更新 CONVENTIONS/模板
    ↑                                        ↓
飞轮观测生效Rules-Applied trailer / 复盘) ← ③ 批量分发

每一环都有数据留痕,管理动作可回溯。

设计档案agent 自验协议的辩证与务实版选择2026-07-06

用户确立的协作协议:需求对话 → 构建默认 agent 按钮化 → agent 自验 → 快速自修 → 结构化反馈 → 人终验。经多角度辩证后识别出五个内生张力与对应调节器,最终按"大量开发者经验(流程死于执行成本而非设计错误;检查单短才有效;机制记的留下、靠记忆的蒸发)"选择最小执行版落地,完整辩证存档于此备查:

内生张力 调节器 关键点
运动员兼裁判(验证与功能共享理解偏差) 负面披露(「没验什么」一节) 只覆盖已知盲区未知盲区由人终验兜底——两柱互补缺一超载。实证mcp-single-server 自验全绿但 git-bash 层全挂,靠端到端终验抓住
Goodhart宽松断言让自己过 改断言需报备 非自觉依赖:断言修改在 diff 天然可审计
橡皮图章化(终验退化为签字) 意外感触发深查 深查频率是自由参数,框架内无机制阻止衰减——最终锚是人的纪律,框架诚实承认此点方自洽
默认按钮化 vs 少而稳 默认分层 默认的是"存在可验证路径",不是"永久驻军测试";豁免需声明
不可按钮化工作(审美/体感/探索) 显式豁免 强推得到仪式性假按钮

关键澄清(两把尺子)acceptance 由 agent 参与撰写可能继承需求理解偏差——agent 自验对 acceptance人终验必须对意图,否则是拿被污染的尺子量两次。

落地物最小版执行成本趋零AGENTS.md / 接入包模板 / agents-meta-rules 增设「自验报告纪律」三条;用户侧两个习惯(先看「没验什么」;意外感或外部契约变更时深查)。刻意不做:新工具、强制 hook、报告模板系统——坑驱动增量人肉版跑出疼点后再在本模块机制化。

使者回传处置台账2026-07-18 消化,共 23 条)

已落地(本轮 3 项)

  • /ship 三处模板修正~/.claude/commands/ship.md,全局命令即分发源):① blueprint 尾 commit 铁律改为「每轮 /ship 的最后一个 PR 末位 commit」多 PR 场景 manifest 单文件不可能每 PR 都带);② 规模闸补两个不可拆例外(单一功能域强耦合 / 全新业务线初版)→ 警告放行不阻塞;③ MCP 连接错误注明可原地重试 2~3 次(偶发抖动非业务失败)
  • envoy.md 分类硬门槛接入包全托管文件Step 3 前置追问「任何有经验的工程师是否会提前想到?」——常识性知识与过窄 corner case 一律留本项目,堵住 2 例误回传的根因
  • CONVENTIONS v1.12.0:飞轮工作流阶段 2 末新增「动工前辩证收缩」M/L 卡必做),实证返工率对照写入

此前会话已落地11 条,本轮核实关闭)

MANAGED 块警示5b0b068、Bug Fix/Feature 分类 + S 级轻量卡 + 汇总补录限定语67bdacb AGENTS v1.5.0、蓝图机器门控f04eb6e blueprint-gate 双层,回应 07-09「文档约束无机器门控」假设、lefthook API typecheck 必填项 + CONVENTIONS scope 前置提示be2f695 v1.11.0、Playwright 版本锁死AGENTS tmpl、agent_verify/human_verify 分层AGENTS + CONVENTIONS、/ship 阶段八 rebase 前 stash 保护(已在 ship.md、空路径分发防护473cf7e

待观察log_for_review暂不动模板

  • verify_onboarding lefthook 键名匹配是名义非语义等价功能不同键名会误报缺失enterprise-system 6/7 fail 待核实是缺失还是改名
  • /ship 运行期间并行开发混入变更under_validation建议最终报告对比第零步 status 快照、新增变更单独列出不纳入本轮——再积累 1~2 次实例后进模板
  • /antirot 命令模板化enterprise-system 实现的文档防腐命令(机器验+文档一致性+蓝图健康三步),候选纳入接入包标配
  • Loop 模型路由Haiku=Observer / Sonnet=Actor种子层/土壤层分工enterprise-system 特有 Loop 体系,尚不构成跨项目通用约定,观察其长期效果
  • OpenAI SDK tool_calls 联合类型守卫:可作 AI 代码审查检查项候选project_type:web

遗留尾巴

  • src-tauri/ 下空路径污染残留 → 2026-07-18 辩证收缩后三步收官①9 个污染文件已移出(暂存 %TEMP%\liangjing-pollution-20260718②两条空路径僵尸登记agent编排界面(opencode)/银龙集团应用)已 unregister磁盘无对应目录实为死登记③辩证挖出 inject 链路漏拦同一空路径洞project_root() 对空串 win_path 穿透写 cwd正是 settings.json/liangjing.json 污染的来源)——已单点补 validate_registered_path(拒空+拒相对路径)+ 2 条回归测试。空路径事故至此两链路apply/inject全堵
  • envoy.md 硬门槛已进模板,需重建安装炼境后 apply 才会分发到子项目(模板打包在二进制资源)

任务卡

concept 阶段L 级——待 /architect 设计确认后由 /splitter 拆卡)