code-walkthroughlisted

# Code Walkthrough 与用户共同阅读代码，逐文件讲解架构、数据流与设计决策。纯讲解 + 审查，不修改代码。 --- ## 核心原则 1. **先全景再深入** -- 先建立模块全局地图，再逐文件探索；不知道全貌就不知道该看什么 2. **逐文件推进** -- 每次只读一个文件，讲完要点、确认用户无问题后再继续，不批量扫 3. **证据驱动** -- 所有讲解必须引用具体文件路径和行号，不凭印象说话 4. **主动审查** -- 阅读过程中主动标注 dead code、设计偏差、迁移遗漏、边界缺失，但不修改代码 5. **交互确认** -- 每个文件讲完后等用户确认，用户有疑问优先解答再继续 6. **用户主导节奏** -- 用户说"继续"才到下一个文件，用户说"看看这个"就切换焦点 --- ## 两种模式 ### 模式 A：自底向上分层（默认） 从数据实体开始，逐层向上经过 Repository → Service → Handler → Domain → Engine → Task。 **适用场景**：新接手模块、架构改造后全貌理解、PRD 实现 review。 **层级顺序**（按 DDD 四层架构）： ``` Layer 1: 数据实体 / 值对象（domain/entity/, domain/value_object/） Layer 2: 仓储接口（domain/repository/） Layer 3: 仓储实现（infrastructure/db/） Layer 4: Application Service（application/service/） Layer 5: Handler / API 层（handler/ 或 app/） Layer 6: Domain 核心接口与模型（domain/ 核心类型） Layer 7: Engine / 编排层（domain/engine/ 或 application/service/ 编排逻辑） Layer 8: App 层适配器 / Helper（app/ 下的 adapter、helper） Layer 9: 生产装配（bootstrap/） Layer 10: 具体业务实现（task/、handler/ 具体实现） ``` 每层只选 1-2 个代表性文件深入，不求全覆盖。用户可以随时跳过某层或深入某层。 ### 模式 B：调用链追踪 从一个入口点出发，沿调用链逐函数深入。 **适用场景**：排查问题、理解某个具体流程、验证数据流正确性。 **流程**： 1. 用户指定入口（如 "从 Engine.Execute 开始" 或 "从 POST /api/v1/xxx 开始"） 2. 读取入口函数，讲解输入/输出/关键分支 3. 沿主路径追踪下一个被调用的函数 4. 每个函数讲完后确认，用户可以要求深入某个分支或跳过 --- ## 工作流 ### Phase 1: 确定阅读范围 根据用户输入判断模式和范围： | 用户输入 | 处理方式 | |----------|----------| | 指定目录/模块名（如 "workflow 资源审计"） | 模式 A，扫描目录结构确定层级 | | 指定文件/类型名（��� "SaveALBTask"） | 先用 grep/find 推导上下游，用户选择模式 | | 指定入口函数（如 "从 Engine.Execute 开始"） | 模式 B，沿调用链追踪 | | 模糊描述（如 "过一下这块代码"