📄 为 AI 代理路由统一的本地环境恢复指引

[cyfung1031]

Checklist / 检查清单

• Fixes mentioned issues / 修复已提及的问题
• Code reviewed by human / 代码通过人工检查
• Changes tested / 已完成测试

背景

AI 编码代理在执行开发或测试任务时，可能先遇到包管理器、Node 依赖或 Playwright Chromium 环境问题。为了让代理能够快速找到项目约定的恢复方式，本 PR 补充了对应的文档入口和环境恢复说明。

本次改动

• 在 AGENTS.md 的任务路由表中新增两个轻量入口：
  • 运行项目命令时读取 docs/develop.md；
  • 遇到 package-manager、dependency 或 Playwright browser 错误时，指向 docs/develop.md#environment-setup-and-recovery。
• 在 docs/develop.md 新增 Environment Setup and Recovery 章节，说明：
  • pnpm 不可用时，优先使用仓库声明的 package manager，并在 Corepack 可用时通过 corepack enable 和 corepack install 进行设置；
  • Corepack 不可用或设置失败时，将实际命令和错误报告为环境阻塞，不改用 npm/yarn；
  • Node 依赖缺失、无效或过期时使用 pnpm install；
  • 如果依赖安装改变 pnpm-lock.yaml，停止并报告 mismatch，不把 lockfile 变更作为环境恢复提交；
  • Playwright Chromium 缺失或不可用时，在依赖安装完成后使用 pnpm run test:e2e:install；
  • 环境恢复后重新执行原始命令；
  • 网络、权限或工具可用性导致恢复失败时，报告环境问题，不通过修改 lockfile 或其他 workaround 隐藏失败。
• 保持原有 Commands 内容顺序不变：环境恢复章节位于格式化、提交钩子、issue-template 检查和开发服务器加载说明之后。
• 具体恢复机制只在 docs/develop.md 维护；AGENTS.md 只保留路由，避免始终加载的代理内核重复规则。

范围

本 PR 仅修改开发文档：

• AGENTS.md
• docs/develop.md

不修改产品运行时代码、依赖声明、lockfile 或测试实现。

验证

• 最终 diff 仅包含上述两个文档文件。
• git diff --check 通过。
• pnpm exec prettier --check AGENTS.md docs/develop.md 通过。
• 9/9 个确定性指令场景通过：项目命令冷启动、package manager 缺失、依赖缺失、Playwright 缺失、lockfile mismatch、恢复阻塞、单一文档归属、原有 Commands 顺序和稳定锚点。
• AGENTS.md 不包含具体恢复命令；docs/develop.md 是恢复流程的唯一所有者。
• pnpm --version 和 pnpm exec playwright --version 已验证可用；当前环境没有 corepack，因此 Corepack 分支未执行真实 bootstrap。

已知限制

本 PR 提供的是环境恢复指引，不保证相关安装命令在所有执行环境中都能成功。实际结果仍可能受到网络、权限、Corepack/tool availability 和本地缓存状态影响。确定性场景是源码代理验证，不代表真实模型行为或人工验收。