62 lines
4.2 KiB
Markdown
62 lines
4.2 KiB
Markdown
# ProxyWarden Agent Kit
|
||
|
||
Этот каталог содержит инструкции для кодовых агентов, которые работают с ProxyWarden.
|
||
|
||
Главный файл — `AGENTS.md` в корне репозитория. Он задает инварианты и общие правила. Файлы в `.agent/skills` описывают конкретные режимы работы: backend, UI, security, Windows services, subscriptions/routing, testing/release и понятные отчеты.
|
||
|
||
## Как использовать
|
||
|
||
1. Прочитать корневой `AGENTS.md`.
|
||
2. Выбрать skill под задачу.
|
||
3. Перед изменением проверить релевантные чек-листы из `.agent/checklists`.
|
||
4. После изменения выполнить минимальные проверки.
|
||
5. Для любого нетривиального ответа использовать `communication-reporting`: коротко, по файлам, с проверками и рисками.
|
||
6. В финальном отчете явно указать, что было и не было проверено.
|
||
|
||
## Как агент должен писать ответы
|
||
|
||
По умолчанию агент пишет не техническую простыню, а короткий отчет:
|
||
|
||
```text
|
||
Коротко
|
||
Что изменилось по файлам
|
||
Важные места
|
||
Проверено
|
||
Не проверено
|
||
Риски
|
||
```
|
||
|
||
Для 2+ файлов желательно использовать таблицу `Файл / Что изменилось / Зачем`. В ответе должны быть конкретные пути файлов и человеческая причина изменения. Не надо пересказывать каждую строку diff, если пользователь не попросил.
|
||
|
||
Подробные правила лежат в `.agent/skills/communication-reporting/SKILL.md`, чек-лист — в `.agent/checklists/communication.md`. Да, это нужно отдельно прописывать, иначе агент опять напишет роман о своем внутреннем мире и двух переименованных переменных.
|
||
|
||
## Skill index
|
||
|
||
- `repository-orientation` — вход в проект, карта файлов, где искать source of truth.
|
||
- `rust-tauri-backend` — Tauri commands, Rust models, validation, storage, adapters.
|
||
- `react-typescript-ui` — React UI, typed invoke facade, readiness, components.
|
||
- `security-hardening` — CSP, секреты, elevated boundary, storage corruption, SSRF.
|
||
- `windows-services-powershell` — scripts, UAC, services, ProxiFyre/sing-box operations.
|
||
- `subscriptions-routing` — external SOCKS5, sing-box subscriptions, config generation, ping.
|
||
- `testing-ci-release` — build/test matrix, CI recommendations, release hygiene.
|
||
- `communication-reporting` — короткие планы, понятные сводки по файлам, отчеты без текстовой каши.
|
||
|
||
## Communication defaults
|
||
|
||
Перед длинным ответом или отчетом использовать:
|
||
|
||
- `.agent/skills/communication-reporting/SKILL.md`
|
||
- `.agent/checklists/communication.md`
|
||
- `.agent/checklists/explanation-quality.md`
|
||
- `.agent/templates/change-report.md` или `.agent/templates/user-facing-summary.md`
|
||
- `.agent/templates/file-impact-map.md`, если надо заранее показать, какие файлы будут затронуты
|
||
|
||
Главная идея: сначала короткая сводка, потом таблица файлов, потом проверки и риски. Не наоборот, потому что пользователь не обязан добывать смысл киркой.
|
||
|
||
## Что не является целью
|
||
|
||
- Перевод проекта в SaaS/gateway/server.
|
||
- Добавление облачного backend.
|
||
- Замена ProxiFyre без отдельной архитектурной задачи.
|
||
- Коммерциализация, telemetry-first подход или рекламная шелуха, этот вид пластика уже и так в океане.
|