verify-ui
Verify a story's acceptance criteria through a LIVE browser run via playwright-cli (CLI-first, token-efficient). Triggers on '/verify-ui <story-id>' (e.g. '/verify-ui story-26'), or 'перевір UI у браузері', 'прокликай story через Playwright', 'розробка через Playwright'. Reads tasks/<story-id>.md, opens :5173, drives the scenario, reads real page state (DOM + computed styles), returns a per-AC pass/fail with a screenshot artefact. Does NOT fix code — only renders a verdict.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 15
- Forks
- 13
01 前言 Front Matter
- name
- verify-ui
- description
- Verify a story's acceptance criteria through a LIVE browser run via playwright-cli (CLI-first, token-efficient). Triggers on '/verify-ui <story-id>' (e.g. '/verify-ui story-26'), or 'перевір UI у браузері', 'прокликай story через Playwright', 'розробка через Playwright'. Reads tasks/<story-id>.md, opens :5173, drives the scenario, reads real page state (DOM + computed styles), returns a per-AC pass/fail with a screenshot artefact. Does NOT fix code — only renders a verdict.
- allowed-tools
- Read, Glob, Bash(playwright-cli:*), Bash(npx:*), Bash(npm:*)
- argument-hint
- <story-id> (e.g. story-26)
- disable-model-invocation
- false
03 SKILL.md 正文
verify-ui — перевірити AC story живим прогоном у браузері (CLI-first)
Браузерний канал зворотного зв'язку лекції 7.6. Ловить те, де детермінований гейт безсилий:
компілюється, юніт-тест зелений, а в живому браузері відступ з'їхав, стан не зберігається, поле
не реагує. Skill бере story з AC у форматі Given/When/Then і проганяє сценарій через
playwright-cli (не MCP) проти запущеного dev-сервера на :5173, читає справжній стан
сторінки і ставить вердикт.
Це self-contained дзеркало канонічного скіла
verify-uiз курсового sdlc-тулкіта (/sdlc-verify-ui). Тут — для демо, що працює без встановленого плагіна.
Команди playwright-cli задокументовані у сусідньому скілі .claude/skills/playwright-cli/
(встановлений через playwright-cli install --skills). Канонічна story цього каналу —
story-26 (EditCardForm): кнопка «Скасувати» має відступ 8px замість 12px за еталоном —
юніт і навіть Playwright-сценарій поведінки сліпі, бо форма зберігає/скасовує коректно; ловить
лише читання обчисленого стилю в живому прогоні.
Аргументи
<story-id>— ім'я файлу story без.md(напр.story-26). Шукається уtasks/.
Передумова (GATE)
Dev-сервер на :5173 (make dev або npm run dev). Якщо playwright-cli open http://localhost:5173 падає на конекті — не вигадуй стан, спочатку підніми сервер.
Кроки (цикл «відкрив → прочитав стан → виправив за фактом»)
- Read
tasks/<story-id>.md— витягни блоки AC (Given/When/Then). Перевіряй тільки те, що там є. - Відкрити:
playwright-cli open http://localhost:5173. - Зчитати стан:
playwright-cli snapshot— текстове дерево елементів із рефами (e21). Знайди елементи, на які посилаються AC (напр.[data-testid="cancel-button"]). - Для кожного AC відтвори When і прочитай Then із реального стану:
- дія:
playwright-cli click <ref>,type <text>,fill <ref> <text> --submit,press <key>; - перевірка стану:
playwright-cli eval "<js>"для обчислених стилів/значень (для story-26: прочитатиgetComputedStyle(document.querySelector('[data-testid=cancel-button]')).paddingLeft→ очікуємо12px, баг дає8px);snapshotдля DOM;reloadдля персистенції.
- дія:
- Доказ:
playwright-cli screenshot→ знімок прогону (уtmp/).
Output — дискретний вердикт по AC (evidence-before-assertion)
story-26 · verify-ui
AC-1 FAIL — paddingLeft кнопки «Скасувати» = 8px, еталон 12px (getComputedStyle)
AC-2 PASS — кнопка «Зберегти» й поля без змін
AC-3 PASS — форма зберігає й закривається коректно
Підсумок: FAIL (1/3). Доказ: tmp/story-26-after.png
Після фіксу (px-2 → px-3 у src/components/EditCardForm.tsx) повторний прогін → AC-1 PASS.
Acceptance criteria
- Вердикт прив'язаний до конкретних AC зі story-файлу, з фактичним vs очікуваним значенням,
прочитаним зі сторінки (
eval/snapshot), а не «на око». - Прогін через
playwright-cli(CLI), не Playwright MCP. - Є посилання на screenshot-доказ.
Anti-patterns
- Не вигадуй AC — лише те, що у story-файлі.
- Не «лагодь» код тут — skill лише ставить вердикт; фікс — окремий крок.
- Не рапортуй PASS без прочитаного стану — без
eval/snapshotце здогад, не доказ. - Не тягни Playwright MCP у цикл — CLI дешевший; MCP лиши на живий дебаг.
04 同仓库更多 Skills
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.
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.
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.
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.
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.
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.