用途：当用户询问整体进度、所有规格的状态、完成百分比、剩余工作量、阻塞项或仓库下一步工作时使用。报告是对真实状态来源的投影，不作为第二状态源。
主要能力：统计规格、门禁、任务与检查清单的分母；显示当前阶段与下一步负责的技能（由 Status 推导）；区分“规格已完成”“进行中”与“真实阻塞”；给出下一个可用的 TNNN/ITEM 配对；识别门禁 Failed、检查清单不一致、无可用路径的依赖，以及必交文档缺失等阻塞。单独一个门禁处于 In Progress 不算失败。
必要用法：先须在项目根加载 $specsfy-setup，交接场景下需在步骤前重新加载，且不可在 setup 报出待处理项时继续。仅从 specs/<状态>/*/spec.md 读取状态，research/ 内的 spec.md 不计入。常用命令（保持原样）： node .agents/skills/specsfy-progress/scripts/progress.mjs . node .agents/skills/specsfy-progress/scripts/progress.mjs . --json node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug> node .agents/skills/specsfy-progress/scripts/analyze_context.mjs specs/<状态>/<NNNN>-<slug>/spec.md --json 文档检查： node .agents/skills/specsfy-setup/scripts/monitor_context.mjs --project . --check node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs --project . --check
交互与限制：本技能不提问题，只呈现观察到的投影与适用的下一步交接。发现属于其他步骤的工作时宣布“Pendência detectada”并自动转交，宣布“Transição automática: $specsfy-progress → $<目标>”后直接加载目标技能，无需确认；敏感操作仍需专门授权。PENDING 视为交付阻塞。文档缺失或过期按 $specsfy-documentator 判为阻塞；需变更规格行为或计划时转交 $specsfy-update-spec；无规格存在时保留退出码 2，specs/inbox/ 与 specs/backlog/ 不算规范性进度。无 --usage-json 时结果始终标记为 estimated 并记录启发式；明确提供的指标才标为 measured，不得把估算当作真实用量。查询期间不得编辑 specs、复选框、测试或代码，不得根据提交、文件或聊天记忆编造进度。