构建项目文档体系 (build-project-docs) 为项目创建完整的分层式 LLM 友好文档。支持两种模式:已有项目梳理文档、新项目从 PRD 驱动开发。 核心理念 LLM上下文窗口有限,文档必须分层: - .claude/CLAUDE.md = 主索引(项目地图,始终加载到上下文) - .claude/docs/{模块}/README.md = 模块级文档(按需加载) - .claude/docs/{模块}/ .md = 深度参考文档(API详情、数据模型、坑点) - .claude/docs/{模块}/CHANGELOG.md = 模块变更历史(调试和回滚参考) --- 模式检测 开始前先判断当前模式: 文档模式(已有项目,有源代码) 项目已有代码,需要梳理生成文档。 全新 (无 )→ 按顺序执行文档模式全部8个阶段。 增量 ( 已存在)→ 1. 先检查 ——如果存在,说明上次会话中断,读取它确定: - 阶段状态 :哪些阶段已完成、哪个阶段进行中、哪些待执行 - 模块进度 :阶段4/5/7中哪些模块已完成、哪些待处理 - 直接跳到第一个未完成的阶段继续 ,不重复已完成的阶段 2. 如果 不存在,阅读现有 .claude/CLAUDE.md 和所有 .claude/docs/ 文件 3. 运行阶段1获取当前状态 4. 对比:新模块→加入,文件数变化→更新,缺失→创建,过…