| name | frontend-test |
| description | Use when verifying implemented frontend iteration work and producing docs/vX.Y.Z/test-report.md. |
| disable-model-invocation | true |
前端测试
目标
按 plan、summarized 全量回归,核对覆盖,出可审计的 test-report
输入
| 路径 | 必需 | 说明 |
|---|
docs/technical-architecture.md | 是 | 命令、框架、环境 |
docs/vX.Y.Z/plans/*.md | 是 | 测试矩阵 |
docs/vX.Y.Z/prd/summarized/*.md | 是 | 验收 |
docs/vX.Y.Z/design/*.md | 否 | 测试策略 |
docs/vX.Y.Z/progress.md | 是 | 步骤 4 TDD、验证记录 |
| 已实现代码 | 是 | 步骤 4 产出 |
缺必需项或实现未完则停止,回 implement 补 TDD 或实现
输出
调用契约与要求
- 调用契约见
frontend-iteration/references/orchestrated-invocation.md
- Agent 沟通风格见
frontend-iteration/references/agent-communication-style.md
- 只验证+报告,缺口回上游改测试或实现
工作流
- 读
docs/technical-architecture.md:单元/集成/E2E 命令与环境
- 读 test-writing-guide;用维度查 plans 矩阵
- 读矩阵、summarized、
progress.md 步骤 4 证据;列待执行项
- 查测试是否存在;缺 → 记缺口回 implement;本步不补
- 分层回归:单元 → 集成 → E2E;失败记并回 implement;不进下一层
- 命令、exit、结果写
progress.md → 验证记录
- 出 test-report:命令、覆盖、风险、接口 TODO
- 完成检查
- 摘要;等确认
规则
- 以 plan 为准:范围 ≤ 矩阵 + summarized 验收
- 只全量验证:不新测、不改逻辑;缺口回 implement TDD 补
- 核对 TDD:报告记关键 task RED/GREEN/REFACTOR(源
progress.md)
- 真跑:实际执行;以 exit、输出为准;不臆断过
- 分层门禁:单元不过不跑集成;集成不过不跑 E2E(无层则跳)
- 失败不推:相关命令失败 → 停本步;test-report
DRAFT/BLOCKED,结论「阻塞」;步骤 5 blocked
- 状态一致:确认后 test-report
ACTIVE,结论「可进入 review」,步骤 5 passed
- 框架:测试 API 从项目示例或官方文档取
- 证据:TDD 与命令结果以
progress.md 为准;report 汇总引用
- 状态门禁:见
frontend-iteration/references/orchestrated-invocation.md;上游不可用 → 停
测试层级
| 层 | 覆盖 | 源 |
|---|
| 单元 | 逻辑、工具、组件 | plan 矩阵 |
| 集成 | API 封装协作(mock);真联调 = 未覆盖风险 | plan + design |
| E2E | 关键路径 | summarized 主流程 |
未配置某层 → 报告标「未配置」+ 替代方式
常见场景
| 场景 | 处理 |
|---|
| 缺用例 | 记缺口;回 implement TDD 补 |
| 上游 STALE | 停;回上游;重跑实现/验证 |
| 单元过、集成败 | 记失败;回 implement 修再跑 |
| E2E 环境未就绪 | 标阻塞;与用户确认手动验收 |
| Flaky | 重跑 1 次;仍败按败处理 |
| 无 E2E | 报告说明;关键路径手动清单 |
| 验收无自动化 | 手动步骤+结果;标风险 |
| 真后端未联调 | mock 封装;报告列 TODO(vX.Y.Z): 接口联调待定 |
完成检查
交接下游 → 步骤 6
- test-report
- 变更范围(plan)
- 风险、未覆盖项
文件路径解析
读 skill / reference 时按序尝试(命中即用):
| 资源 | 路径 1(npx skills add) | 路径 2(源码) |
|---|
本子 SKILL.md 目录 | .agents/skills/frontend-test/ | skills/frontend-test/ |
| 编排 references | .agents/skills/frontend-iteration/references/<file> | skills/frontend-iteration/references/<file> |
| 其他 references | .agents/skills/<name>/references/<file> | skills/<name>/references/<file> |
| 样例 | .agents/skills/frontend-iteration/examples/ | skills/frontend-iteration/examples/ |
参考