用途：分析 SpecStory AI 编程会话记录（.specstory/history），检测会话从最初目标偏离到无关任务（yak shaving）的程度，并给出 0-100 的 yak shave 评分。
主要能力：解析指定日期范围或近期会话的历史文件；从首条消息提取初始意图；跟踪文件引用、工具调用模式与目标变化等“领域切换”；按领域切换（40%）、目标完成度（25%）、会话长度比（20%）、工具类型级联（15%）计算评分；汇总最严重的偏离会话与模式。评分区间：0-20 高度专注，21-40 轻微跑题，41-60 中度漂移，61-80 明显剃牦牛毛，81-100 深度兔子洞。
使用方式：可通过 /specstory-yak 斜杠命令用自然语言调用，如“last 30 days”对应 --days 30、“top 10”对应 --top 10、“january”对应 --from 2026-01-01 --to 2026-01-31、“by modification time”对应 --by-mtime、“as json”对应 --json、“save to yak-report.md”对应 -o yak-report.md。也可直接运行脚本：python /path/to/skills/specstory-yak/scripts/analyze.py [options]。参数包括 --days N（默认 7）、--from DATE、--to DATE、--path PATH、--top N（默认 5）、--json、--verbose、--by-mtime、-o/--output FILE。
输出：报告含分析会话数、平均分、最严重偏离会话（含起始与最终目标、领域切换次数）、最专注会话及检测到的模式。运行后需在原始报告前加入 3-5 句个性化 LLM 总结，包含总体评价、最突出会话、重复模式与可操作建议或玩笑。
限制：依赖 .specstory/history 目录与 SpecStory 会话记录；评分方法为启发式，非精确度量；未提供安装方式、依赖要求、平台支持与收费信息。