メニュー
A skill for authoring high-quality, fast-iteration Pull Request descriptions for the db-explorer project. Generates a structured PR description following the Agile-Lean template.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/PenHsuanWang/db-explorer --skill pr-guideコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | pr-guide |
| description | A skill for authoring high-quality, fast-iteration Pull Request descriptions for the db-explorer project. Generates a structured PR description following the Agile-Lean template. |
To produce a well-structured, reviewer-friendly Pull Request description that minimizes review cycle time while preserving traceability and quality accountability. This skill targets the db-explorer project's fast-iteration workflow (Python 3.12 / FastAPI / React / Hexagonal Architecture).
Run this skill whenever you are about to open a PR and want Claude to draft or review the PR description. It is especially useful when:
DatabasePort interface or any connector adapter.CleaningEngine data flow.backend/ and web-ui/ layers.Before generating the description, collect:
#42 for GitHub, PROJ-123 for Jira/Bitbucket).feat, fix, refactor, chore, docs, test.backend/src/core/domainbackend/src/core/portsbackend/src/applicationbackend/src/adaptersweb-ui/srcpytest suite passed locally (cd backend && pytest tests/)ruff check passed (cd backend && ruff check src/ tests/)mypy --strict passednpm run lint passed (cd web-ui && npm run lint)npm run test (Vitest) passedDatabasePort interface, the CleaningEngine contract, or any public FastAPI endpoint schema?Use the template in the Template section below. Fill every mandatory field; mark optional fields as N/A only when genuinely not applicable.
Run through the Pre-Submission Checklist embedded in the template. Every unchecked item must be resolved or explicitly justified in the "Implementation Notes" section.
Copy the following block into your Pull Request description.
One or two sentences. Answer: what changed and why?
Closes [issue-reference]
Explain why this approach was chosen over alternatives. If a breaking change, describe the migration path. If a new connector adapter: confirm read-only enforcement and UniversalDataType normalization.
| Field | Mandatory | Guidance |
|---|---|---|
| Summary | Yes | Must state what changed and why. Do not restate the diff. |
| Closes [issue] | Yes | Use platform keywords (Closes, Fixes, Resolves) to auto-link/close the issue. |
| Type of Change | Yes | Select exactly one; if multiple apply, split into separate PRs. |
| Affected Layers | Yes | Helps reviewers scope their focus; hexagonal layer boundaries are strict. |
| Implementation Notes | Yes | Required for breaking type; optional but strongly recommended for all others. |
| Automated Checks | Yes | Every box must be checked. Do not open a PR with failing CI. |
| Manual Verification Steps | Yes | At minimum two concrete steps the reviewer can execute. |
| Read-Only Safety | Conditional | Required whenever adapters/, ports/, or application/ is modified. |
| Pre-Submission Checklist | Yes | All boxes must be checked before requesting review. |
Format: type(scope): subject
Examples:
| Script | Purpose |
|---|---|
| cd backend && pytest tests/ | Run full backend test suite |
| cd backend && ruff check src/ tests/ | Lint backend Python code |
| cd backend && mypy --strict | Type-check backend |
| cd web-ui && npm run lint | Lint frontend TypeScript/React |
| cd web-ui && npm run test | Run Vitest frontend suite |
| docker-compose up -d | Start full stack for manual verification |
| skills/agent-architect/scripts/lint_check.sh | Consolidated backend quality check |
| skills/db-explorer-architect/scripts/lint_backend.sh | Detailed backend lint + test |
| skills/db-explorer-architect/scripts/lint_frontend.sh | Detailed frontend lint + test |
Architect and develop the DB Explorer project with Python backend and React frontend following hexagonal architecture
A meta-skill for designing, scaffolding, and implementing new Claude Code Agents/Skills.
Comprehensive Python backend development guide with CI/CD workflows, testing, documentation, and best practices using uv, flake8, mypy, pytest, and Sphinx.