skills.rest
Priivacy-ai
Priivacy-aiOFFICIAL
Explore all skills by this author →
GitHub

spk-run-review-wp

Review Spec Kitty work packages and approve or reject with structured feedback.

1.6k|156|Updated Oct 9, 2025
Search Tags:#work package#event log#spec-kitty#approve reject#Git worktree#Code review#spec-Driven Development
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-run-review-wp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spk-run-review-wp
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-run-review-wp
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-run-review-wp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviewing AI-agent-implemented work packages requires comparing code against specs, plans, and acceptance criteria, then recording a verdict in a traceable way. This Skill standardizes that review loop so approvals and rejections are captured through the deterministic event log rather than ad-hoc edits.

Core Features & Use Cases

  • Structured WP Review: Compare implementation against WP scope, spec, plan, and acceptance checks before deciding.
  • Approve/Reject Verdicts: Approve with spec-kitty agent tasks move-task <WP> --to approved or reject with --to planned --review-feedback-file <f>.
  • Authoritative Event Log: Records the review_result event in status.events.jsonl as the sole source of truth, keeping the review-cycle-N.md render non-authoritative.
  • Use Case: After an agent finishes a work package in an isolated git worktree, use this Skill to verify the implementation against acceptance criteria and either approve it for merge or reject it with concrete, actionable feedback.

Quick Start

Review the current work package against its spec and acceptance criteria, then approve it or reject it with feedback using the spec-kitty move-task command.

Frequently Asked Questions about spk-run-review-wp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I approve a work package in Spec Kitty?▼

Approve a work package by running spec-kitty agent tasks move-task <WP> --to approved after verifying the implementation against the WP scope, spec, plan, and acceptance checks. The verdict is recorded as a review_result event in status.events.jsonl.

How do I reject a work package with feedback?▼

Reject a work package with spec-kitty agent tasks move-task <WP> --to planned --review-feedback-file <f>, where the feedback file contains concrete, actionable comments and affected files or commands. The WP returns to the planned lane for rework.

Can I edit the review-cycle markdown file to change a verdict?▼

No. The review-cycle-N.md render is non-authoritative; the review_result event in status.events.jsonl is the sole authority. Always record verdicts through the move-task command instead of hand-editing the markdown file.

What should I check before approving a work package?▼

Compare the implementation against the WP scope, the spec, the plan, and the acceptance checks. Approve only when behavior and verification satisfy the WP; otherwise reject with specific feedback so the implement-review loop can continue.

What happens after a work package review verdict?▼

After the verdict is recorded, the spk-run-implement-review loop continues: approved packages move toward merge, while rejected packages return to planned with feedback for another implementation pass.

Related Skills

Explore More Software Engineering Skills→
skytiger6724skytiger6724
2

planning-and-task-breakdown

Break integration specs into ordered, verifiable tasks with dependencies and acceptance criteria.

Community
Intermediate
posit-devposit-dev
4.2k

merge

Merges a topic branch into the base branch across git worktrees with conflict resolution.

Official
Intermediate
nexus-a1nexus-a1

todo-work

Surface pending tasks from TODO.md and mark them in progress.

Community
Advanced
automatedigitalautomatedigital
1

github-code-review

Automate code reviews for local git changes and GitHub pull requests.

Official
Intermediate