LangBot QA Agent 文档导航

这个目录记录 langbot-skills 当前的 QA 方向和后续建设顺序。

当前判断

当前重点是 LangBot 的黑盒 E2E QA，不是 LangBot core 的单测覆盖率建设。

langbot-skills 要帮助开发者和 QA agent 做接近人工测试的 WebUI 验证：

• 打开真实 LangBot WebUI；
• 按用户路径点击和输入；
• 检查用户可见的 UI 结果；
• 查看 console、network、截图、后端和前端日志；
• 输出可复用的测试报告；
• 把稳定 feature 路径沉淀为 case；
• 把重复故障沉淀为 troubleshooting。

API 和 curl 只做诊断。它们可以解释失败原因，但不能让一个 UI case 通过。

文档状态

文档	状态	用途
04-black-box-e2e-roadmap.md	当前主路线图	决定下一步建设什么。
03-agent-browser-qa-principles.md	当前原则文档	定义 browser-first QA 的通过标准。
02-log-guard-plan.md	当前活跃设计	设计 lbs test report 里的日志守卫。
../user-guide.md	当前使用手册	开发者日常使用。
00-technology-options.md	背景文档	选择 Computer Use、Playwright MCP 或未来直接 Playwright。
01-qa-agent-harness-plan.md	历史规划，部分过时	解释最初分层和目录设计；使用前先看状态说明。

已过时的点

01-qa-agent-harness-plan.md 还保留早期规划状态。现在结构化 cases、 结构化 troubleshooting、validate、index、lbs test plan 都已经落地。

已经补上第一版 lbs test start、lbs test run、lbs test report 和日志守卫文件扫描。 webui-login-state、pipeline-debug-chat 已经绑定直接 Playwright 自动化脚本。后续重点是：

• 报告 evidence 字段继续打磨；
• case success/failure signal 和日志守卫规则继续补充；
• 报告产物和 evidence 约定；
• 等 LangBot 当前开发状态稳定后跑真实 sample report。

不要再把旧阶段列表当成当前 source of truth。后续排序以 04-black-box-e2e-roadmap.md 为准。