Improve Doc
用Diataxis原则系统分析和改进文档
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Improve Doc。 它的用途是：用Diataxis原则系统分析和改进文档 完整的 Skill 内容见：https://321skill.com/skills/improve-doc-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请分析我的项目README文档，使用Diataxis原则提出改进建议'，它会读取文档内容，识别缺少教程、指南、解释或参考的部分，并给出具体修改建议，例如补充快速入门教程或添加常见问题解释，帮助文档更清晰易用。
介绍
许多技术文档存在结构混乱、读者难以理解的问题，导致用户使用成本高、维护困难。Improve Doc 基于 Diataxis 理论框架（教程、指南、解释、参考四象限），自动分析现有文档的不足，给出针对性的改进建议，帮助文档从“能用”升级为“好用”。
使用方式非常简单：安装后，将待改进的文档内容或文件路径作为输入，Skill 就会进行结构化分析，输出每个象限的缺失或冗余部分，并附带具体修改示例。你无需手动切换工具，整个过程在对话内完成。
适合文档工程师、技术写作人员、产品经理以及任何需要持续维护项目文档的团队。无论你是初创项目还是大型开源项目，只要文档质量有提升空间，这个 Skill 都能帮你快速定位问题。
建议先在小型文档上试用，熟悉 Diataxis 的分析维度后再应用到复杂文档。注意，该 Skill 依赖文档已有内容进行分析，空白文档无法直接生成完整结构，更适合迭代改进场景。
核心特点
不同于通用的拼写检查或语法纠正工具，Improve Doc 专门基于 Diataxis 理论框架，从读者认知路径出发，识别文档结构层面的系统性缺陷（如缺少教程或过度依赖参考），而非仅关注措辞细节。
注意事项
不适合从零生成全新文档，需要已有文档作为输入，且对非结构化文本（如纯语法错误的短句）分析效果有限。
常见问题
Diataxis原则是什么？
Diataxis 是 Daniele Procida 提出的文档分类框架，将文档分为教程、指南、解释和参考四类，分别对应不同的读者需求和写作目标。
支持哪些文档格式？
支持 Markdown、纯文本、HTML 等常见格式，输入时直接粘贴内容或提供文件路径即可。二进制格式（如 PDF）需先转换为文本。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/improve-doc-x-3/raw/index.md 读取 Improve Doc 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/improve-doc-x-3/raw/index.md（查看排版版本）