知识库总览

这里保存从 Issue、PR、分支实验和项目复盘中提炼出的可复用结论。原始过程文档仍留在“当前状态”，知识库只保留跨任务可复用的判断、契约和方法。

从哪里开始

阅读目标	推荐路径
新成员了解项目	项目治理概览 → SQL 优化概览 → Agent 边界设计
开发或调试 Agent	结构化结果与证据 → Skill 契约 → 离线评测
验证 SQL 优化效果	状态机 → 规则验证 → 稳定基线
组织团队交付	分支与里程碑 → 小团队交付模板

Agent 工程

设计可靠的 Agent：明确执行边界、控制上下文，并让经验可以复用。

专题	你可以找到什么
Agent 边界设计	结果与证据、上下文预算、离线评测、失败分流与人工接管
指令遵循	Skill 契约、运行时适配与可验证执行
Memory 系统	经验抽取、存储、召回与注入

SQL 优化

从执行过程到验证数据，建立可复核的优化结论。查看领域概览。

专题	阅读入口
执行机制	时间基准与计时口径 · 优化效果指标与统计口径 · 状态机 · 审查轮与优化轮
规则与数据	结果一致性验证与语义等价边界 · DDL 约束与索引 · 规则验证与数据合成 · 测试数据治理与稳定基线
分布式 SQL	分布式适配

项目治理

管理分支、验收与协作节奏，把探索转化为可交付成果。查看领域概览。

专题	阅读入口
分支与里程碑	分支与里程碑治理
团队交付	小团队 SQL 改写模板

成熟度

状态	含义	使用方式
confirmed	已有合并、测试或明确决策作为证据	可作为默认实践，仍需遵守条目中的适用范围
provisional	已实现或本地验证，但 PR、服务器实测或样本覆盖尚未闭环	可用于设计和试验，落生产前复核限制
proposal	只有方案，尚未实施	留在待确认知识，不作为正式实践

入库原则

1. 保留来源：每篇都能回到 Issue、PR、提交或原始文档。
2. 区分事实与方案：实现完成、PR 合入、服务器验收分别记录，不互相替代。
3. 提炼而非搬运：过程文档可以很长，知识条目只保留可迁移的结论和限制。
4. 单一主入口：一个结论只在一个主题完整展开，其他主题通过链接引用。
5. 允许修订：新证据推翻旧结论时，更新成熟度和适用范围，并保留变更依据。