AGENT SKILL

code-reviewer-subagent

Піднімає рев'юера у ЧИСТОМУ контексті, що бачить ЛИШЕ git diff + AC PR, і повертає дискретний вердикт ACCEPT/WARN/PARTIAL/REJECT з обґрунтуванням. Тригери — '/code-reviewer-subagent', 'дай рев'юера в чистому контексті', 'субагент має оцінити diff проти AC', 'review this diff with fresh eyes'. НЕ вбудований '/code-review'.

License 许可
MIT
最近更新
2026-11-12
Stars
★ 15
Forks
13

01 前言 Front Matter

name
code-reviewer-subagent
description
Піднімає рев'юера у ЧИСТОМУ контексті, що бачить ЛИШЕ git diff + AC PR, і повертає дискретний вердикт ACCEPT/WARN/PARTIAL/REJECT з обґрунтуванням. Тригери — '/code-reviewer-subagent', 'дай рев'юера в чистому контексті', 'субагент має оцінити diff проти AC', 'review this diff with fresh eyes'. НЕ вбудований '/code-review'.
allowed-tools
Read, Glob, Bash, Task
argument-hint
[base-ref] (за замовч. main)
disable-model-invocation
false

03 SKILL.md 正文

code-reviewer-subagent — рев'юер у чистому контексті

Незалежний рев'юер для PR feat/reminders. Ідея — чистий контекст: субагент НЕ бачить ні нашого діалогу, ні решти кодбази, тільки git diff і acceptance criteria PR. Це усуває упередження «я ж щойно це писав» і дає чесний, відтворюваний вердикт. Не плутати з вбудованим /code-review — тут ми явно піднімаємо ізольований субагент через Task.

Acceptance criteria PR feat/reminders

  • AC-1 — remind [days] показує всі завдання з терміном у межах вікна, включно з тим, що випадає рівно на межу (due_in_days == days).
  • AC-2 — прострочені завдання теж потрапляють у нагадування.
  • AC-3 — desktop-сповіщення безпечне до будь-якої назви завдання (назва — недовірений ввід, у шелл її пускати не можна).

Кроки

  1. Bash: зібрати дифф — git diff main...HEAD (обмежити src/tasks/).
  2. Task: підняти субагент із чистим контекстом. У промпт кладемо РІВНО дві речі: повний текст AC вище і текст diff. Жодного іншого контексту.
  3. Субагент повертає один із чотирьох вердиктів і обґрунтування:
    • ACCEPT — diff виконує всі AC.
    • WARN — виконує, але є зауваження.
    • PARTIAL — частина AC виконана, частина ні.
    • REJECT — ключова AC не виконана.

Output

feat/reminders · code-reviewer-subagent
  Вердикт: REJECT
  Обґрунтування:
    - AC-1: due_within використовує строге `<`, тож завдання з due_in_days
      рівно == days випадає з вікна. Межа має бути інклюзивною (`<=`).
    - AC-3: notify_desktop підставляє title у os.system через шелл —
      command injection. Назву завдання не можна пускати в шелл.
  Що зробити: повернути `<= days`; перейти на subprocess.run([...], shell=False).

Після фіксу обох — повторний прогін має дати Вердикт: ACCEPT.

Anti-patterns

  • Не годуй субагенту весь репозиторій — суть у вузькому, неупередженому контексті.
  • Не повертай розмитих «ну майже» — вердикт дискретний.
  • Не плутай із вбудованим /code-review — тут явний ізольований субагент через Task.

04 同仓库更多 Skills

genkovich
genkovich/agentic-engineering-course-public

release

Run the whole local release pipeline in order, stopping at each human gate. Triggers on "run the release", "prepare a release", "/release", "зроби реліз", "підготуй реліз". Drives the four stages back to back — bump-version → curate-changelog → release-notes → check-docs-drift — pausing after each so the human reviews the diff before the next stage. Prepares everything in the working tree; never tags, commits, or pushes. The tag push (which fires CI) stays the human's action.

★ 15
genkovich
genkovich/agentic-engineering-course-public

release-notes

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.

★ 15
genkovich
genkovich/agentic-engineering-course-public

curate-changelog

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.

★ 15
genkovich
genkovich/agentic-engineering-course-public

codify-rule

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.

★ 15
genkovich
genkovich/agentic-engineering-course-public

check-docs-drift

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.

★ 15
genkovich
genkovich/agentic-engineering-course-public

bump-version

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.

★ 15