docs: 补充开发环境自解锁与求助阈值规则

This commit is contained in:
cat-shark
2026-10-22 21:55:14 +08:00
parent b1d1317491
commit ba16a65063
3 changed files with 25 additions and 0 deletions
+1
View File
@@ -60,3 +60,4 @@
| Windows / PowerShell 环境 | `shell-environment.md` | 执行 shell 命令、报错排查时 |
| 工作区资产归属 | `workspace-layout.md` | 决定文档/规则/技能放哪时 |
| 跨仓库 Git 操作 | `repo-operations.md` | 对子项目执行 git 命令时 |
| 开发环境自解锁与求助阈值 | `dev-unblock-and-escalation.md` | 被登录/权限/凭据卡住、同一问题反复尝试未解决时 |
@@ -0,0 +1,23 @@
# 开发环境自解锁与求助阈值
- **功能**:规定在开发环境被登录、凭据、权限等环境性障碍卡住时,如何用可控的临时手段自行解锁,以及何时必须停下来向用户求助。
- **何时用**:开发环境中复现/验证被登录或权限拦住时;缺凭据、缺测试数据、缺开关导致无法推进时;同一问题连续尝试多轮仍未解决时。
## 规则
### 自行解锁优先
- 在开发环境(本地 / dev 环境)里,若因登录、鉴权、凭据或测试数据缺失而无法完成验证,允许**临时修改被测系统**来打通路径,例如临时调整后端登录接口、放开某条校验、注入测试账号或数据。
- 临时改动必须满足:只在开发环境生效;范围最小、位置集中、一眼可识别;不提交、不混入业务改动。
- 解锁完成后必须**还原临时改动**,并在最终汇报里说明「改了什么、是否已还原」;若无法还原,必须明确标出并提示用户。
- 禁止用复杂且会污染运行环境的绕过手段(伪造会话状态、拦截网络请求、长时间改配置等)替代直接、可控的临时解锁。
### 尝试预算与求助阈值
- 对同一个目标,若连续尝试达到 **5 次**仍未解决,立即停止继续加码。
- 出现以下任一情况时,不再自行尝试,直接询问用户:
- 无法用可控的临时手段解锁,或解锁本身有风险、会破坏环境;
- 同一目标尝试达到 5 次仍未解决;
- 障碍超出自身可处理范围(需要外部凭据、他人授权、环境权限)。
- 求助时必须**把问题描述清楚**,至少包含:想做什么、卡在哪一步、已经尝试了什么及结果、需要用户提供什么(凭据 / 决策 / 环境操作)。
- 不要在信息不足时硬猜或反复试探;一次清晰的提问优于多次无效尝试。
+1
View File
@@ -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/`)