doc-updates
代码变更后自动更新文档，集成质量门与准确性检查
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：doc-updates。 它的用途是：代码变更后自动更新文档，集成质量门与准确性检查 完整的 Skill 内容见：https://321skill.com/skills/doc-updates-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'更新项目文档，新增用户认证模块的API文档，并运行质量门检查'，它会自动检测代码变更，更新对应文档，执行slop检测和准确性检查，确保文档与代码同步。
介绍
在软件开发过程中，代码变更后手动更新文档往往繁琐且容易遗漏，导致文档与代码脱节。doc-updates 解决了这一痛点，它能在代码变更后自动检测受影响的部分，并更新对应的文档，同时内置质量门（quality gates）、slop 检测（识别低质量或模糊内容）和准确性检查，确保文档既及时又准确。
使用方式非常简单：在完成代码变更后，运行 doc-updates 命令，它会自动分析代码差异，定位需要更新的文档区域，执行更新并运行质量检查。如果检测到 slop（如冗余、模糊描述）或准确性偏差，会提示修改或直接修正。你可以将其集成到 CI/CD 流水线中，在每次合并前自动触发文档更新校验。
该工具适合所有需要维护项目文档的团队，尤其是持续交付环境下，文档工程师、全栈开发者和项目经理都能从中受益。文档工程师可以节省大量手动更新时间，开发者能确保提交代码后文档同步最新，项目经理则可通过质量门把控文档交付标准。
建议在项目初期即引入该工具，并与代码仓库的 pre-commit hook 或 CI 脚本配合使用。注意，它适用于结构化文档（如 Markdown、API 规范），对于需要大量人工创意或复杂排版的文档（如产品手册），建议结合人工复审。另外，首次使用时需配置文档映射规则，以便工具准确关联代码与文档。
核心特点
与同类文档更新工具相比，doc-updates 内置了质量门、slop 检测和准确性检查三重机制，不仅能自动更新，还能主动识别并修复低质量或错误内容，避免文档退化。
注意事项
不适合非结构化文档（如设计稿、视频教程）或需要大量人工判断的创意型文档。
常见问题
支持哪些文档格式？
主要支持 Markdown、YAML、JSON 等结构化文档，可通过插件扩展其他格式。
如何集成到 CI/CD 流水线？
在 CI 脚本中添加 `doc-updates` 命令，并配置质量门阈值，若检查失败则中断构建。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/doc-updates-x-5/raw/index.md 读取 doc-updates 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/doc-updates-x-5/raw/index.md（查看排版版本）