From d15d3895d785c0c6194103a0b5e5fd4f85abd127 Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sat, 18 Jul 2026 09:43:57 +0900 Subject: [PATCH] =?UTF-8?q?docs(conventions):=20v1.12.0=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=8A=A8=E5=B7=A5=E5=89=8D=E8=BE=A9=E8=AF=81=E6=94=B6=E7=BC=A9?= =?UTF-8?q?=E8=BF=9B=E7=BA=A6=E5=AE=9A=20+=20=E4=BD=BF=E8=80=85=E5=9B=9E?= =?UTF-8?q?=E4=BC=A0=E5=A4=84=E7=BD=AE=E5=8F=B0=E8=B4=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CONVENTIONS 飞轮工作流阶段 2 末新增「动工前辩证收缩」（M/L 卡必做）， 附 07-15 实证：3 张初稿卡直做会错 2/3，辩证后 U3/B4 零返工 - governance-feedback-loop 落 23 条使者回传处置台账：本轮 3 项落地 （/ship 铁律与规模闸修正、MCP 重试说明、envoy 硬门槛）、 11 条核实此前已落地、5 项 log_for_review 待观察、2 个遗留尾巴 --- .blueprint/CONVENTIONS.md | 15 +++++++++++-- .../modules/governance-feedback-loop.md | 21 +++++++++++++++++++ 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/.blueprint/CONVENTIONS.md b/.blueprint/CONVENTIONS.md index 847c41d..674058a 100644 --- a/.blueprint/CONVENTIONS.md +++ b/.blueprint/CONVENTIONS.md @@ -1,6 +1,6 @@ --- -version: 1.11.0 -updated: 2026-07-15 +version: 1.12.0 +updated: 2026-07-18 source: dev-manager-tauri --- @@ -311,6 +311,17 @@ Claude 在每次对话中应遵循以下流程： > 开始写代码前，先判断改动类型：**Bug Fix**（意外偏差，直接执行）还是 **Feature**（新增能力/主动改变行为，必须先输出确认卡等触发词）。完整触发规则见 AGENTS.md「需求对齐协议」章节。 +#### 动工前辩证收缩（M/L 卡必做，S 卡可跳过） + +任务卡拆好后、加锁动工前，对每张 M/L 卡做一轮**多角度辩证**，典型追问： + +- **该不该做**：这张卡解决的问题是真实的吗？做了会不会伤及已有体验（如自动触发打断用户节奏）？→ 可能直接否决 +- **载体对不对**：实现层选对了吗（hook vs 数据层、前端 vs 后端、轮询 vs 事件）？→ 可能翻转载体 +- **设计有没有洞**：边界条件、并发、旧数据兼容有没有漏？→ 补进任务卡 + +辩证结论写回任务卡（否决的标 abandoned 并记原因）。 +实证（2026-07-15 炼境自身）：3 张初稿卡辩证后 1 张否决、1 张载体翻转、1 张补两处设计缺陷——直做会错 2/3；实施后 U3/B4 零返工。 + ### 阶段 3：实现功能 — 两阶段执行锁 任务卡执行遵循**两阶段提交**：开始写第一行代码前加锁（信息1），全部完成后解锁（信息2）。只有信息1没有信息2，说明任务被中断。 diff --git a/.blueprint/modules/governance-feedback-loop.md b/.blueprint/modules/governance-feedback-loop.md index 6f27bb4..e276617 100644 --- a/.blueprint/modules/governance-feedback-loop.md +++ b/.blueprint/modules/governance-feedback-loop.md @@ -48,6 +48,27 @@ **落地物**（最小版，执行成本趋零）：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/ 下 6 处空路径污染残留（.blueprint/.claude/docs/AGENTS.md/CLAUDE.md/lefthook.yml，均 untracked，liangjing.json 指向「agent编排界面(opencode)」）——2026-07-18 会话中删除操作被用户拦下，保留待人工决定 +- envoy.md 硬门槛已进模板，**需重建安装炼境后 apply 才会分发到子项目**（模板打包在二进制资源） + ## 任务卡 （concept 阶段，L 级——待 /architect 设计确认后由 /splitter 拆卡）