Replaces shell script (.git/hooks/pre-commit.legacy) with ecosystem-managed pre-commit framework: - gitleaks/gitleaks: secret scanning - jumanjihouse/pre-commit-hooks: shellcheck wrapper - pre-commit/pre-commit-hooks: JSON/YAML validation, end-of-file-fixer, trailing-whitespace - local hooks: SKILL.md frontmatter validation Uses pinned versions for reproducibility across environments. Includes auto-fixes from hook runs (formatting, trailing whitespace, JSON beautification). Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
0022 — Test skills: write-tests, generate-test-data, review-test-coverage
Type: HITL
Parent PRD: docs/prd/chunk-3-skills-library.md
What to build
The 3 test phase skills. All are new. Authored via write-skill (0018), evals via write-eval (0017).
Skills and trigger descriptions:
| Flat name | Trigger description |
|---|---|
write-tests |
Write tests, generate test cases, add unit tests |
generate-test-data |
Generate test data, create fixtures, sample data |
review-test-coverage |
Review test coverage, find untested paths, coverage gaps |
Key constraints per skill:
write-tests: derives tests from spec (EARS acceptance criteria), NOT from implementation; uses pytest for Python, Vitest/Jest for TypeScriptgenerate-test-data: produces structurally valid, semantically unusual data; flags PII risk before generatingreview-test-coverage: reports coverage gaps against spec acceptance criteria, not line coverage percentages
Implementation notes
Follow the per-skill workflow defined in docs/notes/skill-implementation-workflow.md.
Known upstream sources to review:
mattpocock/skills— check for any test-phase skills in the current setbmad-method/bmad-method— BMAD QA role patterns- Search agentskills.io and GitHub for open-source test generation skills before writing from scratch
Acceptance criteria
- All 3 SKILL.md files exist at
.agents/skills/<skill-name>/SKILL.md;metadata.category: test; authoring standard met write-testsincludes explicit constraint: derives from spec, not from implementationgenerate-test-dataincludes PII flag check before generating any datasource:fields populated for any adopted upstream content- Each skill has a co-located eval at
.agents/evals/test/<skill-name>/eval.yamlviawrite-eval install.shdeploys all 3 to~/.agents/skills/- HITL: human runs behavioral test per skill
- HITL: human reviews each SKILL.md and eval before committing
- Per-skill process followed for all 3 skills: source discovery (sub-agent) → source review with licence/security check (sub-agent) → conflict check against constitution + factory principles (sub-agent) → synthesis grill → co-write iteratively
- Trigger description for each skill tested against explicit, implicit, and negative queries before body written
when:frontmatter field present in all SKILL.md filessource:andreferences:fields correctly populated or absent- eval.yaml for each skill contains all 5 required test types
- Body ≤500 lines for each skill
docs/spec/overview.mdupdated to reflect all 3 skills deployed
Blocked by
- 0016 (per-skill workflow)
- 0017 (
write-eval) - 0018 (
write-skill)