К основному содержанию
скилл CX Codex

bug-reporting-excellence — скилл для Claude Code

Скилл bug-reporting-excellence для Claude Code помогает описывать ошибки с условиями, шагами воспроизведения, ожидаемым и фактическим результатом. Задаёт структуру отчёта о баге.

MIT 1 установок ★ 533 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add proffesor-for-testing/agentic-qe --skill bug-reporting-excellence -a claude-code
Открыть на GitHub

Что делает bug-reporting-excellence

Скилл задаёт структуру отчёта: компонент и условие сбоя в заголовке, серьёзность, среда, ожидаемое и фактическое поведение, шаги воспроизведения и влияние на пользователей или бизнес. Он также советует прикладывать логи и снимки экрана, уточнять условия сбоя и выносить каждый баг в отдельный отчёт.

В справке есть шкала серьёзности от Critical до Low и примеры удачных и слабых формулировок. Для воспроизведения важны точные сведения о среде, включая ОС и версию браузера; общих шагов вроде «открыть приложение» недостаточно. В скилле также описаны сценарии передачи отчётов субагентам для триажа, поиска дубликатов и дополнения недостающих деталей.

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

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

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

  • Составь отчёт о сбое: укажи ожидаемое и фактическое поведение, шаги воспроизведения и влияние на пользователей.
  • Оцени серьёзность этой ошибки и уточни, какие сведения о среде нужны для её воспроизведения.
  • Раздели это описание на отдельные отчёты, если в нём смешаны разные баги.

Как установить bug-reporting-excellence

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill bug-reporting-excellence -a claude-code

2Вручную: положить файлы

~/.claude/skills/bug-reporting-excellence/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bug-reporting-excellence/

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

Вопросы о bug-reporting-excellence

Как установить bug-reporting-excellence в Claude Code?

Выполните npx skills add proffesor-for-testing/agentic-qe --skill bug-reporting-excellence -a claude-code. Файл скилла появится по пути ~/.claude/skills/bug-reporting-excellence/SKILL.md.

Что делает bug-reporting-excellence?

Помогает оформить баг-репорт с условиями, шагами воспроизведения, ожидаемым и фактическим поведением, серьёзностью и влиянием. Также объясняет, как приложить сведения о среде и не объединять разные ошибки в одном отчёте.

Какие сведения нужны, чтобы воспроизвести баг?

Укажите точные шаги и условия, а также среду, например ОС и версию браузера. Скилл также советует добавлять логи или снимки экрана.

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

SKILL.md · MIT
---
name: bug-reporting-excellence
description: "Write high-quality bug reports that get fixed quickly. Use when reporting bugs, training teams on bug reporting, or establishing bug report standards."
category: quality-communication
priority: high
tokenEstimate: 900
agents: [qe-quality-analyzer, qe-production-intelligence, qe-flaky-test-hunter]
implementation_status: optimized
optimization_version: 1.0
last_optimized: 2025-12-03
dependencies: []
quick_reference_card: true
tags: [bugs, reporting, communication, triage, quality]
trust_tier: 2
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
---

# Bug Reporting Excellence

<default_to_action>
When reporting bugs:
1. TITLE: `[Component] fails [Condition] causing [Impact]`
2. DESCRIBE: Expected behavior → Actual behavior → Steps to reproduce
3. INCLUDE: Environment, severity, screenshots/logs, business impact
4. ISOLATE: Narrow down conditions (browser, user, amount thresholds)
5. ONE BUG = ONE REPORT (don't combine issues)

**Bug Report Formula:**
```markdown
## [Component] Issue Title
**Severity:** Critical/High/Medium/Low
**Environment:** Production/Staging/Dev

### Expected Behavior
What should happen

### Actual Behavior
What actually happens (with error messages)

### Steps to Reproduce
1. Step one
2. Step two
3. Observe issue

### Impact
How this affects users/business
```

**Critical Success Factors:**
- Reproducible steps (100%)
- Environment info (100%)
- Business impact stated (90%)
- Screenshots or logs (80%)
</default_to_action>

## Quick Reference Card

### Severity Levels

| Level | Definition | Examples |
|-------|------------|----------|
| **Critical** | System down, data loss, security | DB deleted, payments broken, credentials exposed |
| **High** | Major feature broken, many users | Can't checkout, search broken, dashboard fails |
| **Medium** | Partial break, workaround exists | Filter broken (refresh works), slow export |
| **Low** | Cosmetic, rare edge case | Button wraps on mobile, tooltip wrong color |

### Title Formula
❌ Bad: "Checkout broken"
✅ Good: "Payment fails with Visa cards when order total > $1000"

**Pattern:** `[Component] fails [Condition] causing [Impact]`

---

## Essential Information

### Environment Details
```
Browser: Chrome 120.0.6099.109 (Windows)
OS: Windows 11 Pro
URL: https://example.com/checkout
Date/Time: 2025-10-17 14:23 UTC
User: [email protected] (ID: 12345)
Request ID: abc-123-def-456
```

### Supporting Evidence

**Error Messages:**
```json
{
  "error": "Payment service unavailable",
  "code": "GATEWAY_TIMEOUT",
  "requestId": "abc-123-def-456"
}
```

**Console Logs:**
```
[ERROR] PaymentGateway: Connection timeout after 30000ms
  at PaymentGateway.charge (gateway.js:145)
```

---

## Example: Excellent Bug Report

```markdown
## [Checkout] Payment processing times out for orders > $1000

**Severity:** High
**Environment:** Production
**Affected Users:** ~15% of premium purchases

### Expected Behavior
Payment completes within 5 seconds regardless of amount.

### Actual Behavior
For orders above $1000, payment gateway times out after 30 seconds.
User sees "Payment failed" error. Order not created.

### Steps to Reproduce
1. Add items totaling $1,050 to cart
2. Proceed to checkout
3. Enter payment: Visa 4532 1234 5678 9010
4. Click "Place Order"
5. Wait 30+ seconds
6. Observe timeout error

### Environment
- Browser: Chrome 120 (Windows 11)
- User: [email protected]
- Request ID: abc-123-def-456

### Evidence
Console error: `PaymentGateway timeout: 30000ms exceeded`
Network: /api/checkout: 30.14s (timeout)

### Impact
- Lost revenue: ~$15K/week from failed orders
- 23 support tickets this week
- Affects 15% of orders over $1000

### Additional Context
Started after Oct 15 deployment (v2.3.0)
Possibly related to PR #456 (fraud check)
```

---

## Anti-Patterns

| ❌ Bad | Problem | ✅ Good |
|--------|---------|--------|
| "Checkout is broken" | What doesn't work? | "Payment button doesn't respond when clicked" |
| "I saw an error" | No reproduction steps | Full steps with conditions |
| "Page loads slowly" | No specifics | "Dashboard takes 12s to load (should be <3s)" |
| Multiple bugs in one | Can't track separately | One report per bug |

---

## Agent Integration

```typescript
// Automated bug triage
const triage = await Task("Triage Bug", {
  title: 'Payment fails for orders > $1000',
  description: bugDescription,
  steps: reproductionSteps
}, "qe-quality-analyzer");

// Returns: { severity, priority, component, suggestedAssignee, relatedIssues }

// Duplicate detection
const dupeCheck = await Task("Check Duplicates", {
  bugReport: newBug,
  similarityThreshold: 0.85
}, "qe-quality-analyzer");

// Bug report enhancement
const enhanced = await Task("Enhance Report", {
  originalReport: userSubmittedBug,
  addMissingInfo: true,
  identifyRootCause: true
}, "qe-production-intelligence");
```

---

## Agent Coordination Hints

### Memory Namespace
```
aqe/bug-reports/
├── triaged/*          - Bug triage results
├── duplicates/*       - Duplicate detection
├── patterns/*         - Recurring bug patterns
└── root-cause/*       - Root cause analyses
```

### Fleet Coordination
```typescript
const bugFleet = await FleetManager.coordinate({
  strategy: 'bug-investigation',
  agents: [
    'qe-quality-analyzer',        // Triage and categorize
    'qe-flaky-test-hunter',       // Check if test-related
    'qe-production-intelligence'  // Check production logs
  ],
  topology: 'parallel'
});
```

---

## Related Skills
- [technical-writing](../technical-writing/) - Clear bug documentation
- [exploratory-testing-advanced](../exploratory-testing-advanced/) - Finding bugs
- [sherlock-review](../sherlock-review/) - Root cause investigation

---

## Remember

Your bug report is the starting point for someone else's work. Make it **complete** (all info needed), **clear** (anyone can follow), **concise** (no noise), and **actionable** (developer knows next step).

**Good bug reports = Faster fixes = Better product = Happier users**

## Skill Composition

- **After finding bug** → Start with `/test-failure-investigator` for root cause
- **Prevent regression** → Use `/regression-testing` to add test preventing recurrence
- **Track quality** → Feed into `/test-metrics-dashboard` for trend analysis

## Gotchas

- Agent omits environment details (OS, browser version, node version) — these are critical for reproduction
- "Steps to reproduce" that start with "1. Open the app" are useless — specify exact URL, user role, and state
- Agent combines multiple bugs into one report — enforce ONE BUG = ONE REPORT strictly
- Screenshots without annotations don't help — always highlight the actual error area
- Severity assessment is often wrong — agent marks everything as "critical" or everything as "low"

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
agent-communication-excellence-coach softaworks agent-communication-excellence-coach — плагин для Claude Code, который помогает править письма и готовиться к сложным разговорам. Запросите разбор черновика, тренировку диалога или отзыв о презентации. ★ 2 707звёзд репо revenue-reporting Maya-Beth Finotti Скилл revenue-reporting помогает собрать отчёт по выручке для совета директоров или руководства. Формирует основу из метрик, сверяет CRM с финансами и выстраивает чёткую историю план-факт. CX Codex +1 26 800установок visualization-choice-reporting lyndonkl Скилл visualization-choice-reporting для Claude Code, Codex, Cursor и других платформ подбирает тип визуализации под вопрос к данным и формирует отчёт с заголовком, контекстом и рекомендациями. CX Codex +1 148установок communication-excellence-coach softaworks Субагент communication-excellence-coach разбирает черновики писем, калибрует тон общения и помогает отрепетировать сложные разговоры в режиме ролевой игры. CX Codex ★ 2 707звёзд репо engagement-reporting microsoft Скилл engagement-reporting формирует еженедельные отчёты о ходе проекта с опорой на первоисточники и создаёт черновики писем в Outlook. CX Codex +1 ★ 1 627звёзд репо audit-reporting-stinger Legion Code Inc. Скилл audit-reporting-stinger рендерит итоговые отчёты Website Auditor — Markdown и HTML с брендингом Legion Code Inc. — из готового реестра находок. CX Codex +1 ★ 96звёзд репо

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

Весь набор →
qcsd-cicd-swarm Скилл qcsd-cicd-swarm для Claude Code проверяет CI/CD-пайплайн перед выпуском и оценивает готовность к развёртыванию. Анализирует регрессионные риски и нестабильные тесты, затем выносит решение: RELEASE, REMEDIATE или BLOCK. CX Codex +1 104установок test-idea-rewriting Скилл test-idea-rewriting переписывает пассивные формулировки тестов в активные действия с наблюдаемым результатом для Claude Code. Применяется при проверке качества и разборе тест-кейсов. CX Codex +1 104установок cicd-pipeline-qe-orchestrator Скилл cicd-pipeline-qe-orchestrator для Claude Code распределяет проверки качества по этапам CI/CD и помогает настроить блокирующие гейты. Он согласует тестирование от коммита до продакшена. CX Codex +1 1установок accessibility-testing Скилл accessibility-testing для проверки интерфейса на WCAG 2.2: клавиатурная навигация, контраст и работа со скринридерами, с готовыми шаблонами тестов. CX Codex +1 1установок qe-visual-accessibility Скилл qe-visual-accessibility автоматизирует проверку доступности по стандарту WCAG 2.2 и находит сдвиги интерфейса по скриншотам. Помогает контролировать регрессии после правок стилей и компонентов. CX Codex +1 1установок exploratory-testing-advanced Скилл exploratory-testing-advanced для Claude Code помогает планировать исследовательские сессии, проверять гипотезы и фиксировать дефекты. Проверяет новые функции и риски, которые не ловят автоматические тесты. CX Codex +1 1установок compliance-testing Скилл compliance-testing проверяет соответствие приложения GDPR, CCPA, HIPAA, SOC2 и PCI-DSS; включается перед аудитом или при работе с персональными данными. CX Codex +1 1установок quality-metrics Скилл quality-metrics отслеживает метрики качества ПО: плотность дефектов, DORA, MTTD и bug escape rate для дашбордов и quality gates. CX Codex +1 1установок

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

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