awesome-cursor-subagents/README.md
stud_i_sram b6c482a353 Mark analysis-only subagents as readonly and document the mapping.
Replace Claude Code tools allowlists with Cursor's readonly flag for 38 reviewer/auditor/researcher-style agents; update README accordingly.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-28 15:53:52 +03:00

351 lines
26 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Awesome Cursor Subagents
Коллекция **154+ специализированных subagents для Cursor** — адаптированная версия базы [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) под формат и пути Cursor.
После установки агенты доступны **во всех ваших проектах**: Cursor может вызывать их автоматически по `description` или по явному запросу (`/code-reviewer …`, «use the security-auditor subagent»).
> **Источник:** содержимое агентов основано на [awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) (MIT, © VoltAgent). Адаптировано под Cursor: frontmatter, пути установки, инструкции.
---
## Установка
### Установить всех агентов глобально (рекомендуется)
Так агенты появятся сразу **для всех проектов Cursor**.
#### macOS / Linux (и WSL / Git Bash)
```bash
git clone https://git.studisram.ru/studisram/awesome-cursor-subagents.git
cd awesome-cursor-subagents
chmod +x install-agents.sh
./install-agents.sh --all
```
Агенты копируются в `~/.cursor/agents/`.
#### Windows (PowerShell)
```powershell
git clone https://git.studisram.ru/studisram/awesome-cursor-subagents.git
cd awesome-cursor-subagents
.\install-agents.ps1 -All
```
Агенты копируются в `%USERPROFILE%\.cursor\agents\`.
После установки **перезапустите Cursor** (или откройте новое Agent-окно), чтобы агенты подхватились.
### Другие варианты установки
| Способ | Команда | Куда ставит |
|---|---|---|
| Все агенты глобально | `./install-agents.sh --all` / `.\install-agents.ps1 -All` | `~/.cursor/agents/` |
| Интерактивно (выбор категорий) | `./install-agents.sh` / `.\install-agents.ps1` | глобально или в текущий проект |
| Только одна категория | `./install-agents.sh --category 04-quality-security` | `~/.cursor/agents/` |
| В текущий проект | `./install-agents.sh --all --local` | `.cursor/agents/` |
#### Ручная установка
```bash
# Глобально (все проекты)
mkdir -p ~/.cursor/agents
cp categories/*/*.md ~/.cursor/agents/
# README категорий копировать не нужно — скрипт их пропускает
# Или только нужные файлы
cp categories/04-quality-security/code-reviewer.md ~/.cursor/agents/
```
Windows (PowerShell):
```powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor\agents" | Out-Null
Copy-Item -Path .\categories\*\*.md -Destination "$env:USERPROFILE\.cursor\agents\" -Exclude README.md
```
### Совместимость скриптов
| ОС | Скрипт |
|---|---|
| macOS, Linux | `install-agents.sh` |
| Windows | `install-agents.ps1` (нативный PowerShell) |
| Windows + WSL / Git Bash | можно использовать `install-agents.sh` |
---
## Как это работает в Cursor
Cursor поддерживает **custom subagents** — markdown-файлы с YAML frontmatter:
```markdown
---
name: code-reviewer
description: "…"
model: inherit
readonly: true # только для аналитических агентов
---
Инструкции агента…
```
| Расположение | Область |
|---|---|
| `~/.cursor/agents/` | Пользователь — **все проекты** |
| `.cursor/agents/` | Только текущий репозиторий |
**Вызов:**
- автоматически — parent-агент выбирает subagent по `description`;
- явно — `/имя-агента …` или фраза вроде «use the code-reviewer subagent».
Подробнее: [документация Cursor — Subagents](https://cursor.com/docs/subagents.md).
### Права доступа (`readonly`)
В Claude Code у агентов был список `tools:` (Read / Write / Edit / Bash …). В Cursor **такого поля нет** — вместо него флаг:
| Поле | Значение | Эффект |
|---|---|---|
| `readonly: true` | только анализ | нельзя править файлы и запускать shell-команды, меняющие состояние |
| нет / `false` | полный доступ | наследует tools родителя, включая запись |
В этой коллекции **`readonly: true` проставлен 38 аналитическим агентам** (reviewer, auditor, researcher, PM/BA и т.п.). Пишущие агенты (developers, engineers, fixers) оставлены без ограничений.
В каталоге ниже они помечены 🔒.
---
## Категории и агенты
🔒 = агент с `readonly: true` (только анализ, без правок файлов).
### [01. Core Development](categories/01-core-development/)
**Базовая разработка.** Повседневные задачи: backend, frontend, fullstack, mobile, API.
- [**api-designer**](categories/01-core-development/api-designer.md) — REST and GraphQL API architect
- [**backend-developer**](categories/01-core-development/backend-developer.md) — Server-side expert for scalable APIs
- [**design-bridge**](categories/01-core-development/design-bridge.md) — Design-to-agent translator
- [**electron-pro**](categories/01-core-development/electron-pro.md) — Desktop application expert
- [**frontend-developer**](categories/01-core-development/frontend-developer.md) — UI/UX specialist for React, Vue, and Angular
- [**fullstack-developer**](categories/01-core-development/fullstack-developer.md) — End-to-end feature development
- [**graphql-architect**](categories/01-core-development/graphql-architect.md) — GraphQL schema and federation expert
- [**microservices-architect**](categories/01-core-development/microservices-architect.md) — Distributed systems designer
- [**mobile-developer**](categories/01-core-development/mobile-developer.md) — Cross-platform mobile specialist
- [**ui-designer**](categories/01-core-development/ui-designer.md) — Visual design and interaction specialist
- [**websocket-engineer**](categories/01-core-development/websocket-engineer.md) — Real-time communication specialist
### [02. Language Specialists](categories/02-language-specialists/)
**Языковые специалисты.** Эксперты по языкам и фреймворкам.
- [**angular-architect**](categories/02-language-specialists/angular-architect.md) — Angular 15+ enterprise patterns expert
- [**cpp-pro**](categories/02-language-specialists/cpp-pro.md) — C++ performance expert
- [**csharp-developer**](categories/02-language-specialists/csharp-developer.md) — .NET ecosystem specialist
- [**django-developer**](categories/02-language-specialists/django-developer.md) — Django 4+ web development expert
- [**dotnet-core-expert**](categories/02-language-specialists/dotnet-core-expert.md) — .NET 8 cross-platform specialist
- [**dotnet-framework-4.8-expert**](categories/02-language-specialists/dotnet-framework-4.8-expert.md) — .NET Framework legacy enterprise specialist
- [**elixir-expert**](categories/02-language-specialists/elixir-expert.md) — Elixir and OTP fault-tolerant systems expert
- [**expo-react-native-expert**](categories/02-language-specialists/expo-react-native-expert.md) — Expo and React Native mobile development expert
- [**fastapi-developer**](categories/02-language-specialists/fastapi-developer.md) — Modern async Python API framework expert
- [**flutter-expert**](categories/02-language-specialists/flutter-expert.md) — Flutter 3+ cross-platform mobile expert
- [**golang-pro**](categories/02-language-specialists/golang-pro.md) — Go concurrency specialist
- [**java-architect**](categories/02-language-specialists/java-architect.md) — Enterprise Java expert
- [**javascript-pro**](categories/02-language-specialists/javascript-pro.md) — JavaScript development expert
- [**kotlin-specialist**](categories/02-language-specialists/kotlin-specialist.md) — Modern JVM language expert
- [**laravel-specialist**](categories/02-language-specialists/laravel-specialist.md) — Laravel 10+ PHP framework expert
- [**nextjs-developer**](categories/02-language-specialists/nextjs-developer.md) — Next.js 14+ full-stack specialist
- [**node-specialist**](categories/02-language-specialists/node-specialist.md) — Node.js specialist
- [**php-pro**](categories/02-language-specialists/php-pro.md) — PHP web development expert
- [**powershell-5.1-expert**](categories/02-language-specialists/powershell-5.1-expert.md) — Windows PowerShell 5.1 and full .NET Framework automation specialist
- [**powershell-7-expert**](categories/02-language-specialists/powershell-7-expert.md) — Cross-platform PowerShell 7+ automation and modern .NET specialist
- [**python-pro**](categories/02-language-specialists/python-pro.md) — Python ecosystem master
- [**rails-expert**](categories/02-language-specialists/rails-expert.md) — Rails 8.1 rapid development expert
- [**react-specialist**](categories/02-language-specialists/react-specialist.md) — React 18+ modern patterns expert
- [**rust-engineer**](categories/02-language-specialists/rust-engineer.md) — Systems programming expert
- [**spring-boot-engineer**](categories/02-language-specialists/spring-boot-engineer.md) — Spring Boot 3+ microservices expert
- [**sql-pro**](categories/02-language-specialists/sql-pro.md) — Database query expert
- [**swift-expert**](categories/02-language-specialists/swift-expert.md) — iOS and macOS specialist
- [**symfony-specialist**](categories/02-language-specialists/symfony-specialist.md) — Symfony 6+/7+/8+ PHP framework and Doctrine ORM expert
- [**typescript-pro**](categories/02-language-specialists/typescript-pro.md) — TypeScript specialist
- [**vue-expert**](categories/02-language-specialists/vue-expert.md) — Vue 3 Composition API expert
### [03. Infrastructure](categories/03-infrastructure/)
**Инфраструктура.** DevOps, облако, деплой, IaC.
- [**azure-infra-engineer**](categories/03-infrastructure/azure-infra-engineer.md) — Azure infrastructure and Az PowerShell automation expert
- [**cloud-architect**](categories/03-infrastructure/cloud-architect.md) — AWS/GCP/Azure specialist
- [**database-administrator**](categories/03-infrastructure/database-administrator.md) — Database management expert
- [**deployment-engineer**](categories/03-infrastructure/deployment-engineer.md) — Deployment automation specialist
- [**devops-engineer**](categories/03-infrastructure/devops-engineer.md) — CI/CD and automation expert
- [**devops-incident-responder**](categories/03-infrastructure/devops-incident-responder.md) — DevOps incident management
- [**docker-expert**](categories/03-infrastructure/docker-expert.md) — Docker containerization and optimization expert
- [**incident-responder**](categories/03-infrastructure/incident-responder.md) — System incident response expert
- [**kubernetes-specialist**](categories/03-infrastructure/kubernetes-specialist.md) — Container orchestration master
- [**network-engineer**](categories/03-infrastructure/network-engineer.md) — Network infrastructure specialist
- [**platform-engineer**](categories/03-infrastructure/platform-engineer.md) — Platform architecture expert
- [**security-engineer**](categories/03-infrastructure/security-engineer.md) — Infrastructure security specialist
- [**sre-engineer**](categories/03-infrastructure/sre-engineer.md) — Site reliability engineering expert
- [**terraform-engineer**](categories/03-infrastructure/terraform-engineer.md) — Infrastructure as Code expert
- [**terragrunt-expert**](categories/03-infrastructure/terragrunt-expert.md) — Terragrunt orchestration and DRY IaC specialist
- [**windows-infra-admin**](categories/03-infrastructure/windows-infra-admin.md) — Active Directory, DNS, DHCP, and GPO automation specialist
### [04. Quality & Security](categories/04-quality-security/)
**Качество и безопасность.** Тестирование, security, code review.
- [**accessibility-tester**](categories/04-quality-security/accessibility-tester.md) — 🔒 A11y compliance expert
- [**ad-security-reviewer**](categories/04-quality-security/ad-security-reviewer.md) — 🔒 Active Directory security and GPO audit specialist
- [**ai-writing-auditor**](categories/04-quality-security/ai-writing-auditor.md) — 🔒 AI writing pattern detector and rewriter
- [**architect-reviewer**](categories/04-quality-security/architect-reviewer.md) — 🔒 Architecture review specialist
- [**chaos-engineer**](categories/04-quality-security/chaos-engineer.md) — System resilience testing expert
- [**code-reviewer**](categories/04-quality-security/code-reviewer.md) — 🔒 Code quality guardian
- [**compliance-auditor**](categories/04-quality-security/compliance-auditor.md) — 🔒 Regulatory compliance expert
- [**debugger**](categories/04-quality-security/debugger.md) — Advanced debugging specialist
- [**error-detective**](categories/04-quality-security/error-detective.md) — 🔒 Error analysis and resolution expert
- [**gdpr-ccpa-compliance**](categories/04-quality-security/gdpr-ccpa-compliance.md) — 🔒 GDPR and CCPA privacy compliance specialist
- [**penetration-tester**](categories/04-quality-security/penetration-tester.md) — Ethical hacking specialist
- [**performance-engineer**](categories/04-quality-security/performance-engineer.md) — Performance optimization expert
- [**powershell-security-hardening**](categories/04-quality-security/powershell-security-hardening.md) — PowerShell security hardening and compliance specialist
- [**qa-expert**](categories/04-quality-security/qa-expert.md) — Test automation specialist
- [**security-auditor**](categories/04-quality-security/security-auditor.md) — 🔒 Security vulnerability expert
- [**test-automator**](categories/04-quality-security/test-automator.md) — Test automation framework expert
- [**ui-ux-tester**](categories/04-quality-security/ui-ux-tester.md) — Exhaustive documented-flow UI tester
### [05. Data & AI](categories/05-data-ai/)
**Данные и ИИ.** Data engineering, ML, LLM.
- [**ai-engineer**](categories/05-data-ai/ai-engineer.md) — AI system design and deployment expert
- [**data-analyst**](categories/05-data-ai/data-analyst.md) — 🔒 Data insights and visualization specialist
- [**data-engineer**](categories/05-data-ai/data-engineer.md) — Data pipeline architect
- [**data-scientist**](categories/05-data-ai/data-scientist.md) — 🔒 Analytics and insights expert
- [**database-optimizer**](categories/05-data-ai/database-optimizer.md) — Database performance specialist
- [**llm-architect**](categories/05-data-ai/llm-architect.md) — Large language model architect
- [**machine-learning-engineer**](categories/05-data-ai/machine-learning-engineer.md) — Machine learning systems expert
- [**ml-engineer**](categories/05-data-ai/ml-engineer.md) — Machine learning specialist
- [**mlops-engineer**](categories/05-data-ai/mlops-engineer.md) — MLOps and model deployment expert
- [**nlp-engineer**](categories/05-data-ai/nlp-engineer.md) — Natural language processing expert
- [**postgres-pro**](categories/05-data-ai/postgres-pro.md) — PostgreSQL database expert
- [**prompt-engineer**](categories/05-data-ai/prompt-engineer.md) — Prompt optimization specialist
- [**reinforcement-learning-engineer**](categories/05-data-ai/reinforcement-learning-engineer.md) — Reinforcement learning and agent training expert
### [06. Developer Experience](categories/06-developer-experience/)
**Developer Experience.** Инструменты, DX, документация, рефакторинг.
- [**build-engineer**](categories/06-developer-experience/build-engineer.md) — Build system specialist
- [**cli-developer**](categories/06-developer-experience/cli-developer.md) — Command-line tool creator
- [**dependency-manager**](categories/06-developer-experience/dependency-manager.md) — Package and dependency specialist
- [**documentation-engineer**](categories/06-developer-experience/documentation-engineer.md) — Technical documentation expert
- [**dx-optimizer**](categories/06-developer-experience/dx-optimizer.md) — Developer experience optimization specialist
- [**git-workflow-manager**](categories/06-developer-experience/git-workflow-manager.md) — Git workflow and branching expert
- [**legacy-modernizer**](categories/06-developer-experience/legacy-modernizer.md) — Legacy code modernization specialist
- [**mcp-developer**](categories/06-developer-experience/mcp-developer.md) — Model Context Protocol specialist
- [**powershell-module-architect**](categories/06-developer-experience/powershell-module-architect.md) — PowerShell module and profile architecture specialist
- [**powershell-ui-architect**](categories/06-developer-experience/powershell-ui-architect.md) — PowerShell UI/UX specialist for WinForms, WPF, Metro frameworks, and TUIs
- [**readme-generator**](categories/06-developer-experience/readme-generator.md) — Repository README generation specialist
- [**refactoring-specialist**](categories/06-developer-experience/refactoring-specialist.md) — Code refactoring expert
- [**slack-expert**](categories/06-developer-experience/slack-expert.md) — Slack platform and @slack/bolt specialist
- [**tooling-engineer**](categories/06-developer-experience/tooling-engineer.md) — Developer tooling specialist
- [**visual-asset-generator**](categories/06-developer-experience/visual-asset-generator.md) — Visual asset generation specialist using prompt-to-asset MCP across 30+ image models
### [07. Specialized Domains](categories/07-specialized-domains/)
**Специализированные домены.** Fintech, IoT, blockchain, SEO и др.
- [**api-documenter**](categories/07-specialized-domains/api-documenter.md) — API documentation specialist
- [**blockchain-developer**](categories/07-specialized-domains/blockchain-developer.md) — Web3 and crypto specialist
- [**embedded-systems**](categories/07-specialized-domains/embedded-systems.md) — Embedded and real-time systems expert
- [**fintech-engineer**](categories/07-specialized-domains/fintech-engineer.md) — Financial technology specialist
- [**game-developer**](categories/07-specialized-domains/game-developer.md) — Game development expert
- [**healthcare-admin**](categories/07-specialized-domains/healthcare-admin.md) — Healthcare administration specialist with 51 sub-agents covering revenue cycle, compliance, quality, clinical ops, health IT, and payer relations
- [**hipaa-compliance**](categories/07-specialized-domains/hipaa-compliance.md) — 🔒 HIPAA compliance specialist for healthcare SaaS vendors
- [**iot-engineer**](categories/07-specialized-domains/iot-engineer.md) — IoT systems developer
- [**m365-admin**](categories/07-specialized-domains/m365-admin.md) — Microsoft 365, Exchange Online, Teams, and SharePoint administration specialist
- [**mobile-app-developer**](categories/07-specialized-domains/mobile-app-developer.md) — Mobile application specialist
- [**payment-integration**](categories/07-specialized-domains/payment-integration.md) — Payment systems expert
- [**quant-analyst**](categories/07-specialized-domains/quant-analyst.md) — 🔒 Quantitative analysis specialist
- [**risk-manager**](categories/07-specialized-domains/risk-manager.md) — 🔒 Risk assessment and management expert
- [**seo-specialist**](categories/07-specialized-domains/seo-specialist.md) — Search engine optimization expert
### [08. Business & Product](categories/08-business-product/)
**Бизнес и продукт.** PM, аналитика, контент, Agile.
- [**assumption-mapping**](categories/08-business-product/assumption-mapping.md) — 🔒 Product assumption risk and validation specialist
- [**backlog-grooming**](categories/08-business-product/backlog-grooming.md) — 🔒 Agile backlog refinement specialist
- [**business-analyst**](categories/08-business-product/business-analyst.md) — 🔒 Requirements specialist
- [**content-marketer**](categories/08-business-product/content-marketer.md) — Content marketing specialist
- [**content-quality-editor**](categories/08-business-product/content-quality-editor.md) — AI content quality specialist using unslop to strip AI writing patterns before publishing
- [**customer-success-manager**](categories/08-business-product/customer-success-manager.md) — 🔒 Customer success expert
- [**growth-loops**](categories/08-business-product/growth-loops.md) — 🔒 Growth loop and PLG mechanics specialist
- [**legal-advisor**](categories/08-business-product/legal-advisor.md) — 🔒 Legal and compliance specialist
- [**license-engineer**](categories/08-business-product/license-engineer.md) — Software licensing and compliance systems specialist
- [**product-manager**](categories/08-business-product/product-manager.md) — 🔒 Product strategy expert
- [**project-manager**](categories/08-business-product/project-manager.md) — 🔒 Project management specialist
- [**sales-engineer**](categories/08-business-product/sales-engineer.md) — Technical sales expert
- [**scrum-master**](categories/08-business-product/scrum-master.md) — 🔒 Agile methodology expert
- [**technical-writer**](categories/08-business-product/technical-writer.md) — Technical documentation specialist
- [**ux-researcher**](categories/08-business-product/ux-researcher.md) — 🔒 User research expert
- [**wordpress-master**](categories/08-business-product/wordpress-master.md) — WordPress development and optimization expert
### [09. Meta & Orchestration](categories/09-meta-orchestration/)
**Мета и оркестрация.** Координация агентов и сложные workflow.
- [**agent-installer**](categories/09-meta-orchestration/agent-installer.md) — Browse and install agents from this repository via GitHub
- [**agent-organizer**](categories/09-meta-orchestration/agent-organizer.md) — Multi-agent coordinator
- [**codebase-orchestrator**](categories/09-meta-orchestration/codebase-orchestrator.md) — Safe refactor governance orchestrator
- [**context-manager**](categories/09-meta-orchestration/context-manager.md) — 🔒 Context optimization expert
- [**error-coordinator**](categories/09-meta-orchestration/error-coordinator.md) — Error handling and recovery specialist
- [**it-ops-orchestrator**](categories/09-meta-orchestration/it-ops-orchestrator.md) — IT operations workflow orchestration specialist
- [**knowledge-synthesizer**](categories/09-meta-orchestration/knowledge-synthesizer.md) — 🔒 Knowledge aggregation expert
- [**multi-agent-coordinator**](categories/09-meta-orchestration/multi-agent-coordinator.md) — Advanced multi-agent orchestration
- [**performance-monitor**](categories/09-meta-orchestration/performance-monitor.md) — 🔒 Agent performance optimization
- [**task-distributor**](categories/09-meta-orchestration/task-distributor.md) — Task allocation specialist
- [**workflow-orchestrator**](categories/09-meta-orchestration/workflow-orchestrator.md) — Complex workflow automation
### [10. Research & Analysis](categories/10-research-analysis/)
**Исследования и анализ.** Research, market, competitive analysis.
- [**ab-test-analysis**](categories/10-research-analysis/ab-test-analysis.md) — 🔒 A/B test analysis and ship/no-ship decision specialist
- [**cohort-analysis**](categories/10-research-analysis/cohort-analysis.md) — 🔒 User cohort retention and behavioral analysis specialist
- [**competitive-analyst**](categories/10-research-analysis/competitive-analyst.md) — 🔒 Competitive intelligence specialist
- [**data-researcher**](categories/10-research-analysis/data-researcher.md) — 🔒 Data discovery and analysis expert
- [**first-principles-thinking**](categories/10-research-analysis/first-principles-thinking.md) — 🔒 First principles problem-solving specialist
- [**market-researcher**](categories/10-research-analysis/market-researcher.md) — 🔒 Market analysis and consumer insights
- [**project-idea-validator**](categories/10-research-analysis/project-idea-validator.md) — 🔒 Brutal go/no-go product idea validator
- [**research-analyst**](categories/10-research-analysis/research-analyst.md) — 🔒 Comprehensive research specialist
- [**scientific-literature-researcher**](categories/10-research-analysis/scientific-literature-researcher.md) — 🔒 Scientific paper search and evidence synthesis via [BGPT MCP](https://github.com/connerlambden/bgpt-mcp)
- [**search-specialist**](categories/10-research-analysis/search-specialist.md) — 🔒 Advanced information retrieval expert
- [**trend-analyst**](categories/10-research-analysis/trend-analyst.md) — 🔒 Emerging trends and forecasting expert
---
## Что изменено относительно оригинала (Claude Code)
- Путь установки: `~/.claude/agents/``~/.cursor/agents/`
- Frontmatter: `name`, `description`, `model: inherit`; Claude-only `tools` заменён на Cursor-флаг `readonly: true` для аналитических агентов
- Модели `sonnet` / `haiku` / `opus` заменены на `inherit` (наследует модель родительского агента Cursor)
- Тексты инструкций агентов сохранены на **английском**; этот README — на **русском**
- `agent-installer` обновлён под этот репозиторий и пути Cursor
---
## Удаление
```bash
# macOS / Linux — удалить всех установленных из этого набора
./install-agents.sh --uninstall-all
# или вручную
rm -rf ~/.cursor/agents
```
```powershell
# Windows
.\install-agents.ps1 -UninstallAll
```
---
## Лицензия
MIT. Исходная коллекция — [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents). Адаптация под Cursor — репозиторий [awesome-cursor-subagents](https://git.studisram.ru/studisram/awesome-cursor-subagents).