用途：根据 git 历史生成一份经过 AI 分析的详细发布文档，支持按时间范围（如最近 30 天）、两个引用之间（如 v1.0.0..HEAD）或用户自定义关注点来组织内容。
主要能力：解析时间或引用范围；在分析前强制把 git log、文件变更状态、diff stat 和完整 diff 导出到 docs/release/；按框架区域（hooks、skills、agents、workflows、principles、config、docs 等）归类变更；读取关键 diff 并生成带执行摘要、分类叙述、新增/移除技能表、规则变更表和统计信息的 Markdown 文档；支持 --focus 自定义关注点并加深该区域分析；生成文档默认标记为 Draft。
使用方式：以 $release-doc 调用，可带参数 --days N、--since DATE、--range base..head、--focus "..."、--output path。例如 $release-doc --days 30、$release-doc --range v1.0.0..HEAD、$release-doc --days 30 --focus "what changed in hooks and workflow enforcement"。执行时先解析范围，再导出 git 产物，然后分类、读取关键 diff、生成文档并校验。
适用场景：需要多周或跨版本总结框架级变更、生成面向开发者的发布说明草稿、按主题而非按提交时间线梳理变更时。
限制：所有生成文档均为 Draft；必须先落盘产物再分析，不能把完整 diff 直接读入上下文；每个结论需引用具体提交哈希或文件路径；时间范围可能返回 0 个提交，需检查日期格式；非 easy-claude 项目需从实际文件路径推导分类；分类映射可通过 project-config.json 覆盖；部分步骤依赖 Codex 环境与子代理授权，若环境不支持需先询问用户。具体收费、平台支持范围等资料暂未提供。