用途:分析现有 Markdown 文档,按 Diataxis 类型对章节分类,识别问题,并交互式逐节改进。
主要能力:分两阶段运行。分析阶段解析文档、按 # / ## / ### 标题划分章节、加载 docs-style 核心写作原则、为每节判定 Diataxis 类型(Tutorial、How-To、Reference、Explanation,混合则标为 Mixed),并针对类型检查问题(如教程混入“为什么”、操作指南含解释性离题、参考缺参数类型、解释含步骤等)。随后展示分析摘要,用户输入 start 开始改进或 abort 退出。改进阶段按文档顺序逐节展示现状与问题,提出改进方案,用户可选 yes 应用、skip 保留原文、modify 反馈迭代;对 Mixed 章节优先建议拆分。完成后写回文件并报告变更。
使用方式:以文档路径调用,例如 improve-doc docs/guides/getting-started.md。分析前须加载 docs-style,遇到各类型章节时按需加载 tutorial-docs、howto-docs、reference-docs、explanation-docs。
限制:仅在改进阶段完成后才覆盖文件;skip 章节须逐行原样保留;类型分类不确定(置信度低于 70%)时先询问用户;abort 时不写入。具体安装方式与运行环境暂未提供。