Improve Doc

介绍

你是否发现团队文档要么没人看，要么看了找不到重点？Improve Doc 帮你摆脱这种困境。它基于 Diataxis 文档分类框架（教程、操作指南、解释、参考），自动分析现有文档的结构、措辞和受众适配度，精准定位混乱、缺失或冗余的部分，并给出可落地的修改建议。无论是 API 文档、用户手册还是内部 Wiki，它都能让信息组织更清晰、读者更容易找到所需内容。

使用方式很简单：输入文档原文或粘贴链接，Skill 会先按 Diataxis 四象限对内容做分类打分，然后逐一检查每部分的完整性、一致性和可操作性。它会标记出“教程缺步骤”“操作指南跳过前提”“解释过于技术化”“参考格式不统一”等具体问题，并生成一份带优先级排序的改进清单。你还可以要求它直接输出优化后的版本，保留原意但提升可读性。

适合所有需要维护文档的团队和个人，尤其是文档工程师、技术写作者、产品经理和开源项目维护者。如果你正在为文档质量头疼，或者想系统性地提升用户自助服务能力，这个 Skill 很对路。对于刚起步的项目，它也能帮你建立良好的文档规范模板。

建议：使用前先明确文档目标受众（初级用户、开发者还是决策者），这样 Diataxis 分类会更准确；改进建议并非绝对标准，请结合业务场景做裁剪。如果文档已有严格的结构化要求（如特定模板），可能需在输出后做适配调整。