Back to Details

progress-report

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

progress-report

进度报告

Displays a progress dashboard showing implementation status.
显示用于展示实施状态的进度仪表盘。

Purpose

用途

This skill provides an at-a-glance view of your implementation progress:
  • Phase completion: Progress bar for each phase in tasks.md
  • Blocked tasks: Highlights tasks that are blocked
  • Potentially complete: Tasks that may be done but not marked
  • Remaining work: Estimate of remaining tasks
该skill为你提供实施进度的概览视图：
  • 阶段完成情况：tasks.md中每个阶段的进度条
  • 阻塞任务：高亮显示处于阻塞状态的任务
  • 潜在已完成任务：可能已完成但未标记的任务
  • 剩余工作：剩余任务的估算

Output

输出

The skill outputs a ProgressDashboard with:
  • Overall completion percentage
  • Per-phase progress breakdown
  • List of blocked tasks
  • Potentially complete tasks (based on file existence)
  • Remaining work estimate
该skill会输出一个ProgressDashboard，包含：
  • 整体完成百分比
  • 各阶段进度细分
  • 阻塞任务列表
  • 潜在已完成任务（基于文件是否存在）
  • 剩余工作估算

Usage

使用方法

This is a manual skill - run it anytime to check progress:
bash
npx skills run progress-report
Or via AI agent:
User: Show me the progress report
这是一个手动skill - 可随时运行以查看进度：
bash
npx skills run progress-report
或通过AI agent调用：
用户：给我展示进度报告

Exit Codes

退出码

CodeStatusMeaning
0SuccessReport generated
3Errortasks.md missing
代码状态含义
0成功报告已生成
3错误缺少tasks.md

Dashboard Sections

仪表盘板块

Overall Progress

整体进度

Overall Progress: [##########----------] 50% (25/50 tasks)
Overall Progress: [##########----------] 50% (25/50 tasks)

Phase Breakdown

阶段细分

| Phase | Progress | Completed | Total |
|-------|----------|-----------|-------|
| Setup | [####----] 50% | 2 | 4 |
| Core  | [########] 100% | 10 | 10 |
| Tests | [##------] 25% | 3 | 12 |
| Phase | Progress | Completed | Total |
|-------|----------|-----------|-------|
| Setup | [####----] 50% | 2 | 4 |
| Core  | [########] 100% | 10 | 10 |
| Tests | [##------] 25% | 3 | 12 |

Blocked Tasks

阻塞任务

Tasks that cannot proceed due to dependencies or issues:
- T015: Waiting for API specification
- T023: Blocked by T015
因依赖或问题无法推进的任务：
- T015: Waiting for API specification
- T023: Blocked by T015

Potentially Complete

潜在已完成任务

Tasks that reference files which already exist (FR-031a):
- T008: File skills/planning-validate/SKILL.md exists
- T009: File skills/planning-validate/scripts/validate.sh exists
引用已存在文件的任务（FR-031a）：
- T008: File skills/planning-validate/SKILL.md exists
- T009: File skills/planning-validate/scripts/validate.sh exists

Remaining Work

剩余工作

- Incomplete tasks: 25
- Blocked tasks: 2
- Incomplete tasks: 25
- Blocked tasks: 2

Detection Logic

检测逻辑

Blocked Tasks

阻塞任务

A task is considered blocked if:
  • Its description contains "blocked" or "waiting"
  • It depends on an incomplete task (future enhancement)
当满足以下条件时，任务被视为阻塞：
  • 任务描述包含"blocked"或"waiting"
  • 依赖于未完成的任务（未来增强功能）

Potentially Complete Tasks

潜在已完成任务

A task is potentially complete if:
  • It references a file path that exists
  • File was created/modified recently
  • Task is not yet marked as complete
当满足以下条件时，任务视为潜在已完成：
  • 引用的文件路径已存在
  • 文件是最近创建/修改的
  • 任务尚未标记为完成