catoncat Sherlog
用 shlog 检索本机 agent session 历史。命令语法与默认值以 shlog --help 和 shlog <command> --help 为准；本 skill 只给 help 教不了的检索决策。
主循环
- 定位：按问题选
find/list/stats（usage 看--help）。主题或关键词明确用find；已知项目/时间、关键词弱用list。完成：有可读取的 candidate identity 和明确 scope。 - 取证：执行 candidate 的
evidenceRead.command，或read-range/read-page。完成：每个历史事实都有read-*返回内容支持；hasMore=true且目标上下文未解决时继续翻页，抽样则说明边界。 - 证明范围：只在回答依赖 latest / completeness / miss 结论时，对相同 selector 跑
status --json。完成：按recommendedAction决定 query、同范围 sync，或说明无法证明。 - 报告：不确定处明确说明；不伪造完整性或不存在的证据。
直接执行匹配任务的只读命令，不用 status / sync 预检；失败时按宿主权限原样执行 recommended（或唯一）typed nextAction.commands[].command。不要自行重建命令，也不要把 cwd/root/selector 查询扩成 all(root)。
不变量
find/read/list/stats/cold list只读；sync是唯一 content writer；cold add/remove只写 retention state。只读命令不隐式 sync/migrate。- 内容事实只能来自
read-*；title/snippet/profile 命中只是 candidate。 - message anchor 走
read-range；profile-only 命中不伪造 seq；anchor_not_found时按 nextAction 回退。 find --cwd构造 exact cwd selector；list --cwd是 substring filter，两者 coverage 语义不同。- latest/completeness/miss 结论必须匹配同 selector 的 coverage proof。
- 破坏性操作（
sync --prune、cold remove）只在用户明确表达删除意图后执行。 - 跨 source 读取使用
find返回的sessionRef，不从 UUID 猜 source。
References（按触发条件加载）
- 遇到 typed error / zero results / 迁移升级：
references/failure-cookbook.md - 需要跨命令语义陷阱或 selector 形状：
references/cli-surface.md - 需要解析
evidenceRead/ coverage /nextAction字段：references/json-schema.md - 需要具体场景示例与完成标准：
references/progressive-workflow.md - 需要 query/tokenizer 或只读 metadata SQL 细节：
references/advanced-queries.md