From e3a50284b14bec2a2bd0698637993a9ba66a2fc0 Mon Sep 17 00:00:00 2001 From: cat-shark Date: Sun, 13 Sep 2026 18:50:54 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=E8=B0=83=E7=A0=94?= =?UTF-8?q?=E4=B8=8A=E6=8A=A5=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 3c3d06b..15d06de 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,19 @@ 本仓库不是产品项目，不包含前后端业务代码。它只作为本地工作区协调仓库，用于让 Codex 一次性了解多个独立项目，并在缺失子项目时自动拉取。 +## 调研与问题定位规则 + +- 本规则适用于「调研、排查、定位问题」类任务（例如“现象是不是这个改动引起的”“为什么这里变慢了”），不适用于已有明确改法的一次性修改。 +- 「1 轮调研」指一条连续的最小验证路径：确认现象范围 → 对比可疑改动 → 拿到可复现/可量化的证据。 +- 如果 1 轮调研后仍未定位到根因，必须停止自行扩大调查范围，先向用户汇报，由用户决定是否继续调查或调整方向。 +- 汇报必须包含以下内容，缺一不可： + - 已确认的事实与证据（具体命令、文件、提交、返回值，而不是推测）。 + - 已排除的可能原因（以及排除依据）。 + - 当前卡点：还缺哪个信息、需要谁提供（例如用户登录凭据、某个环境的数据量、一次控制台取样）。 + - 建议的后续方案（1-3 个，标注推荐项与各自代价）。 +- 汇报后等待用户决定，不要一边汇报一边继续发散式尝试；同一方向连续失败两次就转为汇报。 +- 禁止把「可能是 X」直接当成结论去改代码；只有拿到证据的结论才允许进入修改阶段。 + ## 提交规范 - 提交信息必须简短且使用中文，不要使用英文长句。