关于 progress-report
一个手动运行的技能,根据 tasks.md 生成实现进度仪表板,帮助项目参与者查看各阶段进度、受阻和可能已完成的任务,以及剩余工作。
主要功能
- 01显示总体完成百分比
- 02按阶段拆分进度
- 03列出受阻任务
- 04标记可能已完成的任务
- 05估算剩余工作
适用场景
- 01查看各阶段的实现状态
- 02找出等待依赖项的任务
- 03核对现有文件是否对应未完成任务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ drillan/ speckit-gates --skill progress-report安装后在 Claude Code 中输入/progress-report确认已加载。
附带文件scripts/report.sh
详细介绍
progress-report
显示实施状态进度仪表板。
用途
此技能可让你一目了然地查看实施进度:
- 阶段完成情况:tasks.md 中每个阶段的进度条
- 受阻任务:突出显示受阻任务
- 可能已完成:可能已完成但尚未标记的任务
- 剩余工作:估算剩余任务
输出
此技能会输出一个 ProgressDashboard,其中包含:
- 总体完成百分比
- 各阶段的进度明细
- 受阻任务列表
- 可能已完成的任务(根据文件是否存在判断)
- 剩余工作估算
用法
这是一项手动技能,可随时运行以查看进度:
npx skills run progress-report
或通过 AI Agent 运行:
User: Show me the progress report
退出代码
| 代码 | 状态 | 含义 |
|---|---|---|
| 0 | 成功 | 报告已生成 |
| 3 | 错误 | 缺少 tasks.md |
仪表板版块
总体进度
Overall Progress: [##########----------] 50% (25/50 tasks)
阶段明细
| Phase | Progress | Completed | Total |
|-------|----------|-----------|-------|
| Setup | [####----] 50% | 2 | 4 |
| Core | [########] 100% | 10 | 10 |
| Tests | [##------] 25% | 3 | 12 |
受阻任务
因依赖项或问题而无法继续的任务:
- T015: Waiting for API specification
- T023: Blocked by T015
可能已完成
引用的文件已存在的任务(FR-031a):
- T008: File skills/planning-validate/SKILL.md exists
- T009: File skills/planning-validate/scripts/validate.sh exists
剩余工作
- Incomplete tasks: 25
- Blocked tasks: 2
检测逻辑
受阻任务
满足以下条件时,任务会被视为受阻:
- 描述中包含“blocked”或“waiting”
- 依赖尚未完成的任务(未来增强功能)
可能已完成的任务
满足以下条件时,任务可能已完成:
- 引用了一个已存在的文件路径
- 文件近期已创建/修改
- 任务尚未标记为完成
评论
支持 Markdown