用途:维护项目文档,使其与代码实现保持一致,覆盖规范文档整理、代码文档化、新功能后补文档、改代码后更新文档等场景,由用户通过 slash command 主动触发。
主要能力:提供补充、新增、拆分、目录整理四种模式。补充模式坚持最小改动,先读现有文档再定位追加或修订,保持风格一致;新增模式依据 tree docs 的目录结构选择分类目录,按项目风格新建文档(中文、层级清晰、含必要代码示例、使用相对路径);拆分模式以“使用场景一致性”为核心判断标准,场景一致即使超过 800 行也不拆,场景不同才考虑拆分,原文档保留概述与链接索引;目录整理模式在单分类文档超过 5 个、存在子分类关系或归属不明时,通过子目录、archive/ 和历史文档归档、README.md 索引来组织。
使用方式:先理解用户要记录的内容,执行 tree docs 判断走补充还是新增模式;完成编写后用 wc -l <文档路径> 检查行数(<300 良好,300-600 关注,600-1000 评估,>1000 强烈建议拆分,行数仅作参考);随后按需更新 CLAUDE.md 的文档索引,仅改索引部分且保持最小改动;最后验证格式、链接路径与索引完整性。
适用场景:技术文档规范整理、代码规范沉淀、新功能开发后补文档、修改代码后同步文档、文档目录整理与拆分。
限制与规范:对 CLAUDE.md 改动务必慎重,只能修改文档索引部分;文档应精简,写“怎么做”而非“是什么”,含可复制代码示例与禁止写法;避免冗余与重复,文档路径使用相对路径;行数阈值不是硬性标准。技能目录为 .agents/skills/docs-manager/,其中脚本、参考与资源路径均相对该目录。具体安装命令与平台信息暂未提供。