snowy/.claude/commands/update-status.md

description

description
增量更新项目状态文档（日常高频）

/update-status —— 增量更新项目状态

日常高频命令：把"刚做完的事"增量写入 docs/ 三文档。与 /sync 的区别：/sync 全量扫描生成报告落盘，本命令增量、快、只更新三文档。

执行步骤

1. 确保文档存在

三文档（docs/项目状态.md、需求文档.md、待办清单.md）任一缺失 → 读 .claude/templates/ 对应模板先创建（空骨架），再继续。

2. 识别本次变化（三来源合并）

• 用户口述（$ARGUMENTS 或对话上下文：刚完成了什么/发现了什么问题）
• git（带降级）：

  git rev-parse --is-inside-work-tree 2>/dev/null && git log --oneline -20 && git status --short
  

  不可用 → 跳过，不报错
• 代码扫描佐证：git status --short 列出的改动文件 / 或用户提到的模块目录 mtime

3. 更新三文档（只追加不覆盖用户手写内容）

项目状态.md：

• "最近完成"区追加条目（日期 + 模块 + 一句话）
• 模块进度表刷新完整度（如新域六件套齐了 → 100%）
• 有新风险/问题 → 追加到问题风险区

待办清单.md：

• 完成了的待办移到"最近完成"区（保留 TASK 编号）
• 代码扫描的 FIXME → 高优待办、TODO → 中优待办（去重后追加）
• $ARGUMENTS 里用户口述的新待办入对应优先级区

需求文档.md：仅当本次是"完成某个 REQ"时更新该 REQ 状态字段；不新增需求（新增走用户明确要求）。

4. 输出变更摘要

# 状态更新完成
- 项目状态.md：+2 条完成记录，模块进度 supplier 0%→100%
- 待办清单.md：TASK-003 完成，+1 新待办（FIXME 来自 BizXxxServiceImpl）
- 需求文档.md：REQ-002 状态 → 已完成
（无变化的文档标注"无变化"）

注意

• 更新前先 Read 文档现状，diff 式更新，绝不重写全文
• 时间用当前真实时间（YYYY-MM-DD HH:mm）
• git 降级时基于口述 + mtime，报告中注明来源