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

agentic-walkthrough — скилл для Claude Code: проверка выполнения

Скилл agentic-walkthrough для Claude Code проверяет, что успешный запуск действительно изменил данные или вызвал нужное действие. Он проходит путь от точки входа до результата и ищет наблюдаемый след каждого шага.

Apache-2.0 ★ 869 обновлён 2026-11-16

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

Что делает agentic-walkthrough

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

Затем он подбирает узкие проверки: например, смотрит изменённые записи, путь к базе, содержимое ответа API или состояние дочернего процесса. Итог должен содержать измеримый результат и строки кода, где выполняются действия. Нулевой результат означает, что путь не доказан. Для работы нужны инструменты оболочки и чтения-записи файлов.

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

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

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

  • Проверь, что задача действительно изменила нужные записи, и покажи путь выполнения.
  • Проследи обработчик от точки входа до файла, который читает следующий этап.
  • Установи, отправлялись ли API-запросы и что было в ответах.

Как установить agentic-walkthrough

1Через Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill agentic-walkthrough -a claude-code

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

~/.claude/skills/agentic-walkthrough/SKILL.md

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

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

Вопросы об agentic-walkthrough

Как установить agentic-walkthrough в Claude Code?

Выполни npx skills add sno-ai/sno-station-skills --skill agentic-walkthrough -a claude-code. Файл скилла находится по пути ~/.claude/skills/agentic-walkthrough/SKILL.md.

Что делает agentic-walkthrough?

Он прослеживает выполнение от точки входа до реального эффекта и проверяет каждый важный шаг отдельным наблюдаемым признаком. В отчёте указывает измеримый результат и строки кода, которые его вызвали.

Какие инструменты нужны для работы agentic-walkthrough?

Нужны инструменты оболочки и чтения-записи файлов.

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

SKILL.md · Apache-2.0
---
name: agentic-walkthrough
description: "Prove that a reported run caused its intended real effect. Walk the executor path from entry to effect, capture one observable per hop, and report a result a no-op could not produce."
requires:
  programs: []
  harness:
    - {slot: 4.shell, need: required}
    - {slot: 4.file-read-write, need: required}
---

# Agentic Walkthrough — take the program's seat

The stance is the whole method. You are not a reviewer standing outside the code with a
checklist; you are the thing the source describes — the job, the stage, the handler — and
you run it in your head, hop by hop, exactly as it would run, noticing every switch you pass
and every place your output goes. Only then do you turn to the real system and make it show
you that what you just walked actually happened. The principle: BE the executor, then make the
executor prove itself.

Ordinary debugging starts from a failure — an error, a red test, a wrong number. This starts from
the opposite and much quieter case: **everything reports success and you still do not know whether
the work happened.**

That case is real and it is not rare. A stage that cannot do its work can still report `done`. A
job can start, finish, write a trace, and pass its own verification while touching nothing. No
test suite catches this, because no assertion in the suite is false.

Three moves, in order. How far to take each is your judgment — often the first cannot finish
without the ones after it.

## 1. Walk the path — be the program, read, don't run

Put yourself where the code sits and go hop by hop from entry point to effect. You are reading,
not executing, which is the whole point: a live run cannot show you the branch it never took.

Three questions at each hop are usually enough:

- **What switch controls this hop, and what is its value right now?** A config key, an env var, a
  feature flag, a job type, a default argument.
- **If that switch is off, does it fail loud or continue quiet?** Quiet defaults are where these
  bugs live. Loud failures are already visible — you are hunting the silent ones.
- **What does this hop actually do — which line?** If you cannot name the line, you have not
  shown the hop does anything.

**The last hop is the one everyone skips and it is usually the decisive one: is this output
visible to whatever consumes it downstream?** A stage that runs perfectly and writes where nothing
reads is indistinguishable from a stage that never ran. Check the reader's path, not the writer's
— they are frequently not the same file, the same directory, or the same database.

Where to start and how deep to go is judgment. Go where the switches are dense, or where the
evidence gets thin.

## 2. Probe every hop that has to be real

The walk tells you which hops matter. A probe is how you make one of them prove itself.

**Keep each probe narrow: one observable that only the real thing could have produced.** A broad
health check is worth little here, because everything passes it — that is the whole problem. The
walk already told you what this hop is supposed to do; probe exactly that.

These classes come up again and again, and each fails in a way that looks fine from the caller's
side. Treat them as places to look, not a checklist to complete.

- **Stored state — the rows themselves.** Take a concrete failing case and pull out the actual
  record behind it. A log says a write happened; only the row can distinguish a correct write from
  one that hit the wrong record, wrote the wrong value, or was counted but never committed.
  Landed → the defect is downstream. Did not land → the write logic is wrong, and nothing built on
  top of it is worth tuning. **Expect to need the product's own accessor** — encryption, a key
  held elsewhere, a custom codec. A generic CLI failing to open the store is normal, not a wall.
- **Database identity.** Which file did the process actually open — resolve the real path — and is
  it the same one the reader queries? Path resolution usually consults several sources in an order
  nobody remembers, and the first one wins.
- **Model and API calls.** Did a request actually leave? How many, to which endpoint, under which
  model or account? Then the part usually skipped: **does the response contain what the caller
  assumes?** A 200 with an empty body sails through an `if (ok)` check. Zero calls is the loudest
  possible answer and the easiest one to miss.
- **Accelerator and environment setup.** A path that silently falls back to CPU still finishes,
  just differently. Ask which device the work actually landed on, not whether setup returned
  without error. Same shape for any "configure, then hope" step.
- **File input and output.** Did the bytes land where the consumer looks? A temp directory that
  gets cleaned, a relative path resolved from a different working directory, an output written
  somewhere nothing reads — all of these leave a successful write behind.
- **Child processes and third-party services.** Did it actually start, is the thing you matched
  actually it, is it listening, and did it stay up — or exit a second later while the parent
  carried on?

## 3. Report a number, not an impression

This is the one part worth being strict about, because it is what separates a gate from a reading
exercise.

**Finish with a number a no-op could not have produced, plus the line where each action happens.**
*N rows changed, M requests sent, and here is where I can see those N rows differ.*

- **Zero is a failure of the walk, not a result.** It means you found the path broken.
- **"The walk went well" is not a finding.** Neither is a summary with the numbers dropped.
- **If you cannot name the line, that action is not proven to run.**

## Before any absence becomes a finding, check your instrument

Most wrong conclusions here come from a check that could never have said anything else. **Prove
your check could have produced the other answer** — feed it a case you know is positive and watch
it fire. Shapes this actually takes:

- `grep -c` against a path that does not exist returns `0`, identical to a real file with no
  matches. Confirm the path exists before the count means anything.
- A process match can match the wrong process: a wrapper, a script that names your target as an
  argument, or your own shell.
- A progress check can range over the wrong quantity and read as stalled while the job is healthy.
- **Timestamps are asymmetric.** An *unchanged* modification time is strong evidence nothing
  touched the file. A *changed* one is evidence of almost nothing — opening a store,
  checkpointing, or migrating a schema all touch the file without doing the work you are after.
<!-- reminders:start -->
<!-- reminders:end -->

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

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

Каталог скиллов SKILL.md →
firecrawl-demo-walkthrough firecrawl Скилл firecrawl-demo-walkthrough проводит агента по ключевым потокам чужого продукта через браузер Firecrawl и собирает разбор в markdown: экраны, действия, точки трения. CX Codex +1 31 400установок bmad-walkthrough bmad-code-org Скилл bmad-walkthrough для Claude Code, который проводит человека по ревью коммита, PR, файла или директории. Вызывается по имени и запускает пошаговый воркфлоу через скрипт BMad. CX Codex +1 17 000установок review-walkthrough trailofbits Скилл review-walkthrough собирает из диффа текущей ветки HTML-страницу с пошаговым разбором изменений и замечаниями по коду. Вызывается вручную, когда нужно пройти ревью глазами. CX Codex +1 1 200установок cognitive-walkthrough mastepanoski Скилл cognitive-walkthrough прогоняет конкретный пользовательский сценарий по методу когнитивного обхода и показывает, где новичок застрянет. Пригодится до юзабилити-теста. CX Codex +1 525установок skill-creation-walkthrough rampstackco Скилл skill-creation-walkthrough для Claude Code пошагово помогает спроектировать скилл, оформить SKILL.md, разложить references и проверить срабатывание. Помогает создавать скиллы для повторяемых рабочих процессов. CX Codex +1 270установок pr-walkthrough tldraw Скилл pr-walkthrough для Claude Code собирает видеоролик с разбором пуллреквеста, слайдами кода и синтезированной озвучкой. Ролик наглядно объясняет коллегам изменения в PR. CX Codex +1 226установок

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

Весь набор →
rust-coder Скилл rust-coder для Claude Code помогает писать и менять код на Rust с учётом устройства репозитория. Включается для новых функций, рефакторинга и миграций, в том числе при крупных изменениях .rs и Cargo.toml. CX Codex +1 ★ 869звёзд репо python-coder Скилл python-coder для Claude Code помогает писать и перерабатывать production-код на Python, включая FastAPI и Pydantic. Подключается к задачам с асинхронным кодом и миграциями. CX Codex +1 ★ 869звёзд репо owner-intent-audit Скилл owner-intent-audit для Claude Code сверяет планы, тесты и код с намерением владельца проекта. Запускается перед одобрением или слиянием изменений. CX Codex +1 ★ 869звёзд репо less-is-more Скилл less-is-more для Claude Code помогает писать меньше кода и находить лишнее в готовых изменениях. Включается при разработке, исправлении, рефакторинге и ревью кода. CX Codex +1 ★ 869звёзд репо first-principles-review Скилл first-principles-review для Claude Code проверяет продуктовые идеи, PRD и архитектуру от первых принципов. Он запускается только по прямому запросу с названием скилла и создаёт локальный отчёт с передачей для написания PRD. CX Codex +1 ★ 869звёзд репо e2e-red-triage Скилл e2e-red-triage для Claude Code классифицирует неожиданный сбой E2E-теста как дефект продукта или проблему окружения. Загружайте его вручную, когда запускатель тестов назвал конкретный сбой. CX Codex +1 ★ 869звёзд репо e2e-environment-preflight Скилл e2e-environment-preflight для Claude Code проверяет внешние зависимости перед сквозным тестированием. Он запускается только по прямому запросу или по указанным сценариям работы с планом и тестами. CX Codex +1 ★ 869звёзд репо charter Помогает написать, изменить или проверить charter — документ с результатом работы, границами задачи и проверками. Запускается, когда перед передачей работы исполнителю нужен письменный план. CX Codex +1 ★ 869звёзд репо

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

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