route-research-for-testing — команда для Claude Code
Команда route-research-for-testing собирает список изменённых маршрутов в текущей сессии и запускает их тестирование через cURL. Помогает убедиться, что отредактированные API-эндпоинты работают правильно.
MIT ★ 10 055 обновлён 2026-07-13
.claude/commands/route-research-for-testing.mdЧто делает route-research-for-testing
Команда читает логи изменённых файлов в папке .claude/tsc-cache, фильтрует те, что содержат /routes/, объединяет их со списком дополнительных маршрутов, переданных пользователем, и удаляет дубликаты. Затем анализирует точку входа приложения (например, src/app.ts или src/server.ts), чтобы разрешить любые префиксы маршрутов.
Для каждого маршрута команда генерирует JSON-запись с путём, методом HTTP, ожидаемыми формами запроса и ответа, а также примерами валидных и невалидных данных. После этого запускает тестирование каждого маршрута через cURL: отправляет запрос с подходящим методом и телом, собирает статус-код и форму ответа, фиксирует ошибки.
Для работы нужен запущенный dev-сервер на локальном хосте. Команда требует знать порт, на котором слушает приложение — его нужно подставить в cURL-запросы или указать в конфигурации проекта.
Какие задачи решает
- собрать список изменённых маршрутов в текущей сессии
- объединить автоматический список маршрутов со списком, переданным пользователем
- протестировать API-эндпоинты через cURL с разными методами и данными
- собрать результаты тестов в единый отчёт
Примеры запросов агенту
- Протестируй все изменённые маршруты в приложении
- Протестируй маршруты из
/api/usersи/api/posts - Запусти route-research-for-testing с дополнительными путями
/custom/endpoint
Как установить route-research-for-testing
Вручную: положить файлы
.claude/commands/route-research-for-testing.mdВызов — /route-research-for-testing. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/route-research-for-testing.mdВызов — /prompts:route-research-for-testing. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/route-research-for-testing.prompt.mdВручную: положить файлы
.gemini/commands/route-research-for-testing.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о route-research-for-testing
Как установить команду route-research-for-testing в Claude Code?
Скопируй файл .claude/commands/route-research-for-testing.md из репозитория diet103/claude-code-infrastructure-showcase в папку .claude/commands твоего проекта.
Что делает команда route-research-for-testing?
Собирает список маршрутов, которые ты отредактировал в текущей сессии, и автоматически тестирует их через cURL. На выходе — отчёт с кодами ответов и обнаруженными ошибками.
Какие инструменты нужны для работы команды?
Команда использует cat, awk, grep, sort, xargs и sed. Убедись, что dev-сервер запущен на локальном хосте и известен его порт.
Исходный текст
route-research-for-testing.md · MIT
---
description: Map edited routes & launch tests
argument-hint: "[/extra/path …]"
allowed-tools: Bash(cat:*), Bash(awk:*), Bash(grep:*), Bash(sort:*), Bash(xargs:*), Bash(sed:*)
model: sonnet
---
## Context
Changed route files this session (auto-generated):
!cat "$CLAUDE_PROJECT_DIR/.claude/tsc-cache"/\*/edited-files.log \
| awk -F: '{print $2}' \
| grep '/routes/' \
| sort -u
User-specified additional routes: `$ARGUMENTS`
## Your task
Follow the numbered steps **exactly**:
1. Combine the auto list with `$ARGUMENTS`, dedupe, and resolve any prefixes
defined in your API entry point (e.g. `src/app.ts`, `src/server.ts`, or
wherever routes are registered).
2. For each final route, output a JSON record with the path, method, expected
request/response shapes, and valid + invalid payload examples.
3. **Now test each route** using cURL or your project's test script:
```bash
# For each route, test with appropriate method and payload
curl -X GET http://localhost:<YOUR_PORT>/api/route-path
curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' http://localhost:<YOUR_PORT>/api/route-path
```
Substitute `<YOUR_PORT>` with your project's actual dev server port.
Report results for each route: status code, response shape, and any errors found.
© diet103 · MIT · diet103/claude-code-infrastructure-showcase