progress-updaterlisted

# 进度更新器 (Progress Updater) > **版本**: 2.0.0 | **十步循环**: D.1 > **架构**: 双层任务架构支持 (tasks.md + detailed-tasks.yaml) ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - D.1: 任务完成后更新项目进度 - 需要更新 UPM 文档的 KPI 指标 - 需要标记任务为已完成 - 需要写入周期进度报告 **不使用场景**: - 只需要查询进度 → 使用 `state-scanner` (A.0) - 需要规划任务 → 使用 `task-planner` (A.2) - 需要归档 Spec → 使用 `openspec:archive` (D.2) --- ## 核心功能 | 功能 | 描述 | |------|------| | UPM 状态更新 | 更新 UPMv2-STATE YAML 区块所有字段 | | stateToken 自动计算 | 自动重新计算并更新 stateToken | | 任务状态同步 | 标记任务完成，更新候选任务 | | 周期文档写入 | 创建/更新 progress-report.md 等文档 | | 并发冲突检测 | 通过 stateToken 校验防止覆盖 | | 双层架构后向同步 | 自动同步 TASK 完成状态到 tasks.md checkbox | | 三类冲突检测 | 检测 Progress Mismatch、Parent Reference、Task Definition 冲突 | --- ## 输入参数 | 参数 | 必需 | 说明 | 示例 | |------|------|------|------| | `module` | ✅ | 目标模块 | `mobile`, `backend` | | `commit_ref` | ⚠️ 推荐 | Git 提交引用 | `git:abc1234-任务描述` | | `completed_tasks` | ❌ | 已完成任务列表 | `["TASK-001", "TASK-002"]` | | `kpi_updates` | ❌ | KPI 更新数据 | `{coverage: "89.5%"}` | | `risks_updates` | ❌ | 风险状态更新 | `[{id: "R1", status: "resolved"}]` | | `next_candidates` | ❌ | 下一循环候选 | `[{id: "TASK-003", rationale: "..."}]` | | `cycle_doc` | ❌ | 是否写入周期文档 | `true`, `false` (默认) | | `spec_path` | ❌ | OpenSpec 变更目录路径 | `changes/user-auth` | --- ## 执行流程 ```yaml D.1.1 - 读取当前状态: - 调用 state-scanner 获取当前状态 - 记录当前 stateToken (用于冲突检测) D.1.2 - 准备更新数据: - 生成新的 lastUpdateAt (ISO 8601) - 构建 lastUpdateRef - 合并 kpi_updates 到 kp