القائمة
Run pre-commit validation before committing. Use for automated hooks, Terraform cleanup, or emoji reference. For simple commits, Claude's native capability suffices.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Validate a spec directory end-to-end — structural completeness, FR/SC counts, falsifiable success criteria, FR coverage in plan tasks, no stale CL-N references, and constitution compliance. Single gate before implementation.
Create a specification for non-trivial platform changes. Creates a GitHub issue anchored to a spec directory with the SDD template. Type is auto-inferred from the description; pass an explicit type to override.
Resolve [NEEDS CLARIFICATION] markers — present 2–3 structured options, append the chosen decision as a CL-N entry to clarifications.md, replace the marker in spec.md with the CL-N reference. Append-only — never overwrites prior deliberations.
Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic SDD spec detection. Uses templates/pr-body.md for structure.
Verify that a merged spec's success criteria (SC-XXX) are actually met in the live cluster. Deploys the example manifest, watches Flux reconciliation, queries VictoriaMetrics/VictoriaLogs for evidence, writes docs/specs/<dir>/VERIFICATION.md.
Research patterns, ecosystem tools, and best practices before filling a spec. Runs in a forked Explore subagent so it can query Context7, WebSearch, and the whole codebase without consuming the main context window. Writes docs/specs/NNN-slug/research.md.
| name | commit |
| description | Run pre-commit validation before committing. Use for automated hooks, Terraform cleanup, or emoji reference. For simple commits, Claude's native capability suffices. |
| disable-model-invocation | true |
| argument-hint | [--no-verify] - skip pre-commit hooks |
| allowed-tools | Read, Bash(git:*), Bash(pre-commit:*), Bash(uv:*), Bash(pip:*), Bash(find:*), Bash(source:*), Bash(SKIP=*:*) |
Run pre-commit validation and create well-formatted commits with conventional format.
For simple commits without hooks: use Claude's native git capability.
/commit # Run pre-commit, then commit
/commit --no-verify # Skip pre-commit hooks
No Co-Authored-By lines - per CLAUDE.md, never include co-authoring footers.
Automatic setup (silent, no user confirmation):
find . -type d \( -name ".terraform" -o -name ".terragrunt-cache" \) -exec rm -rf {} + 2>/dev/null
find . -name ".terraform.lock.hcl" -delete 2>/dev/null
uv venvuv pip install pre-commitpre-commit installRun validation:
pre-commit run --all-files
If checks fail: analyze errors, provide recommendations, stop commit process.
<emoji> <type>: <description>
| Type | Emoji | Use Case |
|---|---|---|
feat | ✨ | New feature |
fix | 🐛 | Bug fix |
docs | 📝 | Documentation |
refactor | ♻️ | Code restructuring |
perf | ⚡️ | Performance |
test | ✅ | Tests |
chore | 🔧 | Tooling/config |
ci | 🚀 | CI/CD |
security | 🔒️ | Security fixes |
See references/emoji-guide.md for full emoji list.
git commit -m "$(cat <<'EOF'
<emoji> <type>: <description>
[Optional body explaining why]
EOF
)"
| Category | Fix |
|---|---|
| Terraform validation | Run terraform init in affected directories |
| Formatting | Re-run pre-commit (auto-fixes many issues) |
| Security issues | Manual review required |
| KCL formatting | Run kcl fmt in module directory |
| YAML/JSON syntax | Manual correction needed |
| Large files | Remove or use Git LFS |
Stop commit process until issues are resolved.
✨ feat: add user authentication system
🐛 fix: resolve memory leak in rendering process
📝 docs: update API documentation with new endpoints
♻️ refactor: simplify error handling logic in parser
🔒️ fix: strengthen authentication password requirements
🚀 ci: add KCL validation to CI pipeline
🔧 chore: update Helm chart dependencies