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

retro · phuryn/product-engineering — скилл для Claude Code: что делает и как установить

Скилл retro для Claude Code разбирает сбои и задержки в завершённой сессии и превращает подтверждённые причины в правки настроек агента. Он запускается по имени команды.

MIT ★ 741 обновлён 2026-11-14

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add phuryn/product-engineering
/plugin install agent-harness@product-engineering
Открыть на GitHub

Что делает retro

retro разбирает, что тормозило работу или пошло не так за сессию, и ищет причину каждого случая. Затем он меняет подходящий файл инструкций, маршрут чтения, хук или скрипт, а после проверяет правку там, где она срабатывает. Если проблема была разовой, менять настройки не нужно.

Скилл предпочитает исправления в коде, затем правки существующих инструкций и только потом новые правила. Для нового правила он добавляет дату и описание случая. Проверки выполняются на обратимых изменениях репозитория; реальные необратимые действия для теста не запускаются. Настройки пользователя и глобальные инструкции он не меняет без разрешения владельца.

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

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

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

  • Разбери, почему агент дважды запустил тесты не на том сервере, и исправь настройку.
  • Найди, какое правило агент пропустил в этой сессии, и проверь правку.
  • Подведи итог сессии: укажи причины сбоев и сообщи, нужна ли правка настроек.

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

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

/plugin marketplace add phuryn/product-engineering
/plugin install agent-harness@product-engineering

Команда ставит плагин agent-harness целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add phuryn/product-engineering --skill retro -a claude-code

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

~/.claude/skills/retro/SKILL.md

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

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

Вопросы о retro

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

В Claude Code выполните /plugin marketplace add phuryn/product-engineering, затем /plugin install agent-harness@product-engineering. Либо добавьте скилл командой npx skills add phuryn/product-engineering --skill retro -a claude-code.

Что делает retro?

Скилл разбирает сбои и задержки в сессии, определяет их причины и предлагает или вносит соответствующие правки в инструкции, маршруты, хуки либо скрипты. Затем он проверяет изменения там, где они применяются.

Меняет ли retro глобальные настройки?

Нет. Изменения за пределами репозитория он предлагает точным текстом и вносит только после разрешения владельца.

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

SKILL.md · MIT
---
name: retro
description: "Build a session's learnings into the setup: its friction, what went wrong and why, then an improved instruction, route, hook or script, verified, or 'no setup change warranted'. Started by name only: /agent-harness:retro in Claude Code, $agent-harness:retro in Codex."
argument-hint: "<optional: the friction you noticed>"
disable-model-invocation: true
---

# Retro — a session's learnings, built into your setup

**Build the session's learnings into the setup before its context goes.** At the end of a session, find what slowed it down or went wrong, why, and what setup change stops it happening again. The output is fixes made and checked, not a list of lessons.

## Invocation

```
/agent-harness:retro                             Claude Code, plugin installed
/agent-harness:retro it ran the tests against the wrong server twice
$agent-harness:retro                             Codex, plugin installed
/retro   ·   $retro                              the skill folder copied into a repository
```

## Steps

### 1. List what actually happened

**List only this session's friction, with the moment each item happened.**

- the owner corrected the agent (quote the correction);
- the agent missed a rule it had;
- work was done twice, or undone;
- an assumption turned out wrong;
- a tool, script or command failed, or needed a workaround;
- the owner waited on something the agent could have done.

**Leave out successes and guesses about the future.** List evidence, not new rules: an item with no moment behind it is not one.

### 2. Find the cause of each

| Cause | What it looks like | The fix goes in |
|---|---|---|
| Missing | nothing told the agent | the entry file when every session needs it; otherwise the file the agent reads at the moment the rule must change a decision, with a router row for that moment (§ 3) |
| Present but not met | the rule existed and the agent didn't apply it when it mattered | the route to it (the instructions' index of what to read when), or code |
| A tool gap | a script, check or wrapper was missing or wrong | the tool |
| A skill's advice | a skill from a plugin or a collection said something wrong, or left a step out | the project's own agent instructions, naming the skill and what to do instead (§ 3) |
| A one-off | it won't recur | nowhere: say so |

### 3. Fix it, code first

**Prefer code, then an improved instruction or route, then a new rule.** Use this order:

1. **Hold the fix in code wherever code can hold it.** Use a script, hook, validation, required argument or test. Prose loses when compliance depends on an agent remembering a sentence at the moment it matters. Apply the `guardrail-hooks` skill for hooks and permission rules.
2. **Improve an existing instruction or route before adding another rule.** Reword the misread rule, or move it where the agent will see it when it applies. Replace or tighten before adding. Removing a rule's text is the owner's decision. Tighten wording without dropping a condition, exception or receipt, or move the rule to its fire point with a pointer left behind. A move is not a removal. You can also add the test or hook that holds it, and propose removal. Apply the `agent-instructions` skill for how instruction files are shaped.
3. **Add a new rule only when this session gave it a receipt.** Include the date and what happened.

**Put each learning where it must change a decision.** The entry file (`AGENTS.md`, or the project's own name) holds what every session needs. Put the rest at its fire point, not its topic home, usually in the file for the area that task touches. Add an entry-file index line saying when to read it.

**Re-read an area's file at the start of every task touching it.** The index must require this, not once a session. After compaction or a long session, the earlier read is gone. If the router doesn't yet say to re-read at every task, add that sentence. Each file stays within its word budget, and the rule carries its receipt and a review date (`agent-instructions`, budgets).

**Make reversible repository fixes and verify each where it applies.** Pipe a sample payload that must trigger into a hook, and one that must not; for a new or rewired hook, also run its canary in a live session where it has one (the `guardrail-hooks` templates do); otherwise report the wiring unchecked. Never run a real one-way door to test it. Open the route where the agent will read it; run the script. Report an unchecked fix as unchecked. Propose changes outside the repository with exact text; don't make them unless the owner says so. This includes the user's own settings and global instructions.

**Keep a skill's correction in the project's own agent instructions.** Put it where the agent reads it while that skill is in use. Use the router row for when the skill runs, or the entry file if it can fire in any task. An installed plugin copy sits outside the repository; a copied skill is overwritten by its next update, so edits to either are lost.

**Draft skill corrections for the source repository for the owner to file.** Use the repository its plugin or copy came from. Include what the skill says, what happened (the receipt), and replacement text, for the owner to file as an issue there. Follow that repository's skill style: name the product by kind. Include no session names, ids, hostnames, paths, account names or values, since the repository is usually public.

### 4. Report

**Report each item's incident, cause, fix and verification in one line.** When nothing deserves a change, "no setup change warranted" is valid and better than a rule that will never fire.

**Don't gate what the owner wouldn't want to click for.** A guard that asks too often trains a reflexive yes.

Each rule's origin, the case that taught it, is in `receipts.md` beside this file; read it when a rule's edge is unclear.

## How you can tell it worked

Each fix names the moment it came from and was checked where it applies, and the next session doesn't hit the same friction.

© Paweł Huryn · MIT · phuryn/product-engineering

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — retro от других авторов.

retro Matt Pocock Скилл retro проводит ретроспективу сессии кодинга и предлагает правки окружения агента. Нужен после ошибок, долгой навигации по репозиторию или лишних вызовов инструментов. CX Codex +1 276 027установок retro phuryn Скилл retro помогает фасилитировать ретроспективу спринта, разобрать успехи и проблемы команды, а также составить приоритизированный список действий с ответственными и сроками. CX Codex +1 2 900установок retro typeui.sh Скилл retro задаёт ретро-стиль интерфейса с контрастной палитрой, шрифтами Macondo и JetBrains Mono, а также формирует гайдлайны по стандарту WCAG 2.2 AA. CX Codex +1 2 800установок retro Necmttn Скилл retro проводит сессию разбора предложений и вердиктов из ax-графа агентского опыта. Показывает открытые эксперименты, ждущие решения вердикты и эффективность хуков. CX Codex +1 ★ 124звёзд репо retro rainmanjam Скилл retro помогает разобрать инцидент, найти архитектурную причину сбоя в коде и сформулировать выводы для будущих разработчиков. CX Codex +1 ★ 26звёзд репо session-review awrshift Проверяет итоги сессии разработки независимыми ревьюерами. Запускается по запросу /session-review или просьбе проверить сессию. CX Codex +1 ★ 33звёзд репо pr-retro ulpi-io Скилл pr-retro проверяет готовность feature-ветки к слиянию по данным Git и выдаёт вердикт с рекомендациями. Запускайте его перед ревью PR. CX Codex +1 150установок printing-press-retro mvanhorn Скилл printing-press-retro проводит ретроспективу после сборки CLI в Printing Press. Он находит дефекты генератора и оформляет отчёт с черновиками задач для GitHub. CX Codex +1 6 800установок retro-marimo-pair marimo-team Скилл retro-marimo-pair проводит ретроспективу сессии работы с marimo: находит места, где что-то пошло не так, и превращает их в задачи для команды. CX Codex +1 5 600установок om-pipeline-retro open-mercato Скилл om-pipeline-retro анализирует завершённые прогоны пайплайна, находит причины повторных попыток и считает потерянные часы. Пригодится на ретроспективе разработки. CX Codex +1 3 100установок launch-retro-analyzer aaron-he-zhu Скилл launch-retro-analyzer сравнивает результаты запуска с целями по каналам, разбирает крупнейший промах и формирует решения для следующего запуска. Работает с ретроспективами D1, W1 и M1. CX Codex +1 1 100установок

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

Весь набор →
value-proposition Скилл value-proposition для Claude Code собирает ценностное предложение по шести частям с опорой на JTBD. Он разбирает сегмент клиентов, их задачу, текущее решение и альтернативы. CX Codex +1 ★ 741звёзд репо competitor-analysis Скилл competitor-analysis для Claude Code собирает отчёт по конкурентам и альтернативным решениям. Формирует профили пяти прямых игроков, находит слабые места и показывает точки дифференциации продукта. CX Codex +1 ★ 741звёзд репо growth-loops Скилл growth-loops для Claude Code разбирает, какие петли роста подходят продукту. Запросите оценку вирусного распространения, рекомендаций или совместной работы и план внедрения. CX Codex +1 ★ 741звёзд репо beachhead-segment Скилл beachhead-segment для Claude Code оценивает рынок и выбирает первый сегмент для запуска продукта. Сравнение учитывает остроту проблемы, готовность платить, долю, которую можно завоевать, и потенциал рекомендаций. CX Codex +1 ★ 741звёзд репо value-curve Скилл value-curve для Claude Code строит кривую ценности продукта для одного сегмента покупателей. Сравнение показывает, какие потребности закрыть лучше конкурентов и какую цену предложить. CX Codex +1 ★ 741звёзд репо document-app Скилл document-app для Claude Code, который описывает устройство приложения по его коду или сверяет документацию с реализацией. Запускается по просьбе документировать приложение или проверить точность его документов. CX Codex +1 ★ 741звёзд репо uptime-monitoring Скилл uptime-monitoring для Claude Code настраивает внешние проверки доступности приложения и оповещения. Запускается при публикации приложения, добавлении /health или cron-задачи и запросе о мониторинге. CX Codex +1 ★ 741звёзд репо performance-audit-static Скилл performance-audit-static для Claude Code проверяет производительность кода статически: ищет N+1-запросы, лишнюю загрузку данных, проблемы с индексами и кешированием. Запускается по запросу на аудит производительности. CX Codex +1 ★ 741звёзд репо

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

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