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

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

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

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

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

- 1 -

先说结论

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

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

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

- 2 -

它俩到底有什么不一样？

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

对比维度	OAP	Claude Code
它是谁？	Oxygen编辑器里的AI写作助手	能读写文件的AI编程智能体
最擅长啥？	写DITA/XML文档、校验标签、一键发布	写代码、操作Git、调用命令行工具
懂DITA吗？	天生就懂——知道<task>里该放什么标签	不懂——你得一次次告诉它DITA规则
适合谁用？	技术文档工程师	软件开发工程师

我打个比方：

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	通用对话能力更强，还能对接JIRA/Confluence
数据转换（旧文档转DITA）	OAP	自带Word→DITA转换引擎，一键批量处理
内容创作	OAP	所见即所得，自动补全标签，实时检查语法错误
DITA校验与修复	OAP	自动检查标签对不对、引用断没断，一键修复
内容评审	OAP	支持像Word一样的修订模式，还可以Web评审
多语言翻译	OAP	直接对接翻译工具链，保留标签不乱
版本管理	OAP	Oxygen 28.1内置Git Client，图形化管理分支
批量发布	各有千秋	OAP一键发布更简单，Claude Code做CI自动发布更强

---

我建议这么用：

需求梳理 [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. 还没开始做结构化，在调研

评论区聊聊～