| name | repo-investigation |
| description | 生成项目理解报告并刷新对项目现状的认识。Invoke when the task touches existing code, business scope changes, or current understanding may be outdated. |
Repo Investigation
目标
通过阅读代码、配置、文档、日志和运行结果,生成项目理解报告,保证后续设计建立在最新现实之上。
状态规则
- 当前状态固定输出为:
项目调查中
- 如果只是小范围变化,可做局部刷新;如果边界变化较大,应做全量调查
用户参与规则
以下情况必须拉用户参与:
- 对项目目标或业务边界存在两种以上解释
- 发现仓库现实与用户口述冲突
- 无法从代码中确定关键约束,需要用户补充真实业务背景
触发用户参与时,必须使用选择题形式,而不是开放式追问。至少给出“我的理解”“另一种可能理解”等选项,并明确推荐项。
调查重点
- 项目目标与主要模块
- 当前需求相关链路
- 关键接口、库表、配置、任务、缓存、权限点
- 现有实现与潜在约束
- 已知风险与未知项
输出契约
必须生成 项目理解报告,至少包含:
- 当前状态与调查范围
- 项目/模块目标理解
- 当前相关模块与职责
- 关键调用链或数据链
- 相关接口、库表、配置、任务
- 已确认事实
- 关键约束
- 未知项与待确认问题
- 对后续业务设计的影响
- 如存在歧义,附“理解选择题”
回退规则
- 如果在
business-design 或 implement-verify 阶段发现理解与现实冲突,应回退到本阶段
- 回退后必须更新项目理解报告
禁止事项
- 禁止只看目录不读关键实现就下结论
- 禁止把猜测写成已确认事实
- 禁止没有报告就进入已有代码项目的后续设计