上周有个朋友问我一个问题：

"我们团队要做DITA文档，用Claude Code不就行了？为啥还要花钱买Oxygen AI Positron？"

我当时愣了一下。说实话，我一开始也想过这个问题——Claude Code能读写文件、能调用命令行、还能装各种Skill，看起来啥都能干。

但后来我在实际项目里试了一圈，发现这两个工具根本不是一个赛道的。

今天把我踩过的坑和最终的选择分享给你。

- 1 -

先说结论

Oxygen AI Positron （以下简称OAP）是专注DITA文档写作的"专业相机"，Claude Code是啥都能干的"旗舰手机"。

拍专业照片得用专业相机，但手机在日常场景更方便。

对DITA团队来说，最佳方案是：OAP为主干创作工具，Claude Code做CI自动化辅助。

- 2 -

它俩到底有什么不一样？

我列个表，你一看就明白：

我打个比方：

OAP像是专门给DITA设计的相机——光圈、快门、ISO都调好了，按下去就能拍出专业照片。

Claude Code像是一部功能强大的手机——能拍照、能剪视频、能打游戏、能办公，但拍照这块毕竟不是它的主场。

看完这个表，你可能会想：那我用Claude Code写，写完再丢给Oxygen编辑器校验行不行？

理论上可以。但实际上——你会在两个工具之间来回切，切到怀疑人生。

我后来的做法是：一个工具干到底。写、改、校验、发布，全在OAP里完成。

- 3 -

我踩过的坑

刚开始我试过用Claude Code写DITA，踩了四个坑：

第一个坑：标签乱掉

文档一长，Claude Code就容易漏掉闭合标签。比如</p>忘写了，或者把标签顺序搞错。

DITA对标签顺序有严格要求——任务的步骤区，子元素必须按这个顺序出现：前置条件 → 背景 → 步骤 → 结果 → 示例 → 后续操作。

Claude Code不懂这些规则，经常放错位置。

第二个坑：乱修文档

遇到DITA报错，Claude Code有时候会直接删掉一整段内容来"消除错误"。

有一次它把客户的一个完整操作步骤删了，幸亏我发现得早。要是直接入库，后果你想想。

第三个坑：翻译毁标签

翻译带标签的句子时，Claude Code经常把XML标签弄坏。

翻译公司导进去就报错，来回返工了好几次。

第四个坑：不懂"积木式写作"

DITA文档像搭积木：一个Topic是一块积木，可以被多处引用。

Claude Code习惯写"长篇大论"的文章，经常把本来该拆成多个Topic的内容写成一整篇，或者把跨文件引用（conref）的内容直接复制粘贴过来。

写完是写完了，但后面维护的时候你会疯掉。

- 4 -

为什么DITA团队一定要用OAP？

踩完坑之后，我总结了四个理由。

理由一：DITA标签规则太严格，通用AI管不住

DITA有300多种标签，每种标签能放在哪里、能包含什么、出现顺序，都有严格规定。

OAP在写文档时会实时检查是否符合规则，错了立刻提醒。Claude Code只能"凭感觉"写，写错了也不知道。

理由二：天生懂"积木式写作"

OAP知道什么时候该开新Topic，什么时候该引用已有内容。不用你每次提醒。

理由三：Oxygen编辑器整个生态

OAP不是独立工具，它嵌在Oxygen XML Editor里面，能直接用到：

• 可视化编辑（像Word一样写文档，不用看XML代码）
• 智能补全（自动提示下一个合法标签）
• 一键发布（点一下就能生成PDF/HTML5）
• 在线评审（Content Fusion网页协作审稿）
• Planner智能体模式（可自主规划多步任务）
• 自定义Skill录制（把重复操作录成AI动作）
• Git Client 5.6.0深度集成（图形化分支管理、AI解读提交记录）

Claude Code在命令行里改XML，就像蒙着眼睛干活。

理由四：有Claude Code没有的文档级功能

• 能看懂整个DITA Map（文档目录树），不只盯着一个文件
• 能自动把一个太长的Topic拆分成多个
• 能检查所有跨文件引用是否正确
• 能预览不同读者看到的版本（比如管理员版vs普通用户版）

 - 5 -

在DITA全流程中，谁更好用？

我画了个表，你对照自己的场景：

我建议这么用：

需求梳理 [Claude Code] → 产出需求清单 ↓ 内容创作 [OAP] → 产出DITA文档 ↓ DITA校验 [OAP] → 自动修复语法错误 ↓ 评审修订 [OAP] → Web协作审稿 ↓ 多语言翻译 [OAP] → 导出XLIFF给翻译公司 ↓ 版本管理 [OAP] → Git提交/分支管理 ↓ 批量发布 [Claude Code] → CI自动发布PDF/HTML5，当然也可以使用CI工具，如Jenkins

这样分工的核心逻辑是：创作和校验用专业工具，自动化和集成用通用工具。

别想着用一个工具搞定所有事——专业的事，给专业的工具。

- 6 - 

有一条红线

绝对不要用Claude Code直接改DITA的结构性内容——比如拆Topic、改引用关系、重构标签。

Claude Code改完的内容，必须先经过Oxygen编辑器的DITA校验才能入库。

别问我怎么知道的。

上个月，我用Claude Code重构了一个客户项目的topic结构，改完觉得没问题，直接提交了。

结果第二天，客户打开ditamap：一半的引用路径断了。

从那以后，我定了一条红线：Claude Code可以辅助，但入库前必须经过Oxygen编辑器的DITA校验。

你们团队现在用什么工具做DITA？

• A. 只用Oxygen，没用过AI辅助

• B. 在用Claude Code，踩过类似的坑

• C. 两个都在用，分工明确

• D. 还没开始做结构化，在调研

评论区聊聊～

摩拿科技是专业的结构化文档和智能内容工具和服务提供商，我们在标准软件（如：Oxygen XML Editor， MxContent，MxHub）的基础上提供专业服务，协助企业文档结构化转型落地，用数据驱动企业人工智能，欢迎扫码了解：

点击下方卡片关注公众号 ⬇️