AgentSkillsCN

implementation-plan

以文件影响分析、依赖关系及分阶段任务为基础,进行结构化的实施规划

SKILL.md
--- frontmatter
name: implementation-plan
description: Structured implementation planning with file impact analysis, dependencies, and phased tasks

Implementation Plan Generator

Required output: Every task/issue MUST include Urgency, Risk, ROI, and Blast Radius ratings. Do not omit these ratings.

Create detailed implementation plans with impact analysis, phased tasks, and risk assessment.

Step 1: Interactive Input

IMPORTANT: Use AskUserQuestion to gather requirements:

code
AskUserQuestion with questions:
[
  {
    "question": "What type of work are you planning?",
    "header": "Work Type",
    "options": [
      {"label": "New feature", "description": "Adding new functionality to the app"},
      {"label": "Bug fix / improvement", "description": "Fixing issues or enhancing existing features"},
      {"label": "Refactoring", "description": "Restructuring code without changing behavior"},
      {"label": "Report card items", "description": "Implementing recommendations from a report card"}
    ],
    "multiSelect": false
  },
  {
    "question": "What is your risk tolerance?",
    "header": "Risk",
    "options": [
      {"label": "Conservative", "description": "Minimize risk, smaller incremental changes"},
      {"label": "Balanced", "description": "Reasonable risk for reasonable gains"},
      {"label": "Aggressive", "description": "Accept higher risk for faster delivery"}
    ],
    "multiSelect": false
  },
  {
    "question": "What is your timeline?",
    "header": "Timeline",
    "options": [
      {"label": "Urgent (days)", "description": "Must ship this week"},
      {"label": "Normal (1-2 weeks)", "description": "Standard development cycle"},
      {"label": "Flexible (weeks+)", "description": "No immediate deadline"}
    ],
    "multiSelect": false
  }
]

Wait for responses, then ask for the feature/task description if not already provided.


Step 2: Understanding Phase

After gathering input, produce:

Feature Summary Table

AspectDetails
What[Restate the feature/task in your own words]
Why[User benefit or business value]
Scope[What's included and excluded]

User Stories Table

#As a...I want...So that...
1[user type][capability][benefit]
2[user type][capability][benefit]

Acceptance Criteria Table

#CriterionHow to Verify
1[What must be true][Test or check]
2[What must be true][Test or check]

Step 3: Codebase Analysis

Scan the codebase and produce:

Related Code Table

File/ModuleRelevanceNotes
[path]High/Med/Low[How it relates]

Patterns to Follow Table

PatternExample LocationApply To
[Pattern name][File path][Where to use]

Dependencies Table

This Feature Depends OnType
[Module/file]Required/Optional
This Feature Will AffectImpact
[Module/file]High/Med/Low

Step 4: Impact Analysis Table

AreaFiles AffectedRisk LevelNotes
Models[list]High/Med/Low[details]
ViewModels[list]High/Med/Low[details]
Views[list]High/Med/Low[details]
Services/Managers[list]High/Med/Low[details]
Tests[list]High/Med/Low[details]

Step 5: Implementation Plan Table

PhaseTaskFilesRiskDepends On
A: Foundation[Task 1][files]Low-
A: Foundation[Task 2][files]LowTask 1
B: Core Logic[Task 3][files]MedPhase A
B: Core Logic[Task 4][files]MedTask 3
C: UI Integration[Task 5][files]MedPhase B
C: UI Integration[Task 6][files]LowTask 5
D: Polish[Task 7][files]LowPhase C
D: Polish[Task 8][files]Low-

Step 6: Risk Assessment Table

RiskLikelihoodImpactMitigation
[Risk description]High/Med/LowHigh/Med/Low[How to mitigate]

Step 7: Test Plan Table

Test TypeWhat to TestPriority
Unit[Functionality]High/Med/Low
Integration[Functionality]High/Med/Low
UI[Functionality]High/Med/Low

Step 8: Rollback Strategy Table

ScenarioRollback Action
[What could go wrong][How to undo]

Step 9: Clarifying Questions

If anything is unclear, use AskUserQuestion before finalizing:

code
AskUserQuestion with questions:
[
  {
    "question": "[Specific question about scope/behavior]",
    "header": "Scope",
    "options": [
      {"label": "[Option A]", "description": "[What this means]"},
      {"label": "[Option B]", "description": "[What this means]"}
    ],
    "multiSelect": false
  }
]

Step 10: Final Deliverables Summary

DeliverableStatus
Feature specification✅ Complete
File-by-file plan✅ Complete
Phased task list✅ Complete
Test plan✅ Complete
Rollback strategy✅ Complete

Step 11: Ready to Proceed?

Use AskUserQuestion to confirm:

code
AskUserQuestion with questions:
[
  {
    "question": "How would you like to proceed?",
    "header": "Action",
    "options": [
      {"label": "Start Phase A", "description": "Begin implementation with foundation tasks"},
      {"label": "Refine the plan", "description": "Discuss or adjust before starting"},
      {"label": "Save for later", "description": "Keep plan but don't start now"}
    ],
    "multiSelect": false
  }
]