AgentSkillsCN

plan-marshall

统一规划生命周期管理——从创建、拟定、执行、验证到最终定稿,全流程闭环管理

SKILL.md
--- frontmatter
name: plan-marshall
description: Unified plan lifecycle management - create, outline, execute, verify, and finalize plans
user-invocable: true
allowed-tools: Read, Skill, Bash, AskUserQuestion, Task

Plan Marshall Skill

Unified entry point for plan lifecycle management covering all 7 phases.

CRITICAL: DO NOT USE CLAUDE CODE'S BUILT-IN PLAN MODE

This skill implements its OWN plan system. You must:

  1. NEVER use EnterPlanMode or ExitPlanMode tools
  2. IGNORE any system-reminder about .claude/plans/ paths
  3. ONLY use plans via pm-workflow:manage-* skills

7-Phase Model

code
1-init -> 2-refine -> 3-outline -> 4-plan -> 5-execute -> 6-verify -> 7-finalize

Parameters

ParameterTypeDescription
actionoptionalExplicit action: list, init, outline, execute, verify, finalize, cleanup, lessons (default: list)
taskoptionalTask description for creating new plan
issueoptionalGitHub issue URL for creating new plan
lessonoptionalLesson ID to convert to plan
planoptionalPlan name for specific operations (e.g., jwt-auth, not path)
stop-after-initoptionalIf true, stop after 1-init phase without continuing to 2-refine (default: false)

Note: The plan parameter accepts the plan name (plan_id) only, not the full path.

Workflow

Action Routing

Route based on action parameter. Load the appropriate workflow document and follow its instructions:

ActionWorkflow DocumentDescription
list (default)Read workflows/planning.mdList all plans
initRead workflows/planning.mdCreate new plan, auto-continue to refine
outlineRead workflows/planning.mdRun outline and plan phases
cleanupRead workflows/planning.mdRemove completed plans
lessonsRead workflows/planning.mdList and convert lessons
executeRead workflows/execution.mdExecute implementation tasks
verifyRead workflows/execution.mdRun quality verification
finalizeRead workflows/execution.mdCommit, push, PR

Auto-Detection (plan parameter without action)

When plan is specified but no action, auto-detect from plan phase:

bash
python3 .plan/execute-script.py pm-workflow:plan-marshall:manage-lifecycle get-routing-context \
  --plan-id {plan_id}
Current PhaseWorkflow DocumentAction
1-initRead workflows/planning.mdinit
2-refineRead workflows/planning.mdinit (continues refine)
3-outlineRead workflows/planning.mdoutline
4-planRead workflows/planning.mdoutline (continues plan)
5-executeRead workflows/execution.mdexecute
6-verifyRead workflows/execution.mdverify
7-finalizeRead workflows/execution.mdfinalize

Execution

After determining the action and workflow document:

  1. Read the workflow document (workflows/planning.md or workflows/execution.md)
  2. Navigate to the section for the resolved action
  3. Follow the workflow instructions in that section

Usage Examples

bash
# List all plans (interactive selection)
/plan-marshall

# Create new plan from task description
/plan-marshall action=init task="Add user authentication"

# Create new plan from GitHub issue
/plan-marshall action=init issue="https://github.com/org/repo/issues/42"

# Create plan but stop after 1-init
/plan-marshall action=init task="Complex feature" stop-after-init=true

# Outline specific plan
/plan-marshall action=outline plan="user-auth"

# Execute specific plan
/plan-marshall action=execute plan="jwt-auth"

# Run verification
/plan-marshall action=verify plan="jwt-auth"

# Finalize (commit, PR)
/plan-marshall action=finalize plan="jwt-auth"

# Auto-detect: continues from current phase
/plan-marshall plan="jwt-auth"

# Cleanup completed plans
/plan-marshall action=cleanup

# List lessons and convert to plan
/plan-marshall action=lessons

Continuous Improvement

If you discover issues or improvements during execution, record them:

  1. Activate skill: Skill: plan-marshall:manage-lessons
  2. Record lesson with component: {type: "skill", name: "plan-marshall", bundle: "pm-workflow"}

Related

SkillPurpose
pm-workflow:phase-1-initInit phase implementation
pm-workflow:phase-3-outlineOutline phase implementation
pm-workflow:phase-6-verifyVerify phase implementation
pm-workflow:phase-7-finalizeFinalize phase implementation
pm-workflow:workflow-extension-apiExtension points for domain customization
AgentPurpose
pm-workflow:plan-init-agentInit phase: creates plan, detects domains
pm-workflow:task-plan-agentPlan phase: creates tasks from deliverables
pm-dev-java:java-implement-agentJava task implementation
pm-dev-frontend:js-implement-agentJavaScript task implementation