如何用 AI 编程做文档协作

在日常的工作与项目中，很多时候我们把精力浪费在文档排版和结构拼凑里。利用 AI 编程工具进行“文档协作”，就是让 AI 帮你处理文档相关的一切事情：创作、编辑、整理、调整。

一、 需求场景 (Why)

撰写和维护文档是开发与业务推演的重要一环，但这存在明显的痛点： *   从零创作难：面对空白文档无从下笔。 *   局部修改累：牵一发而动全身，调整章节会打乱前后逻辑。 *   随手记录乱：大量的随时灵感或者技术草稿缺乏层次结构。

我们需要一种能够在不破坏全局结构的前提下，对局部内容进行精准增删改的协作手段。

二、 解题思路 (Thinking)

文档协作的核心基础是 Markdown 格式。Markdown 这种带标记的文本文档，就像是人类和 AI 都能迅速看懂的“中间协议”。 *   # 是一级标题，## 是二级标题； *   1. 是有序列表，- 是无序列表。

核心逻辑定性：AI 能准确理解这些标记的嵌套关系和含义，当你告诉 AI 写什么，它输出的就是原生含有清晰节点的 Markdown 文档。只要定位准确，AI 就能指哪打哪，精准输出并维护这段结构。

三、 技术/实操细节 (Technical)

1. 准备工作

• 编辑器：推荐使用 Obsidian。它不仅能打开和编辑 Markdown 文档，还支持双向链接和知识图谱，这对于整理复杂思路非常有帮助。你也可以用 VS Code，功能类似，按需选择。
• AI 编程工具：文档协作的能力取决于背后的底层大模型。一般的文本任务使用 OpenCode 搭配 Minimax 就足够了；如果追求更加严谨的代码级调整或结构化归纳，可以使用 Anti Gravity 搭配 Genai 3.0 Pro。

2. 精准定位实操

文档准备好之后，让 AI 介入的核心操作就是：精准定位——告诉 AI 动哪个文件、哪个章节。

比如你先让 AI 帮你写了一份西红柿炒鸡蛋的菜谱文档（位于 e:/菜谱/西红柿炒鸡蛋.md）：

# 西红柿炒鸡蛋  ## 食材准备 - 西红柿 2个 - 鸡蛋 3个 - 葱花、盐、白糖、食用油适量  ## 制作步骤 1. 处理食材：西红柿洗净切块，鸡蛋加少许盐打散 2. 炒鸡蛋：油热后倒入蛋液，炒成大块盛出备用 3. 炒西红柿：加少许油，放入西红柿中火翻炒出汁 4. 混合翻炒：把鸡蛋倒回锅中，加盐和白糖调味 5. 出锅装盘：撒上葱花即可 

如果你发现文档里针对“炒西红柿”的步骤写得过于简单，想让 AI 搜索更准确的做法然后修正，切记不要全盘重写，标准的 Prompt 示例如下：

e:/菜谱/西红柿炒鸡蛋.md 中 "## 制作步骤" 的第 3 步描述不够详细，请联网搜索准确信息核实，如果不对请修正。 

四、 避坑与反馈 (Iterative)

• 修改失控问题：如果不使用完整的操作系统文件路径和Markdown 章节符号进行限定，AI 容易产生全局重写的幻觉。
• 调整模式不变：不论是增删章节、调整结构还是合并内容，操作方式都是完全一致的——先引用文件绝对路径，再引用章节名或步骤编号。对于高频使用的局部调整，一旦养成这个极客习惯，AI 就能无损理解你的修改意图，局部改动绝对不会影响其他内容。

五、 总结与启动方式 (Operation)

利用 AI 加上 Markdown，你可以把文档拆卸成一块块积木交给 AI 翻新。指定路径、指出标题、给出意图，文档协作就此开始。

我是 CC，分享那些不吹牛的 AI 实战经验。 获取更多思路或深入交流，欢迎联系博主微信 ccymm1101。