梳理已有代码的模块与调用关系

这个场景能帮你做什么

接手旧项目时，目录名称不能完整说明功能落在哪里。WorkBuddy 可以阅读授权代码和已有文档，整理入口、模块职责、调用与数据流，为定位修改位置提供地图。

开始前需要准备什么

提供明确版本的代码副本、README、架构说明和本次想理解的用户任务。限定可读目录和排除项，避免将密钥、生产数据等无关内容纳入。说明是否允许运行代码；只读理解无需运行。

具体怎么做

第一步：从目标任务定位入口

先找启动、路由、命令或事件入口，再沿实际调用查看关键模块。不能只遍历目录就声称理解全部系统。

第二步：记录职责与边界

每个模块写负责什么、不负责什么、输入输出、依赖和代码位置。文档描述与代码不同的分别保留，不能自动认定哪方正确。

第三步：追踪关键调用与状态

沿目标任务列调用顺序、外部接口、数据读写和错误处理。动态加载或运行时配置无法静态确认时标待核，不编造完整调用图。

第四步：形成理解说明

输出模块表、任务调用路径和未知点，附需向维护者确认的问题。若为修改准备，列可能受影响的调用方，不直接改代码。

可以直接交给 WorkBuddy 的完整要求

只读指定版本代码与文档，围绕目标用户任务梳理入口、模块职责、调用、数据流和异常路径。
每项给准确文件/函数定位，区分代码事实、文档说明和待验证推断。
动态关系无法确认就标未知。输出模块表、关键路径和维护者问题，不修改、不安装依赖、不执行生产程序。

完成后会得到什么

一份有代码位置的模块说明和目标任务调用路径，可用于新人交接、修改定位或评审准备。

结果应该怎么检查

开发人员沿几条关键路径核对入口、接口与读写位置，特别检查后台任务、回调和异常分支。确认文档没有超出实际阅读范围。

遇到这些情况怎么处理

代码缺依赖或配置时列出限制。生成代码与业务代码分开。存在多版本部署时明确本次理解对象，不把本地代码当线上事实。

哪些必须人工决定

维护者确认架构意图、历史约束和实际部署关系。AI 辅助阅读，不能从静态代码证明运行正确。