Change traceability review
Skill QoderAI/better-harness/.agents/skills/change-traceability-review
Use for change traceability review across specs, commits, PRs, branches, local diffs, and git history, including Spec Preparation, Review Readiness Checks, and Review Retrospectives, to generate or verify Story-linked specs, commit-message evidence, test evidence, risk signals, AI involvement, and review-flow improvement suggestions.From its SKILL.md
npx -y skills add QoderAI/better-harness --skill change-traceability-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
2.2 KB, as published. Nobody here has run it
Change Traceability Review
Review the traceability behind a change, not code style: Story or issue -> Spec -> plan/tasks -> commit/branch/PR -> diff -> tests -> risk. Default to Chinese and keep the report compact and decision-oriented. Treat specs as the review source of truth; code is acceptable when it clearly serves the spec.
Modes
- Spec Preparation: before implementation or commit, create or tighten a Story-linked spec and define acceptance scenarios, plan/tasks, tests, and risk evidence that later commits can cite. Load Spec Contract.
- Review Readiness Check: inspect the current diff, staged diff, PR text, branch, or selected commits before review/merge. Load Mode Rules and Reporting.
- Review Retrospective: inspect recent history, usually latest 30 commits. Identify commit-message habits, weak traceability, missing Spec/Test/Risk evidence, oversized or mixed-scope commits, spec-doc patterns, and rework signals. Load Mode Rules and Reporting.
Entry and Routing
- Identify the mode from the user's request or the current review surface.
- Read repo instructions first: nearest
AGENTS.md, plugin manifests, and the target spec or diff. - Gather bounded local evidence using Evidence Commands.
- Apply the relevant contract:
- Spec Preparation: Spec Contract
- Commits: Commit Contract
- Any review: Mode Rules
- Produce the report using Reporting.
Keep generated helpers and local experiments outside SKILL.md unless they are
durable resources the skill must use.