菜单
Smoke-test all enforcement hooks by feeding known good and bad inputs and verifying exit codes. Tests the ADR immutability guard, the proposal lifecycle guard, the manifest integrity advisory, the PR reference advisory, the review checklist advisory, and the release readiness advisory.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Validate that a pull request follows principled conventions: references a plan or proposal, has correct labels, includes required sections in the description, and links to relevant documents. Use in CI or before merging to enforce PR quality.
Generate a structured pull request description from a DDD plan task. Reads the plan, task manifest, and implementation branch to produce a PR body with references to the originating proposal, plan, ADRs, and related tasks. Use when opening a PR for plan-driven work.
Process open GitHub issues through the principled pipeline. Lists untriaged issues, normalizes their metadata, ingests them into the documentation pipeline, and reports a summary. Operates as the batch entry point — delegates to /ingest-issue for each individual issue.
Implementation orchestration strategy for the Principled framework. Consult when working with DDD plan execution, git worktrees for task isolation, task manifests, or the decompose-spawn-validate-merge lifecycle. Covers worktree management, sub-agent patterns, task state machines, and manifest schema.
Top-level orchestrator for DDD plan execution. Decomposes a plan into tasks, iterates through phases respecting dependencies, spawns worktree-isolated agents, validates implementations, and merges results. Runs inline to coordinate multiple sub-agent spawns. Use for automated end-to-end plan execution.
Audit ADR coverage across modules. Identifies modules with no architectural governance, orphaned ADRs referencing removed modules, and stale architecture docs. Classifies findings by severity.
| name | test-hooks |
| description | Smoke-test all enforcement hooks by feeding known good and bad inputs and verifying exit codes. Tests the ADR immutability guard, the proposal lifecycle guard, the manifest integrity advisory, the PR reference advisory, the review checklist advisory, and the release readiness advisory. |
| allowed-tools | Bash(echo *), Bash(bash plugins/*), Read |
| user-invocable | true |
Smoke-test all enforcement hooks by feeding known good and bad inputs and verifying exit codes.
/test-hooks
plugins/principled-docs/hooks/scripts/check-adr-immutability.sh)Run these test cases:
Accepted ADR — should block (exit 2):
For each file in docs/decisions/ with status: accepted, feed its path:
echo '{"tool_input":{"file_path":"<path>"}}' | bash plugins/principled-docs/hooks/scripts/check-adr-immutability.sh
Expected: exit code 2.
Non-decision file — should allow (exit 0):
echo '{"tool_input":{"file_path":"CLAUDE.md"}}' | bash plugins/principled-docs/hooks/scripts/check-adr-immutability.sh
Expected: exit code 0.
Non-existent file — should allow (exit 0):
echo '{"tool_input":{"file_path":"docs/decisions/999-nonexistent.md"}}' | bash plugins/principled-docs/hooks/scripts/check-adr-immutability.sh
Expected: exit code 0.
plugins/principled-docs/hooks/scripts/check-proposal-lifecycle.sh)Run these test cases:
Accepted proposal — should block (exit 2):
For each file in docs/proposals/ with status accepted, rejected, or superseded, feed its path. Expected: exit code 2.
Draft proposal — should allow (exit 0):
For each file in docs/proposals/ with status draft, feed its path. Expected: exit code 0.
Non-proposal file — should allow (exit 0):
echo '{"tool_input":{"file_path":"CLAUDE.md"}}' | bash plugins/principled-docs/hooks/scripts/check-proposal-lifecycle.sh
Expected: exit code 0.
plugins/principled-implementation/hooks/scripts/check-manifest-integrity.sh)Run these test cases:
Manifest file edit — should warn but allow (exit 0):
echo '{"tool_input":{"file_path":".impl/manifest.json"}}' | bash plugins/principled-implementation/hooks/scripts/check-manifest-integrity.sh
Expected: exit code 0, with advisory message on stderr.
Unrelated file — should pass silently (exit 0):
echo '{"tool_input":{"file_path":"src/index.ts"}}' | bash plugins/principled-implementation/hooks/scripts/check-manifest-integrity.sh
Expected: exit code 0, no output.
Missing JSON input — should allow (exit 0):
echo '{}' | bash plugins/principled-implementation/hooks/scripts/check-manifest-integrity.sh
Expected: exit code 0 (guard scripts default to allow).
plugins/principled-github/hooks/scripts/check-pr-references.sh)Run these test cases:
gh pr create command — should warn but allow (exit 0):
echo '{"tool_input":{"command":"gh pr create --title \"test\" --body \"test\""}}' | bash plugins/principled-github/hooks/scripts/check-pr-references.sh
Expected: exit code 0, with advisory message on stderr.
Unrelated command — should pass silently (exit 0):
echo '{"tool_input":{"command":"git status"}}' | bash plugins/principled-github/hooks/scripts/check-pr-references.sh
Expected: exit code 0, no output.
Missing JSON input — should allow (exit 0):
echo '{}' | bash plugins/principled-github/hooks/scripts/check-pr-references.sh
Expected: exit code 0 (guard scripts default to allow).
plugins/principled-quality/hooks/scripts/check-review-checklist.sh)Run these test cases:
gh pr review command — should warn but allow (exit 0):
echo '{"tool_input":{"command":"gh pr review 42"}}' | bash plugins/principled-quality/hooks/scripts/check-review-checklist.sh
Expected: exit code 0, with advisory message on stderr.
gh pr merge command — should warn but allow (exit 0):
echo '{"tool_input":{"command":"gh pr merge 42"}}' | bash plugins/principled-quality/hooks/scripts/check-review-checklist.sh
Expected: exit code 0, with advisory message on stderr.
Unrelated command — should pass silently (exit 0):
echo '{"tool_input":{"command":"git status"}}' | bash plugins/principled-quality/hooks/scripts/check-review-checklist.sh
Expected: exit code 0, no output.
plugins/principled-release/hooks/scripts/check-release-readiness.sh)Run these test cases:
git tag command — should warn but allow (exit 0):
echo '{"tool_input":{"command":"git tag v1.0.0"}}' | bash plugins/principled-release/hooks/scripts/check-release-readiness.sh
Expected: exit code 0, with advisory message on stderr.
git tag -l command — should pass silently (exit 0):
echo '{"tool_input":{"command":"git tag -l"}}' | bash plugins/principled-release/hooks/scripts/check-release-readiness.sh
Expected: exit code 0, no advisory (listing tags is not a release action).
Unrelated command — should pass silently (exit 0):
echo '{"tool_input":{"command":"git status"}}' | bash plugins/principled-release/hooks/scripts/check-release-readiness.sh
Expected: exit code 0, no output.
For each test case, report PASS or FAIL with the actual vs expected exit code. Provide a summary at the end with total pass/fail counts.