auto-test-projectlisted
Install: claude install-skill huangwb8/skills
# auto-test-project(项目级自动化测试驱动优化)
## 与 bensz-collect-bugs 的协作约定
- 因本 skill 设计缺陷导致的 bug,先用 `bensz-collect-bugs` 规范记录到 `~/.bensz-skills/bugs/`,不要直接修改用户本地已安装的 skill 源码;若有 workaround,先记 bug,再继续完成任务。
- 只有用户明确要求“report bensz skills bugs”等公开上报时,才用本地 `gh` 上传新增 bug 到 `huangwb8/bensz-bugs`;不要 pull / clone 整个仓库。
## Quick Start(最快路径)
1. 在“目标项目根目录”创建本轮会话骨架(会自动创建 `plans/` 与 `tests/`):
```bash
python3 auto-test-project/scripts/create_test_session.py --project-root . --kind a --create-plan
```
安全提示:该脚本会在 `--project-root` 下创建 `plans/` 与 `tests/`。为防止误用,默认拒绝将系统根目录或用户主目录作为 project-root;如你确有需要,可显式加 `--allow-unsafe-root` 覆盖。
2. 在 `plans/vYYYYMMDDHHMM.md` 写出本轮问题清单(至少 10 个),并使用可引用编号(如 `P0-1`)。
3. 按计划修复,并补齐 `tests/vYYYYMMDDHHMM/TEST_PLAN.md` 与 `tests/vYYYYMMDDHHMM/TEST_REPORT.md` 的可复现证据。
4. 运行验证脚本(推荐收尾用严格模式):
```bash
python3 auto-test-project/scripts/verify_test_session.py --require-plan tests/vYYYYMMDDHHMM
```
5. 重复 A 轮 N 次后,进入 B 轮质量检查与验证。
## 目标
为完整项目(包括技能项目、工作流项目、或其他具有 `CLAUDE.md` 或类似指令文件的项目)提供系统性的测试驱动优化能力,通过多轮迭代实现持续改进。
## 项目定义
本技能中的"项目"是指:
- 具有项目指令文件(如 `CLAUDE.md`、`AGENTS.md`、`PROJECT.md` 等)
- 具有明确的目录结构和功能模块
- 包含可执行的代码、脚本、或流程定义
- 类似 `init-project` 定义的项目结构
典型项目类型:
- **Agent Skills**:符合 [Agent Skills 开放标准](https://agentskills.io) 的技能
- **工作流项目**:定义了开发流程的项目
- **脚本工具集**:一组协同工作的脚本和工具
- **文档项目**:具有结构化文档和模板的项目
## 你要产出的东西
本 skill 的交付不是"口头建议",而是一组可追溯的文件:
- `plans/vYYYYMMDDHHMM.md`:A 轮问题分析与改进计划(每轮 1 份)
- `tests/vYYYYMMDDHHMM/`:A 轮测试会话目录(包含 `TEST_PLAN.md` + `TEST_REPORT.md`)
- `plans/B轮-vYYY