用途：在 Fathom/Granola 记录同步到笔记库后，对教练或治疗会谈记录进行结构化总结，并把摘要追加到原笔记末尾。分析由 Claude Code 在会话内直接完成，不调用 Anthropic API、不产生额外计费，仅使用当前订阅。
主要能力：提取关键洞察（3–5 条）、已做决定、行动项（时间敏感项加 [URGENT]，日程项加 [SCHEDULING]）、会谈主题（2–3 个）；深度模式还会读取同一参与者的历史会谈，补充模式识别、进展评估、能量/动机标记和潜在障碍，并链接 2–4 条相关 Trails。
使用方式：先运行确定性上下文收集脚本：
python3 ~/.claude/skills/coaching-session-summarizer/scripts/gather_context.py
<transcript-file> --vault ~/Brains/brain
若文件名未包含参与者，可加 --participant <name-slug>。随后由代理分析内容，并用 Edit 将摘要追加到记录文件末尾，不覆盖原有内容。摘要使用固定结构（AI-Generated Summary、Deep Analysis、Connected Trails），日期用 date +%Y-%m-%d 生成。
模式：quick 仅输出洞察、决定、行动项和主题；deep 为治疗或里程碑会谈推荐，包含历史会话读取与深度分析。
适用场景：日历同步或 Granola/Fathom 导出后出现 -coaching.md、-therapy.md、*-session.md 新文件时，可提示“检测到新会谈，是否立即总结？”。
限制：Trails 链接需笔记库根目录存在 Trails/ 目录；跨会话比较依赖一致命名（如 YYYYMMDD-name-coaching.md）。重复运行安全，gather_context.py 会剥离旧摘要；若要替换而非叠加，需先手动删除旧的 ## AI-Generated Summary 块。旧版 summarize_session.py 为无交互回退方案，会调用 Anthropic API 并消耗 ANTHROPIC_API_KEY 余额，仅在无交互代理时使用。