编辑 | blame | 历史 | 原始文档

业务可视化文档维护规则

背景

docs/project-business/ 是项目业务可视化成果(Mermaid 业务图 + JSON 业务数据 + 可双击打开的 index.html),分析方法与维护规程见技能 project-business-analysis(.claude/skills/project-business-analysis/SKILL.md)。

规则

  • 当本次代码变更涉及**业务模块、核心业务对象/单据、业务流程步骤、状态流转、跨模块数据流、AI 能力、角色权限**中的任一内容时:
  • 若 docs/project-business/ 已存在:任务收尾前必须按技能的「维护模式」增量更新对应 mmd/json/html,更新内容以变更后实际代码为准。
  • 若尚不存在:不强制生成,但需在完成汇报中提示用户可运行生成模式建立业务全景。
  • 用户询问"系统是做什么的/某业务怎么流转/给我讲业务逻辑"时,优先调用技能 project-business-analysis 的阅读模式,基于已有业务文档回答并与源码核对。
  • 维护只做增量:只改与本次变更相关的文件,禁止无变更全量重生成。