跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

api-test-E10

当前 test-automation 项目内置的接口自动化编写 skill,物理位置 `.claude/skills/api-test-E10/`。用于在 `\test-automation\E10自动化\接口自动化测试` 中新增、维护、补齐、迁移接口测试方法与 pytest 用例。触发场景包括:新增接口方法、新增接口测试用例、参考 Java Controller 源码或 Jacoco 报告补齐未覆盖接口、维护已有接口方法与用例、补齐参数化、修复接口断言、按指定位置插入代码、按 URL 查重复实现、处理 UTF-8 中文编码、执行 pytest 并根据真实报错循环修复直到通过。运行时产物统一放在项目根 `api_test_dwp_temp/` 目录下。

buer2233 · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add buer2233/ai-api-test-skill --skill api-test-E10

技能说明


name: api-test-E10 description: 当前 test-automation 项目内置的接口自动化编写 skill,物理位置 .claude/skills/api-test-E10/。用于在 \test-automation\E10自动化\接口自动化测试 中新增、维护、补齐、迁移接口测试方法与 pytest 用例。触发场景包括:新增接口方法、新增接口测试用例、参考 Java Controller 源码或 Jacoco 报告补齐未覆盖接口、维护已有接口方法与用例、补齐参数化、修复接口断言、按指定位置插入代码、按 URL 查重复实现、处理 UTF-8 中文编码、执行 pytest 并根据真实报错循环修复直到通过。运行时产物统一放在项目根 api_test_dwp_temp/ 目录下。

api-test-E10

随 test-automation 项目一起分发的接口自动化编写 skill,把已验证有效的编写习惯、问题处理方式和交付格式沉淀为稳定流程。当前 skill 把“新增”和“维护”拆成两条独立上下文路径,项目根直接由 skill 在 <project>/.claude/skills/api-test-E10/ 的固定位置推导,运行时产物统一落在项目根的 api_test_dwp_temp/ 目录下。

适用范围

当任务涉及在 E10自动化/接口自动化测试/ 内新增或维护接口测试方法/pytest 用例时,优先使用本 skill。同样适用于按 URL 查重、处理中文编码/导入路径/登录态/返回结构差异、根据真实 pytest 报错循环修复等场景。

🚨 前置门禁(按新增 / 维护分流读取)

  • AI 必须先识别任务类型:新增接口方法/用例读取 @doc/preflight_gates_new.md;维护已有接口方法/用例读取 @doc/preflight_gates_maintenance.md
  • 若任务类型不明确,先询问“新增还是维护”;确认后再读取对应前置门禁文件并严格执行

任务类型分流

任何进入接口自动化编写/维护的任务,AI 必须先确认任务类型,再进入方式选择:

任务类型适用场景读取顺序
新增新接口、新用例、补齐新链路先读 doc/preflight_gates_new.md;门禁通过并选定方式后,再读 doc/coding_style_guide.md + 对应 doc/mode_*.md
维护既有用例修复、接口方法调整、链路回溯、参数/断言更新先读 doc/preflight_gates_maintenance.md;门禁通过并选定方式后,再读 doc/coding_style_guide.md + doc/maintenance_prompt_context.md + 对应 doc/mode_maintenance_*.md

若任务类型未明确,先询问“新增还是维护”;若用户已明确表达“维护 / 修复 / 同步最新链路 / 回归更新”等信号,可直接推断为维护。

用例编写/维护方式的执行流程

第三方依赖 Skill

维护方式④(pytest 报错驱动)依赖两个外部 Skill:

依赖 Skill使用时机
/test-fixing默认优先使用,用于根据 pytest 失败分组、定位根因、做最小补丁并循环验证
/Debugging仅在 /test-fixing 无法解决、维护遇到困难,或前后接口信息/调用栈/返回层级不明确时兜底使用;通过断点、执行堆栈、局部变量、请求 payload、接口响应和方法返回值辅助定位

强制按需读取门禁

进入任一种方式后,AI 必须先 Read 对应的方案文件,再继续编写接口方法或用例:

方式新增任务维护任务
① 抓包驱动doc/mode_capture_driven.mddoc/mode_maintenance_capture_driven.md
② 参考已有用例doc/mode_reference_case.mddoc/mode_maintenance_reference_case.md
③ cURL 手工doc/mode_curl_manual.mddoc/mode_maintenance_curl_manual.md
④ Java Controller 源码参考 / pytest 报错驱动doc/mode_java_controller_source.mddoc/mode_maintenance_pytest_driven.md
⑤ API-TPL 驱动(git-diff-analyse 一期)doc/mode_api_tpl.md—(维护仍用方式④,目标来自 coverage cases[])

硬性要求:

  • 编写任何接口方法或 pytest 用例前,必须先 Read doc/coding_style_guide.md
  • 若任务类型为维护,必须额外 Read doc/maintenance_prompt_context.md
  • 选定方式后,必须 Read 上表对应的 doc/mode_*.md,并按其中步骤执行
  • 需要排查历史高频问题时,按需 Read doc/high_frequency_experience.md
  • 不允许只凭 SKILL.md 的摘要执行具体方式的详细步骤

流程图

Mermaid 源文件与导出 PNG 见 flow_chart/ 目录,当前覆盖前置 hook、入口主流程、前置门禁、新增任务总览、新增四方式、维护任务总览、维护四方式和 pytest 闭环。

接口方法与用例编写规范

⚠️ 编写任何接口方法或用例代码前,AI 必须先 Read doc/coding_style_guide.md 并严格遵守其中所有规范。

该文件覆盖:接口方法结构/命名/payload/取值规则,用例结构/编排模式/参数化/断言风格,以及编写前必检清单(风格对齐、接口查重、编码校验)。

项目内规范锚点

编写接口自动化时,优先以以下文件为第一参考(风格模板,不是功能强绑定模板):

  • 抓包底座:capture/capture_addon.py
  • 索引与匹配工具:tools/scan_page_api.py / tools/match_captures.py / tools/analyze_java_controller.py / tools/check_capture_server.py(入口前置 tools/preflight_check.py 由 hook 自动执行,见前置 0)
  • 全局接口覆盖文档:tools/page_api_index.sqlite3 —— 全局 URL 索引,扫描或 AI 新增接口后需更新(纳入版本管理)
  • 运行时产物(项目根 api_test_dwp_temp/):latest.jsonl(抓包落盘) / capture_selection.md(勾选草稿) / java_sourceCode_analysisResult.md(Java Controller 源码分析草稿)

如果用户指定了别的参考文件或明确要求"参考当前位置上下文",则以用户要求为先。

必须遵守的核心原则

详见 doc/core_principles.md。

失败排查优先级

出现失败时,按以下顺序排查:

  1. 导入路径问题:ModuleNotFoundError / ImportError / No module named ...
  2. 编码问题:中文变成成片问号乱码 / 文件解析失败
  3. 装饰器误挂 / 插入位置错误
  4. fixture / 前置依赖问题
  5. 登录态 / token / 会话问题
  6. 接口真实返回与断言不匹配
  7. 接口 payload 结构不匹配:后端 SQL 报错、字段类型错误、列表/字符串结构不一致
  8. 接口方法返回层级误判:例如某些方法返回 response["data"],不是完整 response

排查后若确定为环境/网络/登录/会话问题(非代码问题),上报用户并明确说明。

历史踩坑详见 doc/high_frequency_experience.md(按需加载)。

输出结果模板

完成任务后建议按以下结构输出:

【新增/维护接口用例】(N个)
用例名: 中文说明

【新增/维护接口方法】(N个)
方法名: 中文说明

pytest 执行命令
...

关键日志
...

报错与修复过程
...

最终结果
...

默认返回要求

  • 默认必须返回新增/维护接口用例列表:新增/维护接口用例(N个) + 用例函数名:完整标题文本,标题文本优先取测试函数 docstring 或用户指定标题
  • 默认必须返回新增/维护接口方法列表:新增/维护接口方法(N个) + 方法名:完整标题文本;未新增也要明确返回 新增/维护接口方法(0个)
  • 默认必须返回 pytest 执行结果:至少包含执行命令、通过/失败统计、关键报错或修复说明
  • 仅当用户在当前对话中明确强调"不需要反馈新增数据列表"时,才可省略上述清单
  • 输出清单时默认不写文件位置、行号、路径,除非用户明确要求

当你在当前仓库里做接口自动化编写时,把本文件视为默认工作手册。