Improve Doc
遵循Diataxis框架分析与改进现有文档质量
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Improve Doc。 它的用途是：遵循Diataxis框架分析与改进现有文档质量 完整的 Skill 内容见：https://321skill.com/skills/improve-doc-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请用Diataxis原则分析我提供的这份API接口文档。’ 它会首先评估当前文档属于哪种类型（如参考文档），然后检查其结构是否清晰、示例是否完整，并指出哪些部分需要补充教程性质的入门引导，或哪些参数说明应归入更详细的解释性章节。
介绍
这个Skill旨在解决文档质量参差不齐、结构混乱、难以满足用户需求的问题。它基于Diataxis文档框架，对现有文档进行系统性分析，识别其在教程、指南、参考和解释四种类型上的缺失或不足，并提供具体的改进建议。
使用时，您只需将现有文档内容提供给AI，它会自动评估文档的结构、内容完整性和目标受众匹配度，并生成一份详细的改进报告，指出需要补充、重组或重写的部分。
它非常适合文档工程师、技术写作者、产品经理以及任何需要维护高质量项目文档的开发者和团队。无论是API文档、用户手册还是内部流程说明，都可以通过此Skill获得提升。
建议在文档编写的中后期或定期回顾阶段使用此Skill，以获得更客观的评估。请注意，它提供的是基于框架的结构性建议，具体的文案润色和深度技术细节仍需人工把关。
核心特点
核心区别在于严格遵循Diataxis这一成熟的文档理论框架进行系统性分析，而非仅进行语法检查或简单重组，能从根本上改善文档的用户体验和信息架构。
注意事项
不适合用于创意写作、营销文案或无需结构化组织的纯叙述性内容。
常见问题
Diataxis框架是什么？
一种将文档分为教程、操作指南、参考和解释四种类型的结构化方法，旨在针对不同用户需求提供最合适的内容。
能直接帮我重写文档吗？
不能，它主要提供分析报告和改进建议，具体的重写和内容填充需要您基于建议手动完成。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/improve-doc-x-5/raw/index.md 读取 Improve Doc 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/improve-doc-x-5/raw/index.md（查看排版版本）