AgentSkillsCN

review-backlog

对已完成的任务或功能交付成果进行审核。依据不同类型的检查清单(编码/文档/创意/通用)开展质量评审。若发现问题,可在规划模式下制定改进计划,并将改进任务添加至 BACKLOG.md 中。触发条件包括:“审核任务”、“审核功能”、“审核待办”。

SKILL.md
--- frontmatter
name: review-backlog
description: "Review completed Task or Feature deliverables. Uses type-specific checklists (coding/docs/ideation/general) for quality review. If issues found, creates improvement plan in Plan mode and adds improvement Tasks to BACKLOG.md. Triggers: 'review task', 'review feature', 'review backlog'"

Sprint Review Backlog Skill

Systematically review completed Task or Feature deliverables, identify areas for improvement, and connect to next actions.

When to Use

  • Immediately after a Task or Feature is completed
  • When quality review of code/docs/design is needed
  • Before moving to the next Task for checkpoint

Prerequisites

This skill operates in a sprint folder containing:

  • BACKLOG.md - Backlog items
  • HANDOFF.md - Current progress status
  • INSTRUCTION.md - Agent guidelines
  • refs/ - Reference documents

Workflow

Step 1: Understand Sprint Context

Required files to read:

  1. BACKLOG.md - Check completed items
  2. HANDOFF.md - Check progress status

After identifying target, read related files:

TargetFiles to Read
Featurerefs/designs/F{n}-*, refs/decisions/F{n}-*, active/F{n}-*
Taskrefs/plans/F{n}-T{m}-*, related Feature files

Sprint-wide (if needed):

  • refs/decisions/_sprint.md
  • refs/lessons/_sprint.md

Report to user:

code
Recently completed items:
- T1.2: Login API (done)
- T1.3: Signup API (done)
- F2: Dashboard (done)

What would you like to review?
1. Specific Task
2. Entire Feature

Step 2: Identify Review Target

Collect information about the user's selected item:

  1. Check type - coding | docs | ideation | general from BACKLOG.md
  2. Check completion criteria - Originally defined success criteria
  3. Collect related deliverables - Code, documents, designs, etc.

Step 3: Apply Type-Specific Checklist

Note: Checklists are minimum standards. Apply additional criteria based on project characteristics.

Load checklist based on type:

TypeChecklist
codingassets/coding/checklist.md
docsassets/docs/checklist.md
ideationassets/ideation/checklist.md
generalassets/general/checklist.md

Perform review:

  • Check each checklist item one by one
  • Record pass/fail for each item
  • Provide detailed explanation for failed items

Step 4: Organize Review Results

Categorize findings:

Classification Criteria

CategoryDescriptionExamples
🔴 CriticalImmediate fix required, functional/security issuesBugs, security vulnerabilities, data loss risk
🟡 ImprovementWould be better if improved, quality enhancementRefactoring candidates, performance improvements, readability
🟢 MinorMinor improvementsNaming, comments, formatting
💡 SuggestionFuture considerationsNew feature ideas, technical debt

Report results to user:

code
## Review Results: [Item name]

### 🔴 Critical (N items)
1. [Issue]: [Description]
   - Location: [File/location]
   - Impact: [Scope of impact]

### 🟡 Improvement (N items)
1. [Improvement]: [Description]
   - Current: [Current state]
   - Suggested: [Improvement direction]

### 🟢 Minor (N items)
- [Items...]

### 💡 Suggestion (N items)
- [Items...]

---
Would you like to create an improvement plan for Critical/Improvement items?

Step 5: Create Improvement Plan (When Issues Found)

Enter Plan Mode if Critical or Improvement items exist and user agrees.

code
There are items that need improvement.
Entering Plan Mode to create an improvement plan.

Content to write in Plan Mode:

markdown
# [Item Name] Improvement Plan

> This plan will be executed in the next session via `@INSTRUCTION.md`.
> Do not start improvement work immediately after plan approval.

## Review Summary
- Review target: [Task/Feature name]
- Issues found: Critical N, Improvement N

## Improvement Tasks

### Task 1: [Improvement item]
- Issue: [Current problem]
- Solution: [Specific solution]
- Scope: [Files/areas to modify]
- Completion criteria: [How to know it's done]

### Task 2: [Improvement item]
...

## Priority Order
1. [What to do first]
2. [Next...]

## Risks
- [Things to watch out for during improvement]

## Estimated Effort
- [Expected time/complexity]

Wait for user approval.

CRITICAL: This skill only handles review and planning. It does NOT perform actual improvement work.

When the user approves the Plan:

  1. Update BACKLOG.md
  2. End the skill

Do NOT say "Plan approved. Starting improvement work now." and begin work. Improvement work happens in the next session via @INSTRUCTION.md.


Step 6: Post-Approval Updates

IMPORTANT: After user approval, only update files and end the skill. Do not start improvement work.

6.1 Update BACKLOG.md

Add improvement Tasks:

markdown
- [x] T1.2: Login API `done`
- [ ] T1.4: Fix review issues (T1.2) `backlog`  ← newly added
  - [ ] T1.4.1: [Critical improvement 1]
  - [ ] T1.4.2: [Improvement 1]

Reopen Feature (if Feature was in completed state):

markdown
- [ ] F1: Login System  ← changed from [x] to [ ]

6.2 Update HANDOFF.md

Add to ## Context for Next Session:

markdown
**Review results to address:**
- [Item name] review found N improvement items
- Improvement Task: T{n}.{m}
- Work from Plan file - no Plan Mode needed

Step 7: Completion Report

code
[Item name] review complete.

Review results:
- 🔴 Critical: N items
- 🟡 Improvement: N items
- 🟢 Minor: N items
- 💡 Suggestion: N items

Updated files:
- BACKLOG.md - Improvement Tasks added
- HANDOFF.md - Status reflected

Call @INSTRUCTION.md in your next session to start improvement work.

Key Principles

  • Type-specific checklists - Different criteria for coding/docs/ideation/general
  • Classification and prioritization - Categorize findings by severity
  • Plan-based improvements - Planned improvements, not ad-hoc fixes
  • Add as new Tasks - Create improvement Tasks instead of reopening existing ones
  • Reopen Feature - Reopen if Feature was in completed state
  • Plan file reference required - Always reference generated Plan file during improvement work

Related Skills

  • /sprint:init - Sprint initialization
  • /sprint:add-backlog - Add backlog items
  • /sprint:plan-backlog - Design items in detail
  • @INSTRUCTION.md - Execute improvement work

Example Usage

User: "Review T1.2"

Claude:

  1. Understand sprint context (check T1.2 in BACKLOG.md)
  2. Check T1.2 type (coding)
  3. Load coding checklist
  4. Perform systematic review
  5. Categorize and report results
  6. (If issues found) Get user confirmation, enter Plan Mode
  7. Create improvement plan
  8. Wait for user approval
  9. After approval, add improvement Tasks to BACKLOG.md
  10. Report completion