# debug-my-harness

Разбирает, почему агентная обвязка сработала не так, читая локальный журнал .vigiles/runs.jsonl. Пригодится, когда скилл перестал запускаться или хук пропустил то, что должен был заблокировать.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 установок · ★ 15
- Автор: zernie
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zernie/vigiles/tree/HEAD/skills/debug-my-harness/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/debug-my-harness

## Что делает

Скилл диагностирует сбои в агентной обвязке по flight recorder — локальному журналу `.vigiles/runs.jsonl`, который vigiles дописывает по мере работы. Вместо догадок вы получаете разбор на основе записей: какие скиллы сработали, какие хуки заблокировали или ошибочно пропустили действие, где субагент вышел за пределы своего контракта.

Каждая строка журнала — JSON с полем `kind`: `hook` для решений хуков, `agent` для проверок контрактов субагентов, `skill` для активаций, `eval` для метрик вроде recall и precision. Скилл читает файл через Read, Glob и Grep, сопоставляет записи с вопросом и выдаёт диагноз со ссылкой на конкретные строки.

Ограничение простое: это диагностика, а не правка. Новые правила пишутся через `strengthen`, изменения спек — через `edit-spec`, замеры поведения — через `test-harness`. Если журнала нет или он пуст, скилл так и скажет и предложит сначала запустить обвязку либо `vigiles audit`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add zernie/vigiles --skill debug-my-harness -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/debug-my-harness/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/debug-my-harness/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add zernie/vigiles --skill debug-my-harness -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/debug-my-harness/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add zernie/vigiles --skill debug-my-harness -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/debug-my-harness/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zernie/vigiles debug-my-harness
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/debug-my-harness/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add zernie/vigiles --skill debug-my-harness -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/zernie/vigiles --path skills/debug-my-harness
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/debug-my-harness/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add zernie/vigiles --skill debug-my-harness -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zernie/vigiles/tree/HEAD/skills/debug-my-harness/SKILL.md

## Когда брать
- найти, почему скилл перестал срабатывать
- показать, какой хук пропустил запрещённое действие
- вычислить субагента, нарушившего контракт инструментов
- отследить падение trigger-rate по метрикам eval
- понять, что реально делала обвязка во время прогона

## Примеры запросов агенту
- Почему скилл X перестал запускаться?
- Покажи, почему хук не заблокировал это действие
- Какой субагент вышел за пределы контракта?

## Похожие
- [agent-harness](https://affpapa.org/nevibecode/plugins/agent-harness.md) — плагин · ★ 28733
- [debug-issue](https://affpapa.org/nevibecode/skills/debug-issue.md) — скилл · 1000 установок
- [debug](https://affpapa.org/nevibecode/skills/cyrusagents-debug.md) — скилл · 826 установок
- [debug-mantra](https://affpapa.org/nevibecode/skills/debug-mantra.md) — скилл · 4900 установок
- [ce-debug](https://affpapa.org/nevibecode/skills/ce-debug.md) — скилл · 3500 установок
- [debug-zoom-integration](https://affpapa.org/nevibecode/skills/anthropics-debug-zoom-integration.md) — скилл · 2100 установок

Из того же набора: [zernie/vigiles](https://affpapa.org/nevibecode/by/zernie/vigiles.md) — 7 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md