- 遵循全局规则,并保留用户、其他 agent 和其他 worktree 的未归属改动。
- 改动保持在当前请求涉及的模块;优先现有项目脚本、测试入口和实现模式。
data/下的改动同时遵循最近的data/AGENTS.md。
- 用户明确要求浏览器检视,或 UI 行为无法通过代码和目标测试可靠证明时,使用 Playwright 检查 localhost 页面。
- 一般检查使用 quick 模式;只有用户要求全量巡检或问题确实跨越全部版块时使用 full 模式。
- 浏览器巡检配置以
ops/browser-mcp/inspection-profile.toml为准,并遵守其中的时间、版块和截图预算。 - 优先报告可复现的控制台错误、网络失败和行为问题;截图只作为确有帮助的辅助证据。
- 除非用户明确要求,浏览器访问范围保持在 localhost。
- 所有一次性运行输出放在
.runtime/下。 - 浏览器证据放在
.runtime/browser/,Playwright 输出放在.runtime/tests/playwright/,生成报告放在.runtime/reports/generated/,临时缓存放在.runtime/tmp/或.runtime/python/pycache/。 - 不在仓库根目录写入临时截图、日志、缓存或生成报告。
- 文档、注释和不参与执行或解析的文本变更无需运行项目测试。
- 隔离的行为变更默认运行一个最相关的目标测试或检查。
- UI 运行时行为在必要时运行一个聚焦的浏览器或 Playwright 检查。
- 共享契约、跨模块、数据、性能、构建、dist 或发布路径发生变化时,再扩大到相应的项目标准检查。
test:adaptive、supervisor、verify:core、verify:pr、nightly、release 和全量浏览器检查只用于验证框架自身改动、相关高风险路径、CI / 发布任务,或用户明确要求的场景。- bug 已复现、断言稳定且具有实际复发风险时,新增或更新回归测试。
- 检查已充分证明当前声明后停止;不重复未受新改动影响的检查,不为普通改动生成完整证据包。
- 不扩大 console、timeout 或 route allowlist 来掩盖真实失败。
- 最终说明改动结果、涉及文件、实际运行的检查及重要验证缺口。
- 只有确实生成并与结论相关时才列出 artifact。