ai-api-test-skill
Скилл ведет Claude Code и Codex через пишущий и чинящий цикл автотестов API на pytest с проверкой реальным запуском.
- 172 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Для захвата трафика ставится прокси mitmproxy с сертификатом, он расшифровывает HTTPS на машине.
- Агент меняет файлы тестов и запускает `pytest` с реальными запросами к серверу.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ai-api-test-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Для захвата трафика ставится прокси mitmproxy с сертификатом, он расшифровывает HTTPS на машине.
- Агент меняет файлы тестов и запускает `pytest` с реальными запросами к серверу.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл для проектов на Python, pytest и requests. Перед правкой агент требует заполнить шаблон: файл и место метода API, файл и место теста, имя случая. Это ограничивает область изменений. Дальше агент выбирает путь: перехват трафика через mitmproxy, существующий тест как образец, команда cURL, исходник Java-контроллера или ошибка pytest. Индекс SQLite хранит адреса и методы API, так что агент находит нужную функцию без массового `grep`. Скилл завершается запуском целевого pytest и правкой по реальным ошибкам.
Для кого. QA-инженерам на крупных проектах без нормальной документации API, где тестов много, а цепочки запросов сложные.
Подходит, если
- Нужно добавить тест на новый эндпоинт по реальному трафику интерфейса.
- Серию похожих тестов размножают по готовому образцу с другими параметрами.
- Упавший `pytest` отдают агенту на починку с возвратом к запуску.
- В проекте надо быстро найти, где уже описан метод для данного URL.
Не подходит, если
- Проект написан на другом стеке, и шаблон под него не подготовлен.
- Нужны интерфейсные UI-тесты, а не тесты API.
- Трафик нельзя перехватывать прокси из-за политики безопасности.
Пример запроса к агенту
Я хочу добавить автотест на новый API. Запроси данные шаблона и построй тест по перехваченному трафику.Ограничения
Автор ориентируется на Windows 10 и 11 и Python 3.8 или новее, скрипты запуска захвата даны как `.bat`. Для перехвата трафика нужен `mitmproxy` и установка его сертификата, что открывает расшифровку вашего HTTPS-трафика на этой машине. В первый раз надо заполнить `config.json`: пути проекта, каталоги методов и тестов. README и документация на китайском, есть краткая английская версия. Примеры построены на проекте автора и требуют адаптации.
Как отключить. Удалите папку скилла из `.claude/skills/` проекта, остановите `capture/stop.bat` и уберите сертификат mitmproxy из системного хранилища.
Частые вопросы
Как проверить, что скилл сработал?
Напишите «Я хочу добавить автотест на интерфейс». Если агент не прислал шаблон с полями для файла метода, файла теста и имени случая, скилл не подключился.
Зачем нужен предварительный шаблон?
Он называет файлы и места правок, поэтому агент не переписывает чужие тесты и не дублирует уже описанные методы.
Как работает индекс SQLite?
Первая команда `python tools/scan_page_api.py --full` собирает URL и методы из проекта, затем `python tools/scan_page_api.py` дополняет базу. Агент ищет функции по ней.
Какие дополнительные скиллы рекомендуются?
`/test-fixing` для починки pytest и `/Debugging` для отладки Python. Команды установки через `npx skills add` приведены в README.
Подходит ли скилл для unittest или httpx?
По умолчанию вывод идет в стиле `pytest`. Автор советует адаптировать `doc/coding_style_guide.md`, шаблоны и гейты под `unittest`, `httpx` или `aiohttp`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл и агент-тестировщик для Claude Code: проверяют интерфейс 1С через MCP-сервер 1c-testpilot с доказательствами
CLI для оценки и доработки скиллов агентов: декларативные тесты в YAML, запуск на разных движках и структурированные отчеты
Caliper прогоняет задачи агента с вашим скиллом и без него и показывает, помогает ли скилл и сколько токенов он стоит
Swift Testing Agent Skill
swift-testing-agent-skill
Скилл по Swift Testing от Антуана ван дер Ли: новые API, миграция с XCTest, параметризованные тесты и плоские тесты. Для Claude Code и других агентов
Скилл помогает агенту настроить Dev Proxy для проверки ошибок API, ограничений запросов и задержек в тестируемом приложении.
Семь QA-агентов и десять скиллов для автотестов: Playwright на TypeScript, Selenium на Java, API, доступность и ISTQB.
Коротко о README
В README описаны особенности скилла, подготовка окружения, формы задач для новых и существующих тестов и режимы работы с таблицей выбора. Подробное руководство вынесено в `detailedUserManual.md`, схема процесса в `flow_chart/flow.md`.
Бейдж для README
Исходный SKILL.md
--- 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 对应的方案文件**，再继续编写接口方法或用例： | 方式 | 新增任务 | 维护任务 |