用途：把已完成的冲刺或项目阶段整理为永久、客观的进展记录，写入全局进度日志文件 been-there-done-that.md。它是事实台账，不做庆祝或褒奖。
主要能力：通过 git log、diff、文件列表、tag、README 等自动检测工作会话（连续提交间隔超过 3 天即视为新会话），推断干净的项目名，并自动起草四个字段：Done（做了什么）、New capability（获得的能力）、Blocked by（阻碍）、Shipped（交付状态）。跨条目分析可标记首次使用的技术、重复出现的阻碍、同一领域积累和复杂度变化，必要时给出事实性观察或作品集说明。
使用方式：触发后先做预检，依次提供/确认仓库路径、定位全局日志文件（优先用户指定路径、$CLAUDE_BTDT_PATH、~/.claude/been-there-done-that.md 等），首次运行时询问条目语言。随后运行 git -C <repo_path> log --format="%at|%H|%s"、git -C <repo_path> remote get-url origin 等命令检测会话，展示会话让用户选择并确认项目名；再展示自动草稿供用户确认或更正；有历史条目时展示跨条目分析供确认；最后按会话结束日期计算树位置（年份/月/日期升序，新条目向下追加），预览后经明确同意才写入。
适用场景：开发者或团队按阶段记录构建过程，长期沉淀可复用的进展证据、重复阻碍与技能深度。
限制：依赖 git 仓库和提交历史；需要用户逐步确认，存在多个强制暂停点；分析结论必须由数据支持，不得编造；文件不存在时需指定路径。具体平台兼容性、收费与安装方式暂未提供。