菜单
Use when running Step 2 of legacy refactoring protocol — extracts a 6-section summary of a legacy module via parallel subagents per file. Triggers on '/legacy-extract <module>' or when user asks to 'витягти legacy', 'extract legacy module', 'дослідити старий код через subagents'.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | legacy-extract |
| description | Use when running Step 2 of legacy refactoring protocol — extracts a 6-section summary of a legacy module via parallel subagents per file. Triggers on '/legacy-extract <module>' or when user asks to 'витягти legacy', 'extract legacy module', 'дослідити старий код через subagents'. |
| argument-hint | <module-name> (e.g. account) |
| allowed-tools | Read, Grep, Glob, Bash, Task |
| disable-model-invocation | false |
Один subagent на один великий файл, кожен повертає 6-секційне резюме на ≤2k токенів. Main agent агрегує результати у LEGACY/<module>.md.
<module-name> — імʼя нового модуля (наприклад account). Файли беруться з internal/users/ (legacy) або з шляху, описаного у SPIKE.md.Перш ніж запускати subagents, обери стратегію за шириною/щільністю модуля:
grep -E "^def [a-z]" internal/users/*.py → один subagent на одну entry-функцію + її pull-через-call граф.register, verify, reset) — один subagent на use case, незалежно від кількості файлів.Стратегію зафіксуй у першому рядку LEGACY/<module>.md: «Стратегія: entry-points / per-usecase / dependency-SCC».
Read $FILE_PATH в ізольованій сесії. Поверни Markdown з шістьма секціями:
1. Що файл робить назовні — public methods, exports
2. Залежності — imports, calls до інших модулів і external services
3. Сховані звʼязки — globals, dynamic calls, reflection, cache pollution
4. 5-10 прикладів вхід → вихід через public methods
5. Підозріле — гіпотези «чому тут зроблено так дивно» (≥2 hypotheses!)
6. Що треба для тестів — mocks, fixtures, env
Обмеження: ≤2k токенів, без фрагментів коду довших за 5 рядків.
# LEGACY/<module>.md
Стратегія розподілу: <entry-points|per-usecase|dependency-SCC>
## 1. Що модуль робить назовні
- ...
## 2. Залежності
- зовнішні: ...
- внутрішні: ...
## 3. Сховані звʼязки
- ...
## 4. Приклади вхід → вихід
1. ...
2. ...
## 5. Підозріле (гіпотези)
- ...
- ...
## 6. Що треба для тестів
- ...
LEGACY/<module>.md ≤ 3k токенів (агрегат усіх subagent виходів)internal/users/*.py — тільки subagent summaries/legacy-extract account
→ запускає 4 паралельні subagents (per-file для users-модуля), агрегує їхні виходи у LEGACY/account.md за 3-5 хв.
Prepare and verify the repository files required to deploy this Next.js project to one Ubuntu VPS with Docker Compose and a GitHub self-hosted runner. Use when creating or reviewing Dockerfile.production, compose.vps.yml, the health route, persistent SQLite storage, or deploy-vps.yml before a VPS release.
Decide and apply the next semver for a release. Triggers on "bump the version", "what version is next", "/bump-version", "простав версію", "яка наступна версія". Reads the next number from the deterministic scripts/next-version.sh (NEVER guesses it), explains in plain language WHICH part moved and why (e.g. "MINOR, because a feat landed: filter notes by tag"), edits the version line in pyproject.toml, and proposes the matching `git tag vX.Y.Z`. The number is decided by a rule; the agent explains and applies — the human confirms the tag. Never pushes a tag itself.
Find and fix where docs/api.md fell behind the code. Triggers on "check for doc drift", "is the API doc up to date", "/check-docs-drift", "перевір дрейф документації", "docs drift". Runs the deterministic scripts/check-docs-drift.py (parses the public NoteBook methods with ast, compares to what docs/api.md documents — NO LLM finds the gap), reports the drift, and PROPOSES the doc edit that closes it. The gap is found by parsing; the agent writes the missing documentation in the doc's existing style. Edits only docs/; never commits or pushes.
Turn a repeated mistake into a durable, path-scoped rule in .claude/rules/. Triggers on "codify this rule", "make a rule so this doesn't happen again", "/codify-rule", "закодифікуй правило", "петля помилка-правило". Use only when the same mistake showed up TWICE (twice = a pattern, once = noise). Names the wrong shape and the right shape with one short example of each, scopes the rule to the paths that matter, and leaves the edit in the working tree so the next agent on this repo inherits the fix. Edits only .claude/rules/; never commits or pushes.
Curate the [Unreleased] section of docs/CHANGELOG.md from git history. Triggers on "curate the changelog", "update the changelog", "/curate-changelog", "онови changelog", "курування журналу". Reads git log since the last tag, FILTERS out what a reader never feels (test/ci/chore/merge), GROUPS commits about one feature into one bullet, and REWRITES technical subjects into plain language under the six Keep a Changelog categories (Added/Changed/Deprecated/ Removed/Fixed/Security). The result must have FEWER lines than the raw log — that is the proof of curation, not a dump. Leaves the edit in the working tree; never commits or pushes.
Draft partner-facing release notes from the same commits as the changelog. Triggers on "draft release notes", "release notes for the next version", "/release-notes", "нотатки релізу", "release notes партнеру". Same input as curate-changelog, different audience and tone: a short, benefit-first narrative for a user or partner — "what's new for you" — not a categorized engineer's list. Keeps only changes a user actually notices; drops internal refactors and tooling. Prints the notes to the chat to seed a GitHub Release description or a partner announcement. Writes no file.