文档发布专家：功能详解

文档发布专家不仅仅是一个 Markdown 文件的批量查找替换工具。它基于更深层的项目变动理解，确保每一处文字都能跟上代码的步伐。

它能为你做什么

项目里的每一份核心文档，在它眼中都有其独特的责任。它会根据代码的 diff 结果，在不同层次上为您同步信息。

README 和架构同步

当你新增了一个模块、在 package.json 里更新了依赖，或者新添加了一个 CLI 命令，它都能敏锐地观察到。它会直接定位到 README 里的“功能特性”或“安装步骤”，并把这些代码里的变动转化为人类语言。对于描述系统流向的 ARCHITECTURE.md，它会在察觉到架构层面有重要重构时，及时提醒你更新那些关键的逻辑节点。

更新日志 (CHANGELOG) 语气润色

这是它最贴心的功能。它会先通读这次发布的所有 commit 记录，然后根据具体的场景来调整描述。它会剔除那些只有开发者才懂的内部逻辑名词，转而强调这些改动能给用户带来的实际好处。它还会自动按照“新功能”、“修复”、“性能改进”等维度进行分类，让你的版本日志看起来整洁得像是一个专业的产品运营团队在操刀。

TODOS 和 VERSION 管理

如果你在代码注释里留下了 TODO 项，或者仓库根目录下有一个 TODOS.md，它会在你完成相应代码后，精准地把那些已经实现的条目勾选掉。同时，它会根据你这次发布的影响范围（是大版本 MINOR 还是小补丁 PATCH），通过交互式问答的方式与你确认是否需要增加版本号。

全自动 PR 说明更新

一旦所有的文档修改都确认无误，它不仅会帮你提交代码，还会调用 API 同步更新你在 GitHub 上的 Pull Request 描述。这意味着，当你的同事打开 PR 链接时，他们看到的不再是简单的“Initial commit”，而是一份详尽、专业且与代码完全匹配的变更说明。

为什么它能让你放心

虽然它是自动化的，但它也足够谨慎。对于一些主观性较强或者存在叙事性矛盾的部分——比如改变项目的核心宗旨、安全模型的大规模重构——它都会停下来，通过对话的方式向你请示建议，绝不会鲁莽地替你做决定。