AgentSkillsCN

mpx-show-project-status

展示当前项目的进展，清晰呈现各阶段的状态与下一步行动。

SKILL.md
--- frontmatter
name: mpx-show-project-status
description: Show current project progress. Displays phase status and next steps.
disable-model-invocation: true
allowed-tools: Read, Bash

Project Status

Display current project progress, completed tasks, and next steps.

Usage

code
/mpx-show-project-status

Workflow

Step 1: Gather Progress Data

  1. •Read .mpx/STATE.md for current status
  2. •Read .mpx/ROADMAP.md for phase overview
  3. •For current phase, read phase folder's CHECKLIST.md for task progress
  4. •Compile overall statistics

Step 2: Generate Status Display

code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Project Status: [Project Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Current Phase: Phase 2 - Core Feature
Overall Progress: ████░░░░░░░░░░░░░░░░ 20%

Phase Breakdown:
  ✅ Phase 1: Foundation      (8/8 tasks)
  🔄 Phase 2: Core Feature    (3/12 tasks) ◄ Active
  ⬜ Phase 3: Secondary       (0/8 tasks)
  ⬜ Phase 4: Polish          (0/6 tasks)

Current Phase Progress:
  ████████░░░░░░░░░░░░ 25% (3/12 tasks)

  Completed:
    ✓ Set up API routes
    ✓ Create data models
    ✓ Implement basic CRUD

  Next:
    □ Add authentication middleware

Blockers:
  None

Session Notes:
  [Latest note from STATE.md]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands:
  /mpx-execute-task          Continue with next task
  /mpx-parse-spec       Regenerate plan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Step 3: Show Contextual Commands

Based on project state, suggest relevant next commands:

  • •If no tasks done: "Start with /mpx-execute-task to execute the first task"
  • •If phase incomplete: "Continue with /mpx-execute-task"
  • •If phase complete: "Ready for next phase with /mpx-execute-task"
  • •If blockers exist: "Resolve blockers before continuing"
  • •If all phases done: "Project complete! Consider final review"

Progress Bar Generation

Generate ASCII progress bars based on completion percentage:

code
0%:   ░░░░░░░░░░░░░░░░░░░░
25%:  █████░░░░░░░░░░░░░░░
50%:  ██████████░░░░░░░░░░
75%:  ███████████████░░░░░
100%: ████████████████████

Use 20 characters for the bar.

Status Icons

  • •✅ Completed section/phase
  • •🔄 In progress (has some completed tasks)
  • •⬜ Not started
  • •🚫 Blocked
  • •◄ Current/Active indicator

Error Cases

  • •No STATE.md or phases/: "No project tracking found. Run /mpx-init-project or /mpx-parse-spec first."
  • •Empty phase checklist: "Phase checklist has no tasks. Check phase's CHECKLIST.md"
  • •Corrupted STATE.md: "Could not parse STATE.md. Consider regenerating with /mpx-parse-spec"

Notes

  • •This is a read-only operation - it never modifies files
  • •Works from any directory within the project
  • •Can be run at any time to check progress
  • •Useful for session handoff - shows where to continue