Improve Doc
基于Diataxis框架分析并改进现有文档质量
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Improve Doc。 它的用途是：基于Diataxis框架分析并改进现有文档质量 完整的 Skill 内容见：https://321skill.com/skills/improve-doc-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请用Diataxis原则分析我提供的这份API接口文档，指出它在教程、参考和解释部分分别存在哪些问题，并给出具体的改进建议。’ 它会首先识别文档中现有的内容分别属于哪种类型，然后评估其完整性和有效性，最后为您生成一份结构化的分析报告，包含具体的修改点和优化方向。
介绍
该Skill旨在解决文档内容混乱、结构不清、难以满足不同读者需求的问题。它通过应用Diataxis文档框架，对现有文档进行系统性分析，识别其在教程、操作指南、参考和解释等不同维度上的缺失或不足，并提供结构化的改进建议，帮助用户将文档从“能用”提升到“好用”。
使用时，您只需将现有文档内容提供给AI，并指定希望改进的方向（如提升可读性、增强实用性或完善结构），AI便会依据Diataxis原则进行分析，并生成具体的修改建议和重构方案。整个过程是交互式的，您可以针对AI的建议进行追问或调整。
该Skill特别适合文档工程师、技术写作者、产品经理以及任何需要撰写或维护高质量技术文档的开发者。对于团队中缺乏专业文档规范，或文档长期处于“能用但不好用”状态的场景尤其有效。
建议在使用前，对Diataxis框架（教程、操作指南、参考、解释四大类型）有初步了解，这样能更好地理解AI的分析逻辑。同时，最好提供相对完整的原始文档，而非零散的片段，以便AI进行全局性分析。注意，此工具侧重于文档结构和内容的改进，而非单纯的语法润色。
核心特点
与通用文档润色工具不同，它严格遵循Diataxis这一成熟的文档理论框架进行结构化分析，能系统性地诊断文档在教程、指南、参考、解释四大类型上的缺失，并提供基于该框架的、可落地的重构方案，而非零散的修改意见。
注意事项
不适合用于非技术性、纯文学性或营销文案的创作与优化。
常见问题
Diataxis是什么？
Diataxis是一种技术文档写作框架，将文档分为教程、操作指南、参考和解释四种类型，旨在针对不同读者需求提供最合适的内容。
这个Skill能帮我重写文档吗？
它主要提供分析、诊断和改进建议，引导您按照最佳实践重构文档，而不是完全自动重写。您需要基于建议进行手动修改。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/improve-doc-x-6/raw/index.md 读取 Improve Doc 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/improve-doc-x-6/raw/index.md（查看排版版本）