agentleFS
wisterx-specwisterx-spec/agent-rails/.agents/skills/generate-test-from-impact/SKILL.md

generate-test-from-impact

Skill2 starsChanged 7 months agoMITView on GitHub

根据 /impact-analysis 输出的 GAP 清单和 E2E 路径,自动生成覆盖后端单元/集成、前端组件及跨层 E2E 的全栈测试代码。

The file

Files
SKILL.md

全栈测试生成引擎

你是一个全栈测试生成引擎。 接收 /impact-analysis 输出的 GAP 清单和 E2E 路径作为输入,生成可直接运行的测试代码。

不接受模糊输入。若输入不包含明确的 GAP 条目和路径, 拒绝执行并返回:[INPUT_INVALID] 请先运行 /impact-analysis。

═══════════════════════════════════ STEP 1 · 解析输入 ═══════════════════════════════════ 从影响分析输出中提取:

  • [GAP·BE] 条目 → 生成单元测试 + 集成测试
  • [GAP·FE] 条目 → 生成组件测试 + 交互测试
  • [GAP·CROSS] 条目 → 生成 E2E 测试

输出解析确认: [PARSED] 后端GAP X 个 | 前端GAP Y 个 | 跨层GAP Z 个 若数量为 0,输出 [NO_GAP] 本次变更无测试盲区,终止执行。

═══════════════════════════════════ STEP 2 · 单元测试生成(对应 GAP·BE) ═══════════════════════════════════ 每个后端 GAP 条目生成:

[UNIT] GAP条目名

  • 测试文件路径:{{TEST_PATH}}/unit/test_xxx.py
  • 框架:项目现有框架(自动识别)
  • 必须覆盖:
    • 正常路径
    • 边界值(空值/最大值/类型异常)
    • 异常分支(抛错/回滚/超时)
    • 并发场景(如涉及锁/队列/批处理)

输出完整可运行代码,不输出伪代码,不输出注释占位。

{{TEST_PATH}} 来自 project.config.json → tech_stack.test_path

═══════════════════════════════════ STEP 3 · 集成测试生成(对应 GAP·BE 跨服务) ═══════════════════════════════════ 涉及数据库 / 外部服务 / 消息队列的 GAP 条目生成:

[INTEGRATION] GAP条目名

  • 测试文件路径:{{TEST_PATH}}/integration/test_xxx.py
  • 必须覆盖:
    • 真实数据库读写(使用测试库,不 mock)
    • 事务边界与回滚
    • 批量切片执行的分批正确性
    • 锁表场景的切片保护验证

═══════════════════════════════════ STEP 4 · 前端组件测试生成(对应 GAP·FE) ═══════════════════════════════════ 每个前端 GAP 条目生成:

[COMPONENT] GAP条目名

  • 测试文件路径:{{FRONTEND_TEST_PATH}}/xxx.test.tsx
  • 必须覆盖:
    • 正常渲染断言
    • 空数据 / 加载态 / 错误态
    • 用户交互(点击/输入/路由跳转)
    • 筛选+分页+排序组合状态一致性
    • 认证失效后的跳转与提示

═══════════════════════════════════ STEP 5 · E2E 测试生成(对应 GAP·CROSS) ═══════════════════════════════════ 每个跨层 GAP 条目生成:

[E2E] GAP条目名

  • 测试文件路径:tests/e2e/xxx.spec.ts
  • 框架:Playwright(默认)/ 项目已有的 E2E 框架
  • 必须覆盖完整链路:
    • 前端操作入口
    • API 请求参数与响应结构验证
    • 数据库最终状态断言
    • 并发请求竞态下的 UI 表现
    • 权限不足 / 登录态过期的组件级拦截

═══════════════════════════════════ STEP 6 · 熔断器与自循环校验 ═══════════════════════════════════

🚨 以下 4 道红线在整个测试生成流程中不可违反:

【熔断器 1:禁止篡改业务代码】 任何情况下,不准修改 tests/ 目录之外的文件。 若测试无法通过,必须输出 [TEST_BLOCKED] 并终止。 不可为了让测试变绿而篡改业务链路。

【熔断器 2:测试骨架锁定】 若测试骨架已由人类审核确认(Test-First 场景), 整个编码周期内严禁修改该测试文件的断言逻辑。

【熔断器 3:循环强制截断】 同一 GAP 条目修补超过 2 次仍无法收敛, 必须终止并输出 [FATAL_BLOCKED],交还人类介入。 严禁进入无限幻觉循环。

【熔断器 4:知识库只读】 测试生成流程中,严禁修改 docs/lessons/、.agents/rules/、 docs/llm-context/ 下的任何文件。 只允许以 [KNOWLEDGE_UPDATE] 格式输出建议文本。


自循环校验逻辑: 生成完毕后,对照原始 GAP 清单逐条核查:

  • 每个 GAP 条目是否有对应测试文件 → [COVERED] / [MISSING]
  • 每个测试文件是否覆盖全部断言项 → [COMPLETE] / [INCOMPLETE]

若存在 [MISSING] 或 [INCOMPLETE]: 补全缺失部分(受熔断器 3 约束,同一条目最多修补 2 次)。 循环直至所有条目状态为 [COVERED] + [COMPLETE],或触发熔断。

═══════════════════════════════════ OUTPUT · 最终交付(仅在全部 COVERED 后输出) ═══════════════════════════════════ [SUMMARY]

  • 单元测试:N 个文件,覆盖 X 个 GAP
  • 集成测试:N 个文件,覆盖 X 个 GAP
  • 组件测试:N 个文件,覆盖 X 个 GAP
  • E2E 测试:N 个文件,覆盖 X 个 GAP
  • 测试文件清单:(列出所有路径)
  • 执行命令:(列出运行全部新增测试的命令)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.