docs: 增加调研上报规则

This commit is contained in:
cat-shark
2026-09-19 21:59:10 +08:00
parent f48d4bcd00
commit e3a50284b1
+13
View File
@@ -2,6 +2,19 @@
本仓库不是产品项目,不包含前后端业务代码。它只作为本地工作区协调仓库,用于让 Codex 一次性了解多个独立项目,并在缺失子项目时自动拉取。
## 调研与问题定位规则
- 本规则适用于「调研、排查、定位问题」类任务(例如“现象是不是这个改动引起的”“为什么这里变慢了”),不适用于已有明确改法的一次性修改。
- 「1 轮调研」指一条连续的最小验证路径:确认现象范围 → 对比可疑改动 → 拿到可复现/可量化的证据。
- 如果 1 轮调研后仍未定位到根因,必须停止自行扩大调查范围,先向用户汇报,由用户决定是否继续调查或调整方向。
- 汇报必须包含以下内容,缺一不可:
- 已确认的事实与证据(具体命令、文件、提交、返回值,而不是推测)。
- 已排除的可能原因(以及排除依据)。
- 当前卡点:还缺哪个信息、需要谁提供(例如用户登录凭据、某个环境的数据量、一次控制台取样)。
- 建议的后续方案(1-3 个,标注推荐项与各自代价)。
- 汇报后等待用户决定,不要一边汇报一边继续发散式尝试;同一方向连续失败两次就转为汇报。
- 禁止把「可能是 X」直接当成结论去改代码;只有拿到证据的结论才允许进入修改阶段。
## 提交规范
- 提交信息必须简短且使用中文,不要使用英文长句。