从"帮我写个函数"到"它是我的认知伙伴"——这条路我走了一遍,把所有踩过的坑、总结的方法、验证过的模式,整理成了一份体系化的导航。16 个主题,按需取用。
我密集使用 AI 编程助手几个月后,发现一个问题:碎片化的经验到处都是,但没有人把它们串成一个体系。
"记得加 timeout"——孤立的一条建议。"给它写价值观"——另一个孤立的想法。它们之间是什么关系?先做哪个后做哪个?哪条是地基,哪条是锦上添花?
这份地图把 16 个主题按依赖关系组织成四层,让你知道自己现在在哪、下一步该往哪走。
# 这个阶段解决的是"怎么让 AI 不再是每次从零开始"。
# 时间投入:2-3 天建立,之后每周维护 5 分钟。
[第一层:认知基础]
├── #5 记忆系统三坑 → 先解决"AI 记不住你"
├── #13 上下文窗口管理 → 再解决"记得太多反而不准"
├── #7 事故驱动规则演进 → 从踩过的坑里长出自己的规则这三篇是地基。 没建记忆系统,每次新对话你都要重新对齐背景。没管上下文窗口,你会把 800 行无关信息塞给 AI 然后抱怨它"记不住重点"。没从事故提取规则,你的规则文件会是空泛的愿望清单。
阅读顺序:先看 #5 搭记忆 → 再看 #13 管注意力 → 最后看 #7 建规则。
# 这个阶段解决的是"AI 在遇到边界情况时怎么判断"。
# 时间投入:2 小时写文件,之后每月调一次。
[第二层:协作哲学]
├── #2 SOUL.md 写作指南 → 从"指令清单"升级到"价值排序"
├── #4 当 AI 开始说不 → 让 AI 有判断力,不只是执行
├── #6 三层跃迁模型 → 定位你当前在哪层,下一步怎么走这三篇决定了 AI 的"性格"。 L1 的 AI 是工具——你说什么它做什么。L2 是有记忆的助手。L3 是能说"这个方案有风险"的伙伴。从 L1 到 L3 的跃迁,不是靠更复杂的提示词,是靠这三篇里的方法。
阅读顺序:先看 #6 定位自己 → 再看 #2 动手写 SOUL.md → 最后看 #4 开启"说不"的开关。
# 这个阶段解决的是"AI 给的代码为什么在测试环境能跑、线上就崩"。
# 时间投入:读完后立刻能用,每条都可以当天落地。
[第三层:代码质量]
├── #8 从 Demo 到生产五道坎 → 错误处理/并发/资源/日志/外部依赖
├── #3 5 个慢性死亡坑 → 没 timeout、锁外读锁内写、周期任务寄生...
├── #11 AI 写测试三个盲区 → 脏数据、违规场景、mock 不真实
├── #10 重构还是重写 → 什么时候改 AI 的代码,什么时候扔这四篇是工程质量——让 AI 的代码从"能跑"到"敢上线"。 #8 讲生产必备,#3 讲隐蔽 bug,#11 讲测试盲区,#10 讲代码取舍。四篇之间互补——#8 的"生产检查清单"可以直接贴在显示器旁边,#3 的故事让你下次看到类似模式时秒懂根因。
阅读顺序:先看 #3 建立风险意识 → 再看 #8 建生产检查清单 → 然后 #11 补测试盲区 → 最后 #10 做代码取舍。
# 这个阶段解决的是"怎么让协作效率翻倍"。
# 时间投入:每篇对应一个习惯改变,一周内可以全部落地。
[第四层:协作效率]
├── #9 批处理思维 → 从单件流到并行任务
├── #12 渐进式交付 → 把大象切成 AI 能消化的一口
├── #14 命名一致性三个锚点 → 别让 AI 每次用不同的变量名
├── #15 Git checkpoint 策略 → AI 改代码前的安全网
├── #16 风格冲突三种解法 → 别让"看着不舒服"耗掉你的精力
├── #1 8 条协作经验 → 全景汇总,读完这一篇可以跳过上面所有(但别)这六篇是"体验层"。 前三层解决"能不能用",这层解决"用得爽不爽"。批处理把效率翻倍,渐进式交付让你不再面对 1500 行代码无从下手,命名一致性让你不用每次都在脑子里翻译变量名,Git checkpoint 给你后悔药,风格冲突让你不再血压升高。
阅读顺序:先看 #1 全景 → 然后按你的痛点挑(命名混乱 → #14,不敢让 AI 改太多 → #15,觉得慢 → #9)。
┌──────────────────────────────────┐
│ #1 8 条协作经验 │ ← 全景入口
└──────────────────────────────────┘
第一层:地基 第二层:价值观
├── #5 记忆系统三坑 ├── #2 SOUL.md 指南
├── #13 上下文窗口管理 ├── #4 当 AI 说不
└── #7 事故驱动规则演进 └── #6 三层跃迁模型
│ │
└────────────┬───────────────────────┘
▼
第三层:工程质量 第四层:协作效率
├── #8 Demo 到生产 ├── #9 批处理思维
├── #3 5 个慢性死亡坑 ├── #12 渐进式交付
├── #11 AI 写测试盲区 ├── #14 命名一致性
└── #10 重构 vs 重写 ├── #15 Git checkpoint
├── #16 风格冲突
└── ▲
└── 日常中直接改善体验你的症状 | 看这篇 |
|---|---|
每次新对话都要重新解释项目背景 | #5 记忆系统三坑 |
AI 记了很多但回答质量反而下降 | #13 上下文窗口管理 |
系统提示词越来越长但效果没提升 | #2 SOUL.md 指南 |
AI 从不说"这方案有问题" | #4 当 AI 说不 |
AI 写的代码上线就崩 | #8 Demo 到生产 |
排查一个 bug 花了整个下午 | #3 5 个慢性死亡坑 |
AI 的测试全绿但线上还是炸 | #11 AI 写测试盲区 |
修 AI 代码越修越乱 | #10 重构 vs 重写 |
觉得协作很慢 | #9 批处理思维 |
AI 一次给你 1500 行代码无从下手 | #12 渐进式交付 |
AI 每次都换不同的命名风格 | #14 命名一致性 |
让 AI 改代码时心惊胆战 | #15 Git checkpoint |
AI 写的代码你看不懂 | #16 风格冲突 |
不知道自己在哪个水平 | #6 三层跃迁模型 |
规则文件写了一堆但好像没用 | #7 事故驱动规则 |
这 16 个主题不是一次想出来的。是最初效率不够用、代码不稳定、协作不顺畅时,一个一个补上去的。你现在看到的"体系",是事后整理的——当时每一步都只是在解决眼前的痛。
所以不需要一开始就看完 16 篇。找到你最痛的那个问题,看那一篇,动手改一个地方。 改完你会发现下一个痛点自然浮现,再看下一篇。
AI 协作的成长不是一次性升级,是一个一个点地磨出来的。
本文所有内容均已脱敏处理。你的最痛点在哪?欢迎评论区对号入座。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。