From ba16a6506312ffa016c9c466e0f61cc362418feb Mon Sep 17 00:00:00 2001 From: cat-shark Date: Thu, 22 Oct 2026 21:55:14 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E5=BC=80=E5=8F=91?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E8=87=AA=E8=A7=A3=E9=94=81=E4=B8=8E=E6=B1=82?= =?UTF-8?q?=E5=8A=A9=E9=98=88=E5=80=BC=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/roles/README.md | 1 + .agents/roles/dev-unblock-and-escalation.md | 23 +++++++++++++++++++++ AGENTS.md | 1 + 3 files changed, 25 insertions(+) create mode 100644 .agents/roles/dev-unblock-and-escalation.md diff --git a/.agents/roles/README.md b/.agents/roles/README.md index 86838f8..b7797c1 100644 --- a/.agents/roles/README.md +++ b/.agents/roles/README.md @@ -60,3 +60,4 @@ | Windows / PowerShell 环境 | `shell-environment.md` | 执行 shell 命令、报错排查时 | | 工作区资产归属 | `workspace-layout.md` | 决定文档/规则/技能放哪时 | | 跨仓库 Git 操作 | `repo-operations.md` | 对子项目执行 git 命令时 | +| 开发环境自解锁与求助阈值 | `dev-unblock-and-escalation.md` | 被登录/权限/凭据卡住、同一问题反复尝试未解决时 | diff --git a/.agents/roles/dev-unblock-and-escalation.md b/.agents/roles/dev-unblock-and-escalation.md new file mode 100644 index 0000000..8d949ea --- /dev/null +++ b/.agents/roles/dev-unblock-and-escalation.md @@ -0,0 +1,23 @@ +# 开发环境自解锁与求助阈值 + +- **功能**:规定在开发环境被登录、凭据、权限等环境性障碍卡住时,如何用可控的临时手段自行解锁,以及何时必须停下来向用户求助。 +- **何时用**:开发环境中复现/验证被登录或权限拦住时;缺凭据、缺测试数据、缺开关导致无法推进时;同一问题连续尝试多轮仍未解决时。 + +## 规则 + +### 自行解锁优先 + +- 在开发环境(本地 / dev 环境)里,若因登录、鉴权、凭据或测试数据缺失而无法完成验证,允许**临时修改被测系统**来打通路径,例如临时调整后端登录接口、放开某条校验、注入测试账号或数据。 +- 临时改动必须满足:只在开发环境生效;范围最小、位置集中、一眼可识别;不提交、不混入业务改动。 +- 解锁完成后必须**还原临时改动**,并在最终汇报里说明「改了什么、是否已还原」;若无法还原,必须明确标出并提示用户。 +- 禁止用复杂且会污染运行环境的绕过手段(伪造会话状态、拦截网络请求、长时间改配置等)替代直接、可控的临时解锁。 + +### 尝试预算与求助阈值 + +- 对同一个目标,若连续尝试达到 **5 次**仍未解决,立即停止继续加码。 +- 出现以下任一情况时,不再自行尝试,直接询问用户: + - 无法用可控的临时手段解锁,或解锁本身有风险、会破坏环境; + - 同一目标尝试达到 5 次仍未解决; + - 障碍超出自身可处理范围(需要外部凭据、他人授权、环境权限)。 +- 求助时必须**把问题描述清楚**,至少包含:想做什么、卡在哪一步、已经尝试了什么及结果、需要用户提供什么(凭据 / 决策 / 环境操作)。 +- 不要在信息不足时硬猜或反复试探;一次清晰的提问优于多次无效尝试。 diff --git a/AGENTS.md b/AGENTS.md index 45dae9e..2822fd5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,6 +7,7 @@ - **通用规则(跨仓库)**:`.agents/roles/` - `todo-discipline.md` 待办收口 · `parallel-and-delegation.md` 并行与委派 · `commit-convention.md` 提交规范 - `research-and-reporting.md` 调研与问题定位 · `shell-environment.md` Windows/PowerShell · `workspace-layout.md` 资产归属 · `repo-operations.md` 跨仓库 Git 操作 + - `dev-unblock-and-escalation.md` 开发环境自解锁与求助阈值 - **各子项目专属规则**:该仓库自己的 `roles/`(如 `lpt-be/roles/`、`lpt-fe/roles/`) - **工作区级技能**:`.agents/skills/<技能名>/` - **子项目专属技能**:该仓库自己的 `skills/`(如 `lpt-be/skills/`)