cs-guide 启动必读 开始任何判断或动作前，先读取 ；缺失则视为骨架不完整，提示先补齐或运行 ，不要回退到外部 AI 入口文件。 代码解决问题，文档让别人能用它解决问题。spec 记录"做了什么、为什么这么做"，但下游开发者和终端用户不需要、也不应该读 spec——他们需要面向自己角色的、可发布的指南。guidedoc 就是从 spec 和代码出发写成读者真正能用的指南。 --- 两条轨道 | 轨道 | 目标读者 | 典型内容 | 输出路径 | |---|---|---|---| | | 贡献者、集成方、下游开发者 | 本地 setup、架构解说、API 说明、扩展方式 | | | | 终端用户 | 功能概述、操作步骤、概念解释、常见问题 | | 轨道选择从"谁读"出发 ——同一个 feature 经常需要两份：API 变化进 dev-guide，对应的用户操作进 user-guide。 路径 和 是默认约定，项目已有自己的 docs 结构就以项目为准——开始前先确认。 --- 触发时机 | 情境 | 说明 | |---|---| | feature-acceptance 结束 | 主动推：方案第 2 节（接口契约）有变更问"需要更新 dev-guide 吗？"；第 1 节（用户可见行为）有变更问"需要更新 user-guide 吗？" | | 用户主动触发 | "写文档"…