lanrtop/dev-manager-tauri
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(conventions): 梦核蒸馏——规则置信度更新 + 梦核写入纪律

Browse Source 
- R01 confidence 0.90→0.95（12 命中 0% 返工，最稳信号）
- R13 confidence 0.80→0.88（11 命中 9% 返工，高频高效）
- R08 confidence 0.87→0.72（3 命中 100% 返工，补 failure_case + boundaries）
- R10 confidence 0.85→0.60（6 命中 83% 返工，补 failure_case + boundaries）
- 追加梦核写入纪律：蒸馏替换而非追加，规则上限 ≤ 25 条
- 数据来源：2026-07-04 梦核分析，40 条复盘笔记 + Rules-Applied trailer
This commit is contained in:
lanrtop 2026-07-04 16:42:02 +09:00
parent 6284124546
commit cf86ab688a
1 changed files with 26 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
.blueprint/CONVENTIONS.md
View File

@ -479,6 +479,16 @@ rule_effectiveness: R10=未验证（任务开始前未触发，事后归因）
- **固化**：哪些跨项目重复出现的阻塞模式、哪些有效实践，值得写进 CONVENTIONS - **固化**：哪些跨项目重复出现的阻塞模式、哪些有效实践，值得写进 CONVENTIONS
- **遗忘**：哪些休眠项目（90天无快照）的 AI 文档可以归档，哪些 CONVENTIONS 规则已过时 - **遗忘**：哪些休眠项目（90天无快照）的 AI 文档可以归档，哪些 CONVENTIONS 规则已过时
### 梦核写入纪律（蒸馏，不是追加）
梦核的产出是**替换操作，不是追加**。每次梦核后遵守：
1. **项目专属规则不进全局** → 写到该项目的 `.blueprint/rules.md`，不写入 CONVENTIONS
2. **全局规则上限 ≤ 25 条** → 超出则先合并/删除再新增；规则总量是飞轮健康度的信号
3. **改原条目，不加新条目** → R10 置信度需降，直接修改 R10 的 confidence 字段，不在旁边另起一条注释
4. **置信度元数据就地维护** → confidence / evidence_count / failure_cases 内嵌在各规则条目中，不另建文件
5. **一次性洞察不固化** → 梦核分析在对话中消费完毕，不另存 .md 文件；原料（复盘笔记）已在飞轮中，随时可重新生成
### 闭环路径 ### 闭环路径
两条并行的反馈路径，速度不同： 两条并行的反馈路径，速度不同：
@ -882,9 +892,9 @@ scope 描述规则的正向适用范围，**boundaries 描述已知的反向边
- **scope**: `tauri` - **scope**: `tauri`
- **触发条件**：在 `src-tauri/src/commands/` 下新增 `#[tauri::command]` 函数 - **触发条件**：在 `src-tauri/src/commands/` 下新增 `#[tauri::command]` 函数
- **自动动作**：读取 `src/lib/commands.ts`，确认是否有对应封装；缺失则提示补写，不阻止执行 - **自动动作**：读取 `src/lib/commands.ts`，确认是否有对应封装；缺失则提示补写，不阻止执行
- **confidence**: 0.90 - **confidence**: 0.95
- **evidence_count**: 8 - **evidence_count**: 12
- **derived_from**: 多次发生前后端接口断层（命令已实现但 commands.ts 未同步，前端调用报错） - **derived_from**: 多次发生前后端接口断层（命令已实现但 commands.ts 未同步，前端调用报错）；梦核 2026-07-04：12 次命中，0 次返工，最稳信号
#### R02 — 任务卡无 acceptance 时先补写再动代码 #### R02 — 任务卡无 acceptance 时先补写再动代码
- **scope**: `universal` - **scope**: `universal`
@ -938,9 +948,12 @@ scope 描述规则的正向适用范围，**boundaries 描述已知的反向边
- **scope**: `universal` - **scope**: `universal`
- **触发条件**：前端组件显示运行状态、健康状态、操作结果等实时信息 - **触发条件**：前端组件显示运行状态、健康状态、操作结果等实时信息
- **自动动作**：检查对应后端是否做了真实检测而非硬编码；发现硬编码状态时标记为需修复 - **自动动作**：检查对应后端是否做了真实检测而非硬编码；发现硬编码状态时标记为需修复
- **confidence**: 0.87 - **confidence**: 0.72
- **evidence_count**: 5 - **evidence_count**: 3
- **derived_from**: 设置页 MCP 状态硬编码为"运行中"，注入失败时 toast 始终显示成功——UI 掩盖真实问题 - **derived_from**: 设置页 MCP 状态硬编码为"运行中"，注入失败时 toast 始终显示成功——UI 掩盖真实问题
- **boundaries**: 展示类状态（loading spinner、空状态提示）属 UI 职责，不适用本规则；本规则仅限"系统真实运行状态"类展示
- **failure_cases**:
- 2026-07-04（梦核归因）：3 次命中全部伴随返工（100%），规则触发但未阻止问题——根因是"状态硬编码"发生在编写时，规则检查发生在展示层，时序错位；建议在写 Tauri command 时即检查返回值是否真实（与 R01 联动）
#### R09 — 自动化边界：事件触发只标 🔵，不标 ✅ #### R09 — 自动化边界：事件触发只标 🔵，不标 ✅
- **scope**: `universal` - **scope**: `universal`
@ -954,9 +967,12 @@ scope 描述规则的正向适用范围，**boundaries 描述已知的反向边
- **scope**: `universal` - **scope**: `universal`
- **触发条件**：实现与外部客户端的协议对接（MCP、LSP、WebSocket、SSE、OAuth 等） - **触发条件**：实现与外部客户端的协议对接（MCP、LSP、WebSocket、SSE、OAuth 等）
- **自动动作**：在开始实现前，先通过文档或工具（curl、抓包）确认客户端实际发出的请求格式；不基于"通用规范"假设行为 - **自动动作**：在开始实现前，先通过文档或工具（curl、抓包）确认客户端实际发出的请求格式；不基于"通用规范"假设行为
- **confidence**: 0.85 - **confidence**: 0.60
- **evidence_count**: 3 - **evidence_count**: 6
- **derived_from**: Claude Code MCP 客户端用 GET 发起 SSE 握手，炼境只接受 POST 导致 405，MCP 整体失效 - **derived_from**: Claude Code MCP 客户端用 GET 发起 SSE 握手，炼境只接受 POST 导致 405，MCP 整体失效
- **boundaries**: 实时协议（WebSocket、SSE）的完整握手序列难以通过 curl 完全预验证，需配合协议库调试工具（MCP Inspector 等）；本规则防的是"基于规范假设而不看实际请求"，不能防"验证了但实现仍有差"
- **failure_cases**:
- 2026-07-04（梦核归因）：6 次命中中 5 次伴随返工（83%），显示规则触发后问题仍发生——根因是协议对接本身复杂度高，"验证客户端行为"这一步经常被跳过或验证不够深入；建议将规则收窄为强制前置步骤：实现前必须有一条 curl/工具调用记录证明验证已执行
#### R11 — 自动执行规则失效时必须记录失败案例 #### R11 — 自动执行规则失效时必须记录失败案例
- **scope**: `universal` - **scope**: `universal`
@ -979,9 +995,9 @@ scope 描述规则的正向适用范围，**boundaries 描述已知的反向边
- **scope**: `universal` - **scope**: `universal`
- **触发条件**：M 或 L 复杂度任务卡准备标记 ✅ done - **触发条件**：M 或 L 复杂度任务卡准备标记 ✅ done
- **自动动作**：acceptance 所述验证路径须由人或 agent **通过功能自身入口**真实走通一次（agent 按钮载体就近选择：Web 服务=HTTP API、CLI=命令、桌面应用=测试调用同一函数、UI 呈现层=Playwright 兜底）。禁止绕过功能手改产物冒充验证；agent 走通的关键路径顺手固化为一条测试（侦察→驻军），一次性验收不固化 - **自动动作**：acceptance 所述验证路径须由人或 agent **通过功能自身入口**真实走通一次（agent 按钮载体就近选择：Web 服务=HTTP API、CLI=命令、桌面应用=测试调用同一函数、UI 呈现层=Playwright 兜底）。禁止绕过功能手改产物冒充验证；agent 走通的关键路径顺手固化为一条测试（侦察→驻军），一次性验收不固化
- **confidence**: 0.80 - **confidence**: 0.88
- **evidence_count**: 2 - **evidence_count**: 11
- **derived_from**: noteapp manifest 被手改导致 schema 约束修复未获真实验证、autoforphone 接线被命令行代办导致 G7 按钮未走通——手动替代掩盖功能真实状态（2026-07-03 用户裁决 + MCP 治理三件套 agent 实测首证） - **derived_from**: noteapp manifest 被手改导致 schema 约束修复未获真实验证、autoforphone 接线被命令行代办导致 G7 按钮未走通——手动替代掩盖功能真实状态（2026-07-03 用户裁决 + MCP 治理三件套 agent 实测首证）；梦核 2026-07-04：11 次命中，9% 返工率，高频高效
### 规则演进路径 ### 规则演进路径