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

gstack-openclaw-retro — скилл для Claude Code: что делает и установка

Скилл gstack-openclaw-retro формирует инженерную ретроспективу по коммитам в git: считает сессии, соотношение тестов, частые зоны правок и вклад каждого участника команды.

MIT 314 установок ★ 142 291 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add garrytan/gstack --skill gstack-openclaw-retro -a claude-code
Открыть на GitHub

Что делает gstack-openclaw-retro

Скилл выгружает историю ветки origin/main за последние 7 дней (либо за 24 часа, 14 или 30 дней) и определяет текущего пользователя через git config user.name. Он строит лидерборд авторов, считает изменения строк, долю правок в тестах и находит самый крупный мерж за период. Если репозиторий ведёт один человек, блок командного анализа опускается.

Сессии работы группируются по паузам: если между коммитами прошло больше 45 минут, скилл считает это новой сессией. Отдельно выводятся файлы с частыми правками, распределение коммитов по часам и префиксы conventional commits. Если доля правок fix превышает 50%, скилл обратит на это внимание как на признак частых исправлений после релиза.

Для работы обязательно наличие ветки origin/main, иначе команда git fetch завершится ошибкой. Статистика строится строго по истории git, поэтому незакоммиченные файлы в отчёт не попадут.

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

  • составить ретроспективу спринта по истории коммитов
  • найти файлы с наибольшим количеством частых правок
  • оценить соотношение кода тестов к общему объёму изменений
  • посчитать непрерывные серии дней с коммитами для команды

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

  • Сделай инженерную ретроспективу за последнюю неделю
  • Покажи отчёт по коммитам за 14d с аргументом compare
  • Собери статистику того, что мы замержили за 24h

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

1Через Skills CLI (Vercel)

npx skills add garrytan/gstack --skill gstack-openclaw-retro -a claude-code

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

~/.claude/skills/gstack-openclaw-retro/SKILL.md

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

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

Вопросы о gstack-openclaw-retro

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

Выполните команду npx skills add garrytan/gstack --skill gstack-openclaw-retro -a claude-code. Также можно разместить файл вручную по пути ~/.claude/skills/gstack-openclaw-retro/SKILL.md.

Что делает gstack-openclaw-retro?

Скилл скачивает историю origin/main и рассчитывает метрики разработки: активность команды, размер пулл-реквестов, тестовое покрытие коммитов и распределение работы по часам.

Как скилл определяет сессии кодинга?

Он связывает последовательные коммиты одного автора с порогом в 45 минут. Если пауза больше, скилл открывает новую сессию и делит их на короткие, средние и глубокие.

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

SKILL.md · MIT
---
name: gstack-openclaw-retro
description: "Weekly engineering retrospective. Analyzes commit history, work patterns, and code quality metrics with persistent history and trend tracking. Team-aware with per-person contributions, praise, and growth areas. Use when asked for weekly retro, what shipped this week, or engineering retrospective."
---

# Weekly Engineering Retrospective

Generates a comprehensive engineering retrospective analyzing commit history, work patterns, and code quality metrics. Team-aware: identifies the user running the command, then analyzes every contributor with per-person praise and growth opportunities.

## Arguments

- Default: last 7 days
- `24h`: last 24 hours
- `14d`: last 14 days
- `30d`: last 30 days
- `compare`: compare current window vs prior same-length window

## Instructions

Parse the argument to determine the time window. Default to 7 days. All times should be reported in the user's **local timezone**.

**Midnight-aligned windows:** For day units, compute an absolute start date at local midnight. For example, if today is 2026-03-18 and the window is 7 days, the start date is 2026-03-11. Use `--since="2026-03-11T00:00:00"` for git log queries. For hour units, use `--since="N hours ago"`.

---

### Step 1: Gather Raw Data

First, fetch origin and identify the current user:

```bash
git fetch origin main --quiet
git config user.name
git config user.email
```

The name returned by `git config user.name` is **"you"** ... the person reading this retro. All other authors are teammates.

Run ALL of these git commands (they are independent):

```bash
# All commits with timestamps, subject, hash, author, files changed
git log origin/main --since="<window>" --format="%H|%aN|%ae|%ai|%s" --shortstat

# Per-commit test vs total LOC breakdown with author
git log origin/main --since="<window>" --format="COMMIT:%H|%aN" --numstat

# Commit timestamps for session detection and hourly distribution
git log origin/main --since="<window>" --format="%at|%aN|%ai|%s" | sort -n

# Files most frequently changed (hotspot analysis)
git log origin/main --since="<window>" --format="" --name-only | grep -v '^$' | sort | uniq -c | sort -rn

# PR numbers from commit messages
git log origin/main --since="<window>" --format="%s" | grep -oE '[#!][0-9]+' | sort -t'#' -k1 | uniq

# Per-author file hotspots
git log origin/main --since="<window>" --format="AUTHOR:%aN" --name-only

# Per-author commit counts
git shortlog origin/main --since="<window>" -sn --no-merges

# Test file count
git ls-files 2>/dev/null | grep -E '(\.test\.|\.spec\.|_test\.|_spec\.)' | wc -l

# Test files changed in window
git log origin/main --since="<window>" --format="" --name-only | grep -E '\.(test|spec)\.' | sort -u | wc -l
```

---

### Step 2: Compute Metrics

Calculate and present these metrics in a summary:

- **Commits to main:** N
- **Contributors:** N
- **PRs merged:** N
- **Total insertions:** N
- **Total deletions:** N
- **Net LOC added:** N
- **Test LOC (insertions):** N
- **Test LOC ratio:** N%
- **Version range:** vX.Y.Z → vX.Y.Z
- **Active days:** N
- **Detected sessions:** N
- **Avg LOC/session-hour:** N

Then show a **per-author leaderboard** immediately below:

```
Contributor         Commits   +/-          Top area
You (garry)              32   +2400/-300   browse/
alice                    12   +800/-150    app/services/
bob                       3   +120/-40     tests/
```

Sort by commits descending. The current user always appears first, labeled "You (name)".

---

### Step 3: Commit Time Distribution

Show hourly histogram in local time:

```
Hour  Commits  ████████████████
 00:    4      ████
 07:    5      █████
 ...
```

Identify:
- Peak hours
- Dead zones
- Bimodal pattern (morning/evening) vs continuous
- Late-night coding clusters (after 10pm)

---

### Step 4: Work Session Detection

Detect sessions using **45-minute gap** threshold between consecutive commits.

Classify sessions:
- **Deep sessions** (50+ min)
- **Medium sessions** (20-50 min)
- **Micro sessions** (<20 min, single-commit)

Calculate:
- Total active coding time
- Average session length
- LOC per hour of active time

---

### Step 5: Commit Type Breakdown

Categorize by conventional commit prefix (feat/fix/refactor/test/chore/docs). Show as percentage bar:

```
feat:     20  (40%)  ████████████████████
fix:      27  (54%)  ███████████████████████████
refactor:  2  ( 4%)  ██
```

Flag if fix ratio exceeds 50% ... signals a "ship fast, fix fast" pattern that may indicate review gaps.

---

### Step 6: Hotspot Analysis

Show top 10 most-changed files. Flag:
- Files changed 5+ times (churn hotspots)
- Test files vs production files in the hotspot list
- VERSION/CHANGELOG frequency

---

### Step 7: PR Size Distribution

Estimate PR sizes and bucket them:
- **Small** (<100 LOC)
- **Medium** (100-500 LOC)
- **Large** (500-1500 LOC)
- **XL** (1500+ LOC)

---

### Step 8: Focus Score + Ship of the Week

**Focus score:** Percentage of commits touching the single most-changed top-level directory. Higher = deeper focused work. Lower = scattered context-switching.

**Ship of the week:** The single highest-LOC PR in the window. Highlight PR number, LOC changed, and why it matters.

---

### Step 9: Team Member Analysis

For each contributor (including the current user), compute:

1. **Commits and LOC** ... total commits, insertions, deletions, net LOC
2. **Areas of focus** ... which directories/files they touched most (top 3)
3. **Commit type mix** ... their personal feat/fix/refactor/test breakdown
4. **Session patterns** ... when they code (peak hours), session count
5. **Test discipline** ... their personal test LOC ratio
6. **Biggest ship** ... their single highest-impact commit or PR

**For the current user ("You"):** Deepest treatment. Include all session analysis, time patterns, focus score. Frame in first person.

**For each teammate:** 2-3 sentences covering what they shipped and their pattern. Then:

- **Praise** (1-2 specific things): Anchor in actual commits. Not "great work" ... say exactly what was good.
- **Opportunity for growth** (1 specific thing): Frame as leveling-up, not criticism. Anchor in actual data.

**If solo repo:** Skip team breakdown.

**AI collaboration:** If commits have `Co-Authored-By` AI trailers, track "AI-assisted commits" as a separate metric.

---

### Step 10: Week-over-Week Trends (if window >= 14d)

Split into weekly buckets and show trends:
- Commits per week (total and per-author)
- LOC per week
- Test ratio per week
- Fix ratio per week
- Session count per week

---

### Step 11: Streak Tracking

Count consecutive days with at least 1 commit, going back from today:

```bash
# Team streak
git log origin/main --format="%ad" --date=format:"%Y-%m-%d" | sort -u

# Personal streak
git log origin/main --author="<user_name>" --format="%ad" --date=format:"%Y-%m-%d" | sort -u
```

Display both:
- "Team shipping streak: 47 consecutive days"
- "Your shipping streak: 32 consecutive days"

---

### Step 12: Load History & Compare

Check for prior retro history in `memory/`:

If prior retros exist, load the most recent one and calculate deltas:

```
                    Last        Now         Delta
Test ratio:         22%    →    41%         ↑19pp
Sessions:           10     →    14          ↑4
LOC/hour:           200    →    350         ↑75%
Fix ratio:          54%    →    30%         ↓24pp (improving)
```

If no prior retros exist, note "First retro recorded, run again next week to see trends."

---

### Step 13: Save Retro History

Save a JSON snapshot to `memory/retro-YYYY-MM-DD.json` with metrics, authors, version range, streak, and tweetable summary.

---

### Step 14: Write the Narrative

**Format for Telegram** (bullets, bold, no markdown tables in the final output).

Structure:

**Tweetable summary** (first line):
> Week of Mar 1: 47 commits (3 contributors), 3.2k LOC, 38% tests, 12 PRs, peak: 10pm | Streak: 47d

Then sections:

- **Summary** ... key metrics
- **Trends vs Last Retro** ... deltas (skip if first retro)
- **Time & Session Patterns** ... when the team codes, session lengths, deep vs micro
- **Shipping Velocity** ... commit types, PR sizes, fix-chain detection
- **Code Quality Signals** ... test ratio, hotspots, churn
- **Focus & Highlights** ... focus score, ship of the week
- **Your Week** ... personal deep-dive for the current user
- **Team Breakdown** ... per-teammate analysis with praise + growth (skip if solo)
- **Top 3 Team Wins** ... highest-impact things shipped
- **3 Things to Improve** ... specific, actionable, anchored in commits
- **3 Habits for Next Week** ... small, practical, realistic (<5 min to adopt)

---

## Compare Mode

When the user says "compare":
- Run the retro for the current window
- Run the retro for the prior same-length window
- Present side-by-side metrics with arrows showing improvement/regression
- Brief narrative on biggest changes

---

## Important Rules

- **All times in local timezone.** Never set `TZ`.
- **Format for Telegram.** Use bullets and bold. Avoid markdown tables in the final output.
- **Praise anchored in commits.** Never say "great work" without naming what was good.
- **Growth areas anchored in data.** Never criticize without evidence.
- **Save history.** Every retro saves to `memory/` for trend tracking.
- **Completion status:**
  - DONE ... retro generated, history saved
  - DONE_WITH_CONCERNS ... generated but missing data (e.g., no prior retros for comparison)
  - BLOCKED ... not in a git repo or no commits in window

© garrytan · MIT · garrytan/gstack

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

Все скиллы по теме «Git и GitHub» →
groove-utilities-memory-retrospective andreadellacorte Скилл groove-utilities-memory-retrospective для Claude Code собирает по .groove/memory/ ретроспективу: оценивает динамику сессий, находит повторяющиеся сбои и выводит сводку в чат. Для недельных разборов. CX Codex +1 517установок retrospective-analyzer davila7 Команда retrospective-analyzer анализирует спринты разработчиков по коммитам Git и задачам из Linear. Помогает разобрать итоги и сформировать список задач. CX Codex +1 196установок game-postmortem AlterLab-IEU Скилл game-postmortem для Claude Code, Codex и Cursor проводит постмортем релизнутой, отменённой или завершившей крупную фазу игры. Собирает метрики из Git, ретро и отчётов, архивируя выводы в production/milestones/. CX Codex +1 ★ 57звёзд репо om-pipeline-retro open-mercato Скилл om-pipeline-retro анализирует завершённые прогоны пайплайна, находит причины повторных попыток и считает потерянные часы. Пригодится на ретроспективе разработки. CX Codex +1 3 100установок printing-press-retro mvanhorn Скилл printing-press-retro проводит ретроспективу после сборки CLI в Printing Press. Он находит дефекты генератора и оформляет отчёт с черновиками задач для GitHub. CX Codex +1 6 800установок retro phuryn Скилл retro помогает фасилитировать ретроспективу спринта, разобрать успехи и проблемы команды, а также составить приоритизированный список действий с ответственными и сроками. CX Codex +1 2 900установок

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

Весь набор →
landing-report Скилл landing-report для Claude Code показывает очередь версий и занятые слоты релизов в параллельных воркспейсах. Работает в режиме чтения через утилиту gstack-next-version без изменения файлов. CX Codex +1 336установок scrape Скилл scrape для Claude Code вытаскивает данные со страницы через браузер Aside, где вход в сервисы уже выполнен. Запускается на просьбе вроде «собери данные с этой страницы». CX Codex +1 335установок gstack-openclaw-office-hours Скилл gstack-openclaw-office-hours проводит сессию YC Office Hours для проверки идеи и формулирования требований. Он запрещает агенту писать код и выдаёт готовый дизайн-документ. CX Codex +1 327установок document-generate Скилл document-generate для Claude Code создаёт документацию для функции, модуля или всего проекта. Запускается по просьбе написать документацию или объяснить код. CX Codex +1 319установок gstack-openclaw-ceo-review Скилл gstack-openclaw-ceo-review заставляет агента разобрать план как CEO: оспорить постановку задачи, найти слабые места и решить, расширять объём или сокращать. CX Codex +1 318установок hackernews-frontpage Скилл hackernews-frontpage снимает главную Hacker News и отдаёт 30 верхних историй в JSON: заголовок, ссылка, очки, число комментариев. CX Codex +1 311установок gstack-openclaw-investigate Скилл gstack-openclaw-investigate ведёт агента через отладку по шагам: сначала первопричина и проверка гипотезы, потом минимальный фикс с регрессионным тестом и отчёт. CX Codex +1 302установок diagram Скилл diagram для Claude Code превращает описание или Mermaid-код в набор файлов диаграммы. Запускается по просьбе сделать, нарисовать или визуализировать схему. CX Codex +1 266установок

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

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