代码与 UI 业务逻辑文档生成器

文档为什么会失真

很多系统的代码能编译、有 CI，但业务文档没有同样反馈回路：接口变了、规则调整了，文档仍停留在上一版。这个技能解决的问题，是把代码和 UI 中已经存在的业务事实提炼成可维护文档，而不是从旧文档里继续抄。

技能如何工作

• 先判断模式：没有文档时走生成模式；文档存在但可能漂移时走反向同步模式，以代码为真相源校准。
• 先确认文档类型：如 PRD、HLD、LLD、测试文档、运营手册、管理员速查手册；类型未明确时不启动分析。
• 识别项目骨架：从根目录、入口文件、现有文档判断技术栈和模块边界。
• 提取高密度信息：路由、菜单、i18n、数据模型、权限中间件、错误码、状态机、CI 配置等，按目标读者选择关注点。
• 按类型深写：PRD 偏用户故事与验收标准，LLD 偏接口、数据结构和异常路径，运营手册偏操作影响、危险等级和业务规则命名。
• 生成与校准：先建章节骨架，再填内容；推断内容标 [INFER]，代码验证事实标 [FACT|文件:行号]，完成后检查关联文档是否需要同步。

适用边界与注意点

它适合已有可运行代码、UI 路由或配置文件的业务系统，尤其适合需求文档、架构文档、运维/运营文档的补全与校准。资料不足时不会凭空补全，而是标注不确定项；如果实现偏离设计意图，会把问题交还给用户裁决。