Claude Code 知识库建设：为什么要沉淀工作经验

两小时又没了

三个月前你做过一份招商方案，今天客户又要一份类似的。你打开旧文件夹，只找到最终版：当时用的提示词没了，数据口径没记，为什么否掉另一个结构也想不起来。于是重新解释背景、重新试格式，两小时又过去了。

这不是记性问题，是流程问题。成果留下了，方法丢了。同一个问题问过 AI 五遍、每遍都要从头交代；新同事接手你的活，只能翻聊天记录猜——都是同一件事。

它是什么，为什么对 AI 更要紧

不是知识管理系统，也不是数据库。就是一个文件夹，几份纯文本，放在你日常干活的项目目录里，让 AI 能直接读到。判断标准很硬：下次做同类任务，你和 AI 愿不愿意先打开它。信息怎么分层，可参考上下文工程。

和人协作，一句「按上次那个风格」对方就能会意；AI 不会。它在新会话里通常从空白开始，你给什么它看什么。不给材料，它只能拿通用经验顶上：模板套话、四平八稳的结构、看不出口径的数字。给了材料，它知道客户是谁、报价怎么算、哪些话不能对外说，写出来的东西能直接进流程。差别不在模型多聪明，在开场时递过去多少上下文。

算一笔账

同样是写提案，区别不在单次，在重复次数：

轮次	不留记录	留记录
第一次	两小时摸索格式	两小时，顺手记下模板与注意事项
第二次	再花一小时半，仍从零想	读模板半小时，加上改写一小时
第三次	依然没有进步	更快，还多出一条避坑记录

只做一次的任务，写文档当然不划算；只要会重复三回，第一份文档的时间通常就摊平了。真正拉开差距的是第十次、第二十次。

该往里放什么

四类内容，按上手顺序：背景（业务怎么运转、内部术语、客户是谁、数字的口径）、流程（分几步、每步用什么提示词、怎么验收）、范例（被采纳的稿子、通过的方案）、教训（试过没用的方法、踩过的坑）。一个最小目录：

knowledge/
  business.md    # 业务、术语、口径
  proposal.md    # 方案写法与提示词
  samples/       # 两篇通过稿
  lessons.md     # 踩坑记录

一层目录就够，别建三四层；找不到文件通常不是分类不够细，而是太细。另有一条边界不能越：记方法，不记机密。客户名单、未公开报价、合同条款、个人隐私不进这个文件夹；「方案怎么搭结构」这类写法可以写。知识库会被复制、分享、读进上下文，写进去等于半公开。

一份能用的条目长什么样

目录只是骨架，起作用的是文件里的内容。以「写招商方案」为例，proposal.md 至少写清五块：

用途：客户要招商方案时，先读这份文件，再动笔。
背景：客户多为区域连锁，决策人关心回本周期与区域保护
步骤：1. 问清门店数、供货渠道、预算区间
      2. 按「背景—机会—方案—投入—回本」列五段大纲
      3. 大纲确认后再写正文，每段不超过 200 字
提示词：按本文件结构写，读者是客户老板，先给结论，少用形容词。
验收：回本周期给出计算过程；不承诺独家代理，除非客户书面确认
教训：上次跳过大纲直接写正文，客户看不到决策依据，返工一次

五块各管一件事：背景决定语气，步骤决定顺序，提示词决定写法，验收决定能不能交，教训防止重蹈覆辙。再补一个动作让它真被用上：在项目根目录的 CLAUDE.md 里写一句「写方案前先读 knowledge/proposal.md」，入口只放索引，不抄内容。写完追问一句「你参考了哪份文件」，说不出文件名的，多半没读。

从今天的任务开始

不要先建目录再想内容，那多半停在建目录。挑最近一次做得还行的任务，花二十分钟回答四个问题——任务是什么、步骤是什么、哪句提示词最有用、卡在哪一步。答案就是第一份文件。本周先记三到五条顺手的提示词，本月补两三个高频流程，之后每完成一个项目留十五分钟更新。

沉淀不是额外工作，是把本来要重复支付的成本提前付一次。下一课讲具体写法：怎样让第一份文档结构清楚、AI 一读就懂——创建可复用结构化文档。