gen-test-plan

用途：分析仓库技术栈、对比分支与默认分支的改动，生成聚焦用户可见影响的 E2E 测试计划，而非自动化测试包装。计划交由自动化智能体像人工 QA 一样执行：启动真实二进制、访问真实端口、操作真实数据库并验证可观测行为。\n\n主要能力：通过 git diff 与合并基线确定改动文件与提交信息；检测栈、入口点和端口；发现面向用户入口点，包括 CLI 子命令、HTTP 端点、UI 路由、TUI、gRPC、数据库迁移和影响运行时行为的配置文件；用导入链和架构文档将改动追踪到入口点并分为“核心功能”与“配置/管理”两类；生成 YAML 到 docs/testing/test-plan.yaml，包含 version、metadata、setup、tests 等字段。\n\n用法：参数 --base <branch> 指定基线分支（默认 main），Path 指定目标目录。步骤包括采集仓库上下文、检测栈、发现入口点、追踪改动、生成用例、写入 YAML、输出摘要、执行验证。CLI 用例调用真实二进制并检查 stdout/stderr/退出码与副作用；服务端用例在 setup 中启动服务并用 curl 或 agent-browser 命令测试；数据库用例通过命令写入后用查询验证。浏览器步骤必须使用 agent-browser CLI（如 open、snapshot -i、click @ref、screenshot）。\n\n限制与硬性门槛：禁止复用项目自动化测试，不得在任何 run 步骤或 services 命令中调用 cargo test、pytest、npm test、go test、mix test、jest、vitest、mocha 等测试运行器；计划须通过 YAML 解析并含四个顶层键；至少一个测试须覆盖核心功能入口，否则需说明并标记人工复核；须有行为覆盖，不能只有配置类用例。纯库项目若无用户入口，需通过公开 API 的小型驱动脚本验证，而非运行测试套件。端口默认保守推断（API 8000，前端 5173/3000）。