路线阶段：AI Vibe Coding 第 8 章。
本章目标：从“每次都重新讲规则”升级到“规则资产化、可检索、可演进”。
学习目标
完成本章后，你应该能做到：
- 设计适合 AI 消费的知识库结构。
- 建立规范中心并做版本治理。
- 用检索策略保证 AI 每次拿到“最新且相关”的规则。
- 把知识库更新纳入开发流程和审查流程。
为什么需要规范中心
没有统一知识库时：
- 不同成员给 AI 的规则不一致。
- 同一问题在不同会话输出风格漂移。
- 新成员难快速继承团队标准。
把规则写进脑子不可靠，写进系统才可复用。
知识库分层
建议四层目录：
kb/
01-architecture/
02-coding-standards/
03-runbooks/
04-playbooks/
05-anti-patterns/1) Architecture
系统边界、模块职责、依赖方向。
2) Coding Standards
命名、错误处理、日志、测试规范。
3) Runbooks
发布、回滚、事故处理、值班操作。
4) Playbooks
常见任务模板（加功能、修Bug、重构、提效）。
5) Anti-patterns
明确列出“不能这样做”的反例与原因。
文档格式规范
每份规范文档建议包含：
Intent：这条规则解决什么问题。Do：允许做法。Dont：禁止做法。Checks：可执行检查项。Examples：正反例。
示例：
# Reward Grant Idempotency
Intent: 防止重复发奖
Do: 所有发奖接口必须带 requestId
Dont: 仅依赖客户端去重
Checks: PR 中出现 grantReward 时必须调用 checkIdempotency检索注入策略
让 AI 优先检索：
- 当前任务相关 playbook
- 目标模块 architecture 文档
- 对应 coding standard
- 相关 anti-pattern
并设置“过期文档降权”。
版本治理
知识库也要版本化：
- 每次更新记录
version + changelog。 - 破坏性规则变更要标注生效日期。
- PR 必须说明“本次是否依赖新规则”。
知识库质量门
每次规则更新执行：
- 链接完整性检查
- 冲突规则检测
- 示例可执行性检查
- 过期规则扫描
AI 输出对齐机制
要求 AI 在交付前自检：
请列出本次引用的规则文档及版本号。
若输出与规则冲突，优先规则并解释原因。这样可追溯“AI 为什么这么做”。
与开发流程联动
- 新功能 PR：必须引用至少一条 playbook。
- 高风险改动：必须引用 runbook 和 anti-pattern 对照。
- 事故复盘：新增或更新对应规则文档。
常见坑
坑 1：知识库变成文档堆
没有检索策略和结构层级，AI 依然找不到重点。
坑 2：规则更新不回收旧规则
新旧冲突会导致输出摇摆。
坑 3：只有“应该做”，没有“如何检查”
缺少 checks，规则无法落地。
本月作业
搭建“最小规范中心”一期：
- 完成 architecture/coding/playbook 三类文档各 3 篇。
- 设定规则版本号与更新日志。
- 在 5 个真实任务中验证引用命中率。
下一章：AI Vibe Coding 09《数据飞轮：从任务日志中训练团队专属协作策略》。