weichenandCursor
20f52d025b
Rewrite AGENTS.md with taxonomy, worktree, and integration slot rules; add FEATURE-MATRIX-driven CURRENT; tool stubs; session-close checklist. Co-authored-by: Cursor <cursoragent@cursor.com>
66 lines
3.3 KiB
Plaintext
66 lines
3.3 KiB
Plaintext
---
|
||
description: 规定项目中所有自动化测试、功能测试、集成测试报告的存放路径与结构标准规范
|
||
globs: ["**/*test*.go", ".doc/test-reports/**/*.md"]
|
||
alwaysApply: true
|
||
---
|
||
|
||
# 测试报告规范准则 (Test Reports Standard)
|
||
|
||
本仓库严格遵循标准化、可追溯的质量测试管理体系。所有测试报告必须归档于指定的文档目录下，并遵循固定结构。
|
||
|
||
## 一、 测试报告归档路径规范
|
||
|
||
- **统一目录**：所有测试报告必须统一存放于 `.doc/test-reports/` 目录下。
|
||
- **命名规范**：遵循 `YYYY-MM-DD-<模块/功能/版本>-test-report.md` 命名格式。
|
||
- 例如：`.doc/test-reports/2026-09-07-three-branch-intent-framework-test-report.md`
|
||
- **证据附件**：运行产物（json/jsonl、workspace 快照、截图）放 `.doc/test-reports/assets/<report-slug>/`，**不得**与 `*-test-report.md` 混放在同一层级目录。
|
||
|
||
---
|
||
|
||
## 二、 测试报告固定结构模板
|
||
|
||
每份测试报告必须包含以下核心板块：
|
||
|
||
```markdown
|
||
# [功能/模块名称] 测试报告
|
||
|
||
## 一、 测试背景 (Background)
|
||
- 简述被测功能/特性的产生背景、业务痛点或上一轮测试中发现的缺陷与瓶颈。
|
||
|
||
## 二、 测试目标 (Test Objectives)
|
||
- 列举本次测试需要验证的核心功能点、质量指标（如通过率 100%、无流程卡点、非阻塞人机协同等）。
|
||
|
||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||
- 测试环境（OS、Go 版本、后端 Stub/Real 模型）；
|
||
- 测试层级分层（单元测试、协同集成测试、CLI 真实交互测试）；
|
||
- 核心测试用例矩阵设计。
|
||
|
||
## 四、 预期结果 (Expected Results)
|
||
- 明确给出各用例输入下的理论判定分支、目标意图、提取槽位、参谋回复风格与状态机流转。
|
||
|
||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||
- 必须包含针对每一个典型测试用例的真实记录：
|
||
- **测试输入 (Input)**
|
||
- **实际输出 (Actual Output)**：贴出真实的终端/日志输出文本
|
||
- **评价判定 (Evaluation / Verdict)**：PASS / FAIL 标志及判定依据
|
||
- **性能与耗时 (Duration & Latency)**
|
||
|
||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||
- 附带 `go test -v ./...` 全量回归测试输出与通过率统计。
|
||
|
||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||
- 总结测试是否达到上线/合并标准，提出后续演进或强化点。
|
||
```
|
||
|
||
---
|
||
|
||
## 三、 执行要求与真实 Agent 交付铁律
|
||
|
||
1. **真实 Agent 交付铁律（红线）**：
|
||
- **开发实现阶段**：可以快速使用 `stub` 验证状态机、协议分流、数据落盘与逻辑契约，加速反馈；
|
||
- **交付前验收与测试报告生成**：**必须切回真实环境与真实 Agent（`pi-agent` + 实际运行的 `MiniMax-M2.7-highspeed` 容器）进行全链路端到端实测**；
|
||
- **严禁**使用 stub 的测试输出作为最终交付报告的验收数据。
|
||
2. **严禁散落存放**：测试报告统一归档至 `.doc/test-reports/` 目录下，禁止散落在根目录或临时沙箱中。
|
||
3. **真实控制台取样**：测试报告中的输入、输出、耗时与判定必须取自实际环境运行的真实控制台输出与日志。
|
||
4. **Git 规范管理**：测试报告伴随对应阶段的 `docs(test)` 或 `test(...)` 规范提交入库。
|