repo-investigation

name	repo-investigation
description	生成项目理解报告并刷新对项目现状的认识。Invoke when the task touches existing code, business scope changes, or current understanding may be outdated.

Repo Investigation

目标

通过阅读代码、配置、文档、日志和运行结果，生成项目理解报告，保证后续设计建立在最新现实之上。

状态规则

• 当前状态固定输出为：项目调查中
• 如果只是小范围变化，可做局部刷新；如果边界变化较大，应做全量调查

用户参与规则

以下情况必须拉用户参与：

• 对项目目标或业务边界存在两种以上解释
• 发现仓库现实与用户口述冲突
• 无法从代码中确定关键约束，需要用户补充真实业务背景

触发用户参与时，必须使用选择题形式，而不是开放式追问。至少给出“我的理解”“另一种可能理解”等选项，并明确推荐项。

调查重点

• 项目目标与主要模块
• 当前需求相关链路
• 关键接口、库表、配置、任务、缓存、权限点
• 现有实现与潜在约束
• 已知风险与未知项

输出契约

必须生成 项目理解报告，至少包含：

1. 当前状态与调查范围
2. 项目/模块目标理解
3. 当前相关模块与职责
4. 关键调用链或数据链
5. 相关接口、库表、配置、任务
6. 已确认事实
7. 关键约束
8. 未知项与待确认问题
9. 对后续业务设计的影响
10. 如存在歧义，附“理解选择题”

回退规则

• 如果在 business-design 或 implement-verify 阶段发现理解与现实冲突，应回退到本阶段
• 回退后必须更新项目理解报告

禁止事项

• 禁止只看目录不读关键实现就下结论
• 禁止把猜测写成已确认事实
• 禁止没有报告就进入已有代码项目的后续设计