diff --git a/docs/research/distill-merge-log.md b/docs/research/distill-merge-log.md new file mode 100644 index 0000000..88a90ac --- /dev/null +++ b/docs/research/distill-merge-log.md @@ -0,0 +1,117 @@ +# 蒸馏合并日志 + +> 生成时间:2026-05-26 +> 输入:批次1(14 张卡片)+ 批次2(15 张卡片)= 29 张原始卡片 +> 输出:27 条经验 → 5 个 Skill 文件 + +## 合并决策记录 + +### 1. 批次1卡片2 + 批次2卡片13 → "不绕圈子/不绕弯子"(合并) + +**批次1卡片2**:反复讨论已确认的问题(绕圈子),severity: high, freq: 17 +- 核心示例:[frag_0600] 用户说"别绕了,我都说过了" +- 侧重:用户已明确方向后仍在讨论前提 + +**批次2卡片13**:回答用户问题要直接,不要绕弯子,severity: medium, freq: 3 +- 核心示例:庞统在 compact 讨论中反复讨论概率而非处理方案 +- 侧重:回避核心问题,用相关信息绕弯 + +**合并理由**:同一问题的两个角度——都是"不直接回答问题"。批次1侧重"不接受前提",批次2侧重"回避核心"。 +**合并方式**:以批次1为主(频率更高,severity 更高),补充批次2的"直接回答方法论"。 +**归属**:agent-execution-discipline.md 第2条 + +--- + +### 2. 批次1卡片14(GATE 门控,freq=33)→ 拆分为独立条目 + +**决策**:GATE 是最高频纠正(33 次),不能简单并入其他条目。 +**拆分方式**: +- 独立为"第4条:GATE 流程门控"——完整的门控规则 +- 其"先确认再动手"的精神与卡片1合并,形成"第1条:先确认再动手" + +--- + +### 3. 批次1卡片8 + 卡片7 → "先确认当前设计再改"(合并) + +**卡片8**:先确认当前设计再改(freq=6),侧重"看到不符直觉的实现时先问再改" +**卡片7**:尊重已确定的设计决策(freq=1),侧重"实现前先查设计文档" + +**合并理由**:都是"先理解再动手"的变体。 +**合并方式**:合为一条"先确认当前设计再改",覆盖确认设计意图和尊重已有决策两个子场景。 + +--- + +### 4. 批次1卡片4 + 卡片6 + 卡片7 → "尊重设计决策和全局约束"(合并) + +**卡片4**:废弃系统的引用(freq=1) +**卡片6**:不给现有系统增加复杂度(freq=1) +**卡片7**:尊重已确定的设计决策(freq=1) + +**合并理由**:三条都是 medium severity,频率都是 1,主题都是"全局设计约束"。 +**合并方式**:合为一条"尊重已确定的设计决策和全局约束",三个子场景作为"⚠️ 常见错误"列项。 + +> 注:卡片7 同时参与了决策3(与卡片8合并),因为卡片7 的"尊重设计决策"既是"先确认"的一部分,也是"全局约束"的一部分。在 agent-execution-discipline.md 中,第5条侧重"先理解再动手",第7条侧重"全局约束"。 + +--- + +### 5. 批次1卡片5 + 卡片12 + 批次2卡片5 → code-review-quality(合并) + +**批次1卡片5**:要求深度评审而非最小改动(freq=1) +**批次1卡片12**:评审意见不要延后应该做的改动(freq=1) +**批次2卡片5**:方案确认的完整闭环标准(freq=2) + +**合并理由**:三条都是评审纪律,主题紧密相关。 +**合并方式**:拆为 code-review-quality.md 的两条: +- "第5条:要求深度评审而非最小改动"(合并卡片5+12) +- "第6条:方案确认的完整闭环标准"(卡片5) + +--- + +### 6. 批次1卡片13(relevant-memories 噪音,freq=27)→ 排除 + +**排除理由**: +- 这是系统层面问题(memory 注入机制噪音过大),不是 Agent 行为纠正 +- 标记为"系统已知问题",不进入 Skill +- 已在 README.md 排除项中记录 + +--- + +### 7. 批次2卡片4 与 code-review-quality "三层对照"的交叉 + +**批次2卡片4**:设计文档-代码一致性审查(severity: high, freq:4) +- 这条同时出现在 system-design-lessons.md 和 code-review-quality.md 中 +- system-design-lessons 侧重"设计层面的教训" +- code-review-quality 侧重"评审时的检查项" + +**决策**:两边都保留,但侧重点不同。system-design-lessons 中是完整卡片,code-review-quality 中简化为检查清单项。 + +--- + +## 未合并的卡片(直接进入 Skill) + +| 卡片 | 归属 Skill | 说明 | +|------|-----------|------| +| 批次1卡片1 | agent-execution-discipline #1 | 未经确认不改代码 | +| 批次1卡片3 | agent-execution-discipline #3 | 保持独立思考 | +| 批次1卡片10 | agent-execution-discipline #6 | 自检行为异常 | +| 批次1卡片9 | frontend-design-ai-native #1 | 按钮矩阵对齐 | +| 批次2卡片1 | code-review-quality #1 | 评审闭环含最终代码 | +| 批次2卡片2 | code-review-quality #2 | 枚举一致性 | +| 批次2卡片3 | code-review-quality #3 | 评审者自我纠正 | +| 批次2卡片6 | system-design-lessons #1 | Counter 生命周期 | +| 批次2卡片7 | system-design-lessons #2 | 进程管理 | +| 批次2卡片8 | system-design-lessons #3 | 续杯机制 | +| 批次2卡片9 | system-design-lessons #4 | 广播路径一致性 | +| 批次2卡片10 | agent-collaboration-patterns #4 | E2E 测试分工 | +| 批次2卡片11 | agent-collaboration-patterns #1 | 角色匹配 | +| 批次2卡片12 | agent-collaboration-patterns #2 | inform 处理 | +| 批次2卡片14 | system-design-lessons #5 | JSON 解析验证 | +| 批次2卡片15 | agent-collaboration-patterns #5 | 调研落地映射 | + +## 统计 + +- 原始卡片:29 张(批次1: 14 + 批次2: 15) +- 排除:1 张(系统问题) +- 合并后:27 条经验 +- Skill 文件:5 个 +- 高 severity:13 条(放在每个文件前面)