К основному содержанию
плагин

devteam — плагин для Claude Code: 12 субагентов и 15 хуков

Плагин devteam разворачивает в Claude команду из 12 субагентов и 15 хуков: планировщик, ревьюер, отладчик, защита коммитов и учёт токенов.

MIT ★ 267 обновлён 2026-04-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add NYCU-Chung/my-claude-devteam
/plugin install devteam@my-claude-devteam
Открыть на GitHub

Что делает devteam

Плагин собирает из Claude что-то вроде инженерного отдела. Двенадцать субагентов с разными ролями: planner режет задачу на параллельные подзадачи, fullstack-engineer пишет код, critic ищет баги и указывает путь с номером строки, vuln-verifier пишет PoC-тест на найденную уязвимость. Остальные закрывают отладку, схемы БД, рефакторинг, миграции, вёрстку, разбор чужого репозитория и работу с MCP-инструментами.

Поверх агентов работают 15 хуков на событиях pre-commit, post-tool-use и stop: проверка секретов перед коммитом, защита ветки и конфигов, прогон тестов, предупреждение о больших файлах. cost-tracker.js считает расход токенов по моделям и держит накопленный итог в ~/.claude/stats-cache.json.

Методика P7/P9/P10 переключает режим по объёму задачи. Одна фича идёт по P7, три и более файлов по P9, где агент выдаёт промпты вместо кода. Роли лежат markdown-файлами в agents/ со своим системным промптом и правами на инструменты, поэтому ненужные придётся вычищать вручную: ставятся все двенадцать сразу.

Какие задачи решает

  • разложить задачу на параллельные подзадачи до начала кода
  • доказать уязвимость тестом, а не описанием
  • провести переименование или вынос модуля атомарными коммитами
  • перевести проект на мажорную версию библиотеки по шагам
  • посмотреть расход токенов по моделям за сессию

Примеры запросов агенту

  • Позови planner и разбей этот тикет на параллельные подзадачи.
  • Отдай дифф critic, пусть вернёт находки с путями и номерами строк.
  • Пусть vuln-verifier напишет PoC на то, что нашло ревью.

Как установить devteam

Через маркетплейс плагинов

/plugin marketplace add NYCU-Chung/my-claude-devteam
/plugin install devteam@my-claude-devteam

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о devteam

Как установить devteam в Claude Code?

Сначала добавьте маркетплейс: /plugin marketplace add NYCU-Chung/my-claude-devteam. Затем поставьте сам плагин: /plugin install devteam@my-claude-devteam.

Что делает devteam?

Ставит 12 субагентов с ролями от планировщика до пентестера и 15 хуков на коммиты, тесты и расход токенов. Работой агентов управляют режимы P7/P9/P10 и три правила дисциплины.

Чем critic отличается от vuln-verifier?

critic ищет баги, логические ошибки и дыры в безопасности, каждый пункт с файлом и номером строки. vuln-verifier берёт его находки и пишет PoC-тест, который подтверждает, что уязвимость настоящая.

Исходный текст

SKILL.md · MIT
# Claude Code Dev Team

**English · [繁體中文](./README.zh-TW.md)**

> **An entire engineering team for Claude Code**
> — 12 specialized agents, 15 automation hooks, and the P7/P9/P10 methodology that keeps them disciplined.

Most people use Claude Code as a single coder. This config turns it into a full engineering org: **planner, fullstack-engineer, refactor-specialist, migration-engineer, frontend-designer, critic, vuln-verifier, debugger, db-expert, onboarder, tool-expert, web-researcher** — each agent owns a role, each has its own tool permissions, and a strict delegation rulebook decides who touches what.

Backed by **corporate-culture-inspired discipline** (closure, fact-driven, exhaustiveness) and **battle-tested hooks** that catch debugger statements, hardcoded secrets, cost overruns, and MCP outages before they hit main.

---

## The Team

| Role | Agent | What they do | When they ship |
|------|-------|--------------|---------------|
| 📋 **Tech Lead** | `planner` | Breaks down fuzzy requirements into parallelizable Task Prompts with a six-element contract (goal / scope / input / output / acceptance / boundaries). Never writes code. | Task touches 3+ files or 2+ modules |
| 🛠 **Senior Engineer** | `fullstack-engineer` | Ships features using the P7 methodology: read reality → design solution → impact analysis → implement → three-question self-review → `[P7-COMPLETION]` delivery. | Single-feature or cross-module implementation |
| 🔄 **Refactor Lead** | `refactor-specialist` | Large-scale safe refactors. Atomic commits, full callsite verification, single-revert rollback. | Renames, file moves, module extraction across 10+ files |
| 🚀 **Migration Lead** | `migration-engineer` | Framework / library major-version upgrades. Reads upstream changelog, executes incrementally, verifies at every step. | Next.js 13→14, Vue 2→3, Tailwind 3→4, etc. |
| 🎨 **Designer** | `frontend-designer` | Builds landing pages, dashboards, and UI that doesn't look like AI slop. Opinionated aesthetic direction, refuses generic output. | New pages, UI redesigns, visual upgrades |
| 🔍 **Code Reviewer** | `critic` | Finds bugs, security holes, logic errors, edge cases, performance issues. Every finding with file path + line number. No "looks good to me". | Pre-commit, pre-deploy, pre-merge |
| 🧪 **Pentester** | `vuln-verifier` | Takes the critic's findings and writes actual PoC tests to prove the vulnerability is real — no false positives, no hand-waving. | After critic flags a security issue |
| 🐛 **Debug Engineer** | `debugger` | Reads logs, constructs hypotheses, verifies, fixes. Never guesses, always traces root cause. Includes log-analyzer. | Bug reports, service incidents, test failures |
| 🗄 **DB Specialist** | `db-expert` | Reviews schemas, migrations, queries for safety, indexes, locks, race conditions. Paranoid about data loss. | Schema changes, migrations, query optimization |
| 🗺 **Onboarder** | `onboarder` | First-time codebase exploration. Produces a structured mental model — architecture, entry points, suspicious areas. | Joining a new project, evaluating an open-source repo |
| ⚙️ **Tool Expert** | `tool-expert` | Picks the right MCP tools, chains complex workflows, troubleshoots tool failures. Knows every integration in your stack. | MCP tool failures, complex tool chaining |
| 📚 **Researcher** | `web-researcher` | Fetches and synthesizes official docs, API specs, error code meanings. The antidote to hallucination. | Uncertain API usage, error code lookups |

Each agent is a markdown file under `agents/` with its own system prompt, tool permissions, and model selection. **Customize them. Fork them. Replace the ones you don't need.**

---

## The Workflow

```
           ┌─────────────┐
           │  Your Task  │
           └──────┬──────┘
                  │
         ┌────────▼────────┐
         │   📋 planner    │  ← Breaks into parallel subtasks
         │    (Tech Lead)   │    if touches 3+ files
         └────────┬────────┘
                  │
        ┌─────────┼─────────┐
        ▼         ▼         ▼
  ┌─────────┐ ┌─────────┐ ┌─────────┐
  │ fullstk │ │ fullstk │ │ fullstk │  ← Parallel execution
  │   × N   │ │   × N   │ │   × N   │    P7 methodology
  └────┬────┘ └────┬────┘ └────┬────┘
       └───────────┼───────────┘
                   ▼
           ┌──────────────┐
           │  🔍 critic   │  ← Mandatory pre-deploy review
           │   (reviewer)  │
           └───────┬──────┘
                   │
          ┌────────┴────────┐
          │                 │
          ▼                 ▼
   ┌──────────────┐  ┌─────────────┐
   │ 🐛 debugger  │  │   Deploy    │
   │ (if issues)  │  │             │
   └──────────────┘  └─────────────┘
```

**Security-sensitive work** takes a detour: `critic` flags → `vuln-verifier` writes PoC → fix or file PR.

---

## The Methodology

### Three Red Lines

Every agent enforces these. No exceptions. No "close enough".

- **🔒 Closure Discipline** — Every task has a clear Definition of Done. "This is probably enough" is not an ending.
- **📎 Fact-Driven** — Every judgment must cite actual code with paths and line numbers. "I guess" / "probably" / "should be" are violations.
- **✅ Exhaustiveness** — Checklists cannot be skipped. Clean items must be explicitly marked "checked, no problems" — never silently ignored.

### P7/P9/P10 Mode Switching

Not role-play. **Operating modes** that Claude switches between based on task scope:

| Scope | Mode | Behavior |
|-------|------|----------|
| Single feature | **P7** (Senior Engineer) | Design → Impact analysis → Implement → Three-question self-review → `[P7-COMPLETION]` |
| Multi-module, 3+ files | **P9** (Tech Lead) | Decompose into Task Prompts with six elements. Coding is forbidden — your output is prompts, not code. |
| Cross-team, 5+ sprints | **P10** (CTO) | Output strategy docs. Goals, success metrics, risks, timeline, resource allocation. |

### PUA Mode (High-Pressure Triggers)

The team shifts into exhaustive mode when:

- Same task failed 2+ times → write three new hypotheses, no retrying the old one
- About to say "I can't solve this" → forbidden, check docs and source
- Being passive, waiting for instructions → find the next step yourself
- User says "try harder" / "why did it fail again" → enter reflection mode
- User says "don't get slapped again" → cross-verify every assumption 3 different ways

> We don't keep idle agents. No half-finished work. No excuses.

---

## The Automation (Hooks)

Fifteen automation hooks wire up at `pre-commit`, `post-tool-use`, and `stop` events. They catch problems before they ship.

| Hook | Trigger | What it catches |
|------|---------|-----------------|
| 💰 `cost-tracker.js` | After every response | Token usage + estimated cost per model (Opus / Sonnet / Haiku). Running tally in `~/.claude/stats-cache.json` |
| ✋ `commit-quality.js` | Pre-commit | Blocks commits with `debugger` statements or hardcoded secrets in JS/TS/Python files |
| 🔧 `mcp-health.js` | MCP tool failures | Detects MCP server outages and suggests restart paths |
| 🛡 `config-protection.js` | Edit/Write to critical files | Guards important config files from accidental overwrites |
| 🎨 `design-quality.js` | Frontend changes | Checks for AI-slop indicators in UI code |
| 📝 `check-console.js` | Pre-commit | Flags stray `console.log` in production paths |
| 📊 `audit-log.js` | All tool calls | Keeps an audit trail of significant tool operations |
| 🎯 `batch-format.js` | Multi-file edits | Runs formatter on modified files in batch |
| 💡 `suggest-compact.js` | Context pressure | Suggests `/compact` when context window fills up |
| 📈 `accumulator.js` | Session tracking | Accumulates session metrics |
| 🚨 `log-error.sh` | Any error | Unified error logging to `~/.claude/error-log.md` |
| 🧪 `test-runner.js` | After file edit | Finds sibling test file, runs vitest/jest, reports failures (non-blocking) |
| 🔒 `branch-protection.js` | Pre-Bash | Hard-blocks force pushes and direct commits to main / master / production / release |
| 📏 `large-file-warner.js` | Pre-Read | Warns at 500 KB, blocks at 2 MB to protect context window |
| 📚 `session-summary.js` | Stop | Appends session summary to `~/.claude/sessions/` for later search |

Each hook is a self-contained script. Enable / disable / customize in `settings.example.json`.

---

## From the Field

Real observations from daily use. Your mileage may vary.

### `critic` is the MVP

On mid-sized modules (500–2000 lines), `critic` routinely finds **20–30 issues** across all severity tiers. On large open-source codebases (tested against OpenClaw 352K⭐, Mermaid 87K⭐, Storybook 85K⭐, React Router 56K⭐), a single focused audit still surfaces **5–10 real bugs** that had not been reported in the issue tracker.

Notable catches from real audits:
- A CWE-208 timing-safe comparison gap in a 352K-star repo that **three prior security-hardening PRs had missed** (diffs store `!==` vs `safeEqualSecret`)
- A non-atomic `writeFileSync` race in an auth-adjacent allowlist file that would corrupt state under concurrent access
- An Ollama reasoning-model heuristic regex (`/r1/`) that misidentified unrelated models as thinking models

The strictness ("assume everything is broken until proven otherwise") is what makes it work.

### `debugger` saves you from face-plants

Twice during one bug-hunting session, the author was about to submit PRs based on seemingly clear reproductions. Both times `debugger` traced the behavior on HEAD and found the bugs had **already been silently fixed** in recent commits — the original reporters were on outdated versions. Submitting would have been embarrassing.

- **Svelte #18083** — infinite-loop reconcile bug. Turned out to be a regression introduced in 5.43.8 that was fixed in 5.44.0+ by #17191 / #17240 / #17550. `debugger` ran the repro on HEAD and the test passed.
- **Mermaid #6953** — sequence diagram alias+type combo. Already shipped in 11.14.0 via PR #7136; the issue just hadn't been closed.

The slow methodology ("reproduce, then hypothesize, then verify") is the whole point.

### `planner` replaces the clarification loop

On tasks touching 3+ files, dispatching to `planner` first turns a 30-message back-and-forth into one structured Task Prompt. The **six-element contract** (goal / scope / input / output / acceptance / boundaries) forces you to state the Definition of Done before anyone writes code.

### `vuln-verifier` is boring in the best way

Most reported "vulnerabilities" are false positives or partially true. The **PoC-or-it-didn't-happen** protocol converts fuzzy "I think this could be exploited" reports into verdicts with actual program output. Every verdict comes with an attack input **and** a baseline control input — so you prove the vulnerable behavior is triggered by the attack and not by any input.

---

## Install (One Command)

```
/plugin marketplace add NYCU-Chung/my-claude-devteam
/plugin install devteam@my-claude-devteam
```

Once installed, all 12 agents and 15 hooks register automatically. Restart Claude Code and your dev team is online.

### Optional: install the methodology document

The plugin ships with the **P7/P9/P10 methodology + three red lines** baked into each agent, but for the strongest effect, also drop one of the `CLAUDE.md` files into `~/.claude/CLAUDE.md` so the whole session operates under the same discipline:

```bash
# English
curl -sL https://raw.githubusercontent.com/NYCU-Chung/my-claude-devteam/main/CLAUDE.en.md   -o ~/.claude/CLAUDE.md

# Traditional Chinese
curl -sL https://raw.githubusercontent.com/NYCU-Chung/my-claude-devteam/main/CLAUDE.zh-TW.md   -o ~/.claude/CLAUDE.md
```

### Manual install (without plugin)

If you prefer not to use the plugin system:

```bash
git clone https://github.com/NYCU-Chung/my-claude-devteam ~/my-claude-devteam

mv ~/.claude/agents ~/.claude/agents.bak 2>/dev/null
mv ~/.claude/hooks  ~/.claude/hooks.bak  2>/dev/null

cp -r ~/my-claude-devteam/agents ~/.claude/
cp -r ~/my-claude-devteam/hooks  ~/.claude/
cp ~/my-claude-devteam/settings.example.json ~/.claude/settings.json
# (optional) cp ~/my-claude-devteam/CLAUDE.en.md ~/.claude/CLAUDE.md
```

**Verify the install:**

```
You: "I need to add a POST endpoint for broadcast messages"
Claude: [spawns fullstack-engineer with P7 methodology]
        [designs → implements → three-question self-review]
        [spawns critic for pre-deploy review]
```

---

## What's NOT Included

This repo is **opinionated methodology + tools**, not a kitchen sink. You still need to bring:

- **Your own subagents** for project-specific roles (VPS ops, deployment automation, custom integrations)
- **Your own hook configuration** for paths and thresholds
- **Your own CLAUDE.md project sections** — infrastructure, repo lists, deployment commands (keep these out of the public repo for security)
- **Third-party skill packs** — this repo doesn't redistribute other people's work

---

## Credits

- **P7/P9/P10 methodology and PUA mode** are adapted from [**tanweai/pua**](https://github.com/tanweai/pua) (MIT License) by 探微安全实验室 (Tanwei Security Lab). The original is a full Claude Code plugin with KPI reports, leaderboards, self-evolution tracking, and a Loop mode. If you want the full feature set, install it directly from [openpua.ai](https://openpua.ai).
- **The 12-agent team structure and hooks** are the result of months of real-world iteration — shipping to production, getting burned, iterating again.
- **Core philosophy** is inspired by Chinese big-tech engineering culture: P-level role ladders, closure-oriented task management, the "three red lines" discipline, and the corporate pressure culture that turns "good enough" into "exhaust every option".

---

## License

MIT. Take it, fork it, ship it. Attribution appreciated but not required.

---

> Built by [@NYCU-Chung](https://github.com/NYCU-Chung).

© NYCU-Chung · MIT · NYCU-Chung/my-claude-devteam

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
pr-issue-resolve safayavatsal Плагин pr-issue-resolve для Claude Code анализирует pull request и автоматически применяет запрошенные изменения. ★ 1 013звёзд репо code-review-and-quality addyosmani Скилл code-review-and-quality для Claude Code и других платформ проводит многоосное ревью кода по пяти критериям перед слиянием изменений. Запускается перед мёрджем любых веток и ПР. CX Codex +1 92 300установок code-reviewer https://github.com/Jeffallan Скилл code-reviewer анализирует дифы и файлы, ловит баги, уязвимости (SQL-injection, XSS), запахи кода и N+1 запросы, выдаёт структурированный отчёт с приоритетами. Нужен при ревью PR и аудитах качества. CX Codex +1 7 100установок review-and-simplify-changes Dimillian Скилл review-and-simplify-changes разбирает изменённый код на переиспользование, качество, эффективность и ясность, а потом по желанию вносит безопасные правки. Пригодится перед коммитом. CX Codex +1 872установок code-review Matt Pocock Скилл code-review проверяет ветку или коммиты по двум осям: соответствие стандартам кода и выполнение требований спеки. Запускает субагентов параллельно. CX Codex +1 789 521установок codescene-codehealth codescene-oss С инструментами CodeScene Code Health. Анализирует качество кода, находит проблемные места и помогает выбрать безопасные шаги рефакторинга. ★ 82звёзд репо

Из того же набора13

Весь набор →
db-expert Субагент db-expert проверяет схемы, миграции и запросы на риск потери данных, блокирующие локи и N+1, перед тем как изменение попадёт в мастер. CX Codex ★ 267звёзд репо refactor-specialist Субагент refactor-specialist для Claude Code помогает безопасно менять структуру кода в нескольких файлах. Он подключается для переименования сущностей, переноса файлов и выделения модулей. CX Codex ★ 267звёзд репо debugger Субагент debugger расследует ошибки и сбои: изучает логи, проверяет гипотезы и ищет первопричину. Запускайте его при падении тестов, регрессии или непонятном поведении приложения. CX Codex ★ 267звёзд репо migration-engineer Субагент migration-engineer ведёт мажорные апгрейды фреймворков и библиотек: читает changelog, находит все вызовы изменившегося API и правит по шагам с проверкой после каждого. CX Codex ★ 267звёзд репо tool-expert Субагент tool-expert выбирает подходящие инструменты для задач в Claude Code, связывает их в цепочки и разбирается в причинах сбоев MCP-серверов. CX Codex ★ 267звёзд репо frontend-designer Субагент frontend-designer проектирует и собирает страницы, панели и компоненты с заданным визуальным направлением. Подключайте его для новой UI или редизайна существующей страницы. CX Codex ★ 267звёзд репо planner planner — субагент-технический лид для Claude Code: читает код проекта и делит задачу на параллельные подзадачи с чёткими контрактами. Сам код не пишет, а готовит промпты другим субагентам. CX Codex ★ 267звёзд репо vuln-verifier Субагент vuln-verifier проверяет отчёты ревьюера и пишет контрольные тесты для подтверждения уязвимостей. Помогает отсеять ложные срабатывания перед оформлением security advisories. CX Codex ★ 267звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой