对标方法与迁移判定
对标方法与迁移判定
阶段 2 的操作手册。回答两个问题：同类成熟项目做到了什么（横向），本领域的能力全集是什么（纵向）。
横向：同类项目对比
选 2–4 个参照项目，标准：同领域、有真实用户、工程化成熟、公开可研究。
对比维度：
- 功能矩阵：有什么、没有什么
- 架构取舍：单体/分层、同步/异步、存储选型及理由
- 测试与评测策略：测什么、怎么测、基线是什么
- 文档与发布质量：上手路径、CHANGELOG 纪律、版本语义
- 安全姿态：认证、授权、密钥处理、供应链
- 生态契合：标准协议、可嵌入性、二次开发接口
产出一张对比表，并明确三句话：我们缺什么、我们好在哪、哪些差异是定位差异而非落后。
纵向：领域能力清单
先从参照项目与领域文献归纳本领域的能力全集，再逐项判定本仓状态：
| 状态 | 含义 |
|---|---|
| 存在且正确 | 有实现，行为经真实测试验证 |
| 存在但浅 | 有入口，深度/正确性/可观测性不足 |
| 缺失 | 能力清单中有，本仓无 |
| 不适用 | 与本仓定位冲突，显式不做 |
每项能力评估六个方面：正确性、深度、可扩展性、可观测性、失效模式、可测试性。
能力全集按领域归纳，不预设在 skill 里。示例——RAG 领域的能力清单格式（仅为格式示范）：
摄取 / 解析 / 分块 / 嵌入 / 索引 / 检索 / 重排 / 生成 / 引用 /
评测 / 反馈 / 权限 / 缓存 / 增量同步 / 可观测性 / 成本追踪
迁移判定
每个差距四选一，附一句话理由：
| 判定 | 含义 |
|---|---|
| adopt | 直接借鉴，强化核心方向 |
| adapt | 改造后吸收，贴合本仓架构与约定 |
| defer | 有价值但非本轮，记入 roadmap |
| reject | 只增加表面面积，不提升正确性、清晰度或可维护性 |
判定准则：
- 取其精华，去其糟粕；青出于蓝的前提是知道蓝在哪里、为什么蓝
- cargo cult（因为别人有所以要有）一律 reject
- 每个 adopt/adapt 必须能回答：它让仓库更接近「简约而专业，优雅而高效，别致而深刻」中的哪一个
- 奥卡姆剃刀：同等收益下选更简单的方案；能复用现有抽象就不新增组件
- 用户带理由 reject 的候选，连同理由记入决策记录（ADR 或等效文档）——防止同一建议在下一次审计中被反复提出、反复消耗