القائمة
Quick pre-flight validation of staged and unstaged changes before committing. Lighter than the verifier/code-reviewer agents — focuses on catching common mistakes in the current changeset.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Write comprehensive tests using project conventions: AAA pattern, edge-case checklist, httpx.MockTransport, conftest fixtures, parametrize where it reads better than copy-paste.
Audit Prefab UI card builders (`build_*_ui` in `katana_mcp_server/src/katana_mcp/tools/prefab_ui.py`) for user-centric content: real names over IDs, no redundant text dumps, named helpers over ad-hoc rendering. Reports findings; does not modify code. Use when reviewing card UX or after touching `prefab_ui.py`.
Groom the Rolling Backlog (project #5) by reading current state and proposing diffs — not re-deriving the queue from scratch. Surfaces drift between issue state and project status, missing classification, and stale priorities. Asks per-category confirmation before mutating the board.
Scan editable code for tech debt, anti-patterns, and improvement opportunities across 5 categories. Reports findings; the code-modernizer agent applies fixes.
Open a PR for the current feature branch — self-review the diff, organize commits, push, create the PR, wait for CI and review, then address feedback. Use when implementation is complete and ready for review.
Address PR review comments — fetch all unresolved comments, fix the issues, validate with `uv run poe check`, commit, push, and reply to each comment on GitHub. Use when asked to handle PR review feedback.
| name | pre-commit |
| description | Quick pre-flight validation of staged and unstaged changes before committing. Lighter than the verifier/code-reviewer agents — focuses on catching common mistakes in the current changeset. |
| allowed-tools | ["Read","Grep","Glob","Bash(uv run poe agent-check)","Bash(uv run poe quick-check)","Bash(git status)","Bash(git diff *)","Bash(git log *)"] |
Fast pre-flight before git commit — catches mistakes the editor missed.
--no-verify, noqa, or type: ignore to make this pass.api/**/*.py, models/**/*.py, client.py outside of regeneration is wrong.uv run poe agent-check
If this fails, stop. Fix and re-run. Don't commit on red.
git diff
git diff --cached
Look for:
api/**/*.py, models/**/*.py, client.py) without spec changeCLAUDE.md "Known Pitfalls" and katana_public_api_client/docs/guide.md "Response Handling" sectionIf new or changed code is in the diff, check that the corresponding test files were also modified or created. Flag any new functions without test coverage.
If a message is provided, verify conventional format: type(scope): description. Valid types: feat, fix, docs, style, refactor, test, chore, build, ci, perf. Valid scopes: client, mcp, or none.
## Pre-Commit Report
### Status: [PASS | FAIL]
### Validation: [PASS/FAIL]
[details if failed]
### Anti-Pattern Scan: [PASS/FAIL]
[findings]
### Test Coverage: [PASS/FAIL]
[uncovered changes]
### Commit Format: [PASS/FAIL]
[issues]
verifier agent — heavier final pre-PR gate/review skill — full branch review (slower)code-modernizer agent — actively rewrites anti-patterns