session-scan（Tier 1）用于为通过 ccrider MCP 发现的 Claude Code 会话计算确定性指标。依赖 ccrider MCP（见 https://github.com/neilberkman/ccrider），未安装时无法运行。
用途与用法：以斜杠命令调用，支持参数 --since DATE（ISO 日期过滤，默认近 7 天）、--project NAME（按项目路径子串过滤）、--limit N（最大会话数，默认 50）、--list（仅发现并展示表格，不评分）、--rescan（重算已扫描会话）。
主上下文只负责：解析参数、发现会话（mcp__ccrider__list_recent_sessions，响应约 1KB）、去重（读取 .claude/session-metrics/metrics.jsonl，报告新增与已在账本数量）、解析评分脚本路径（glob **/session-scan/references/compute-metrics.py）、为每个未扫描会话启动一个 haiku 子代理、收集结果并展示按摩擦降序的汇总表、更新 .claude/session-metrics/latest-scan.json。
评分由子代理完成：取会话消息（mcp__ccrider__get_session_messages，last_n: 200），写入临时 JSON，运行 compute-metrics.py 生成结果文件，回报得分。所有子代理并行启动，每个会话一个子代理。
关键限制（Iron Laws）：绝不在主上下文调用 get_session_messages（响应 5-50KB JSON，会撑爆上下文）；每个会话一个子代理，仅取一个会话；每个 Task 使用 mode=bypassPermissions（子代理需要 Write 与 Bash）；子代理提示中使用绝对路径；结果写入文件而非直接追加，避免 jsonl 竞态；metrics.jsonl 只追加不可修改既有条目；处理完成后删除临时与结果文件。评分细节见 references/scoring-guide.md。