用途:从本地 pi 会话日志中检索证据,帮助用户理解自己的使用模式,包括反复行为、提示习惯、工作流循环、摩擦点与偏好。技能本身只负责证据检索与判断,分析结论由代理自行推理得出。
主要能力:通过 scripts/session-db.ts 将 pi JSONL 会话加载进 DuckDB,提供 SQL、搜索、上下文等辅助命令。可执行 preset overview、exact-short-repeats、long-sessions,以及 turns、ngrams、search、context、examples、sample、interventions、sql 等子命令;interventions 支持按 signal、project、since、pasted、context 等参数筛选,输出格式可用 --format table|json|markdown。
必要用法:在技能目录内先运行 cd <dot-pi>/skills/session-reflect 与 npm install 安装依赖,再用 npx tsx scripts/session-db.ts build 构建证据库,指定其他会话根目录时加 --root <session-root>。默认只写 ~/.pi/agent/cache/session-reflect/,仅在用户明确要求其他位置时使用 --db,可用 clean 移除默认缓存。
核心规则与限制:讨论分析方法前先与用户确认范围;不得硬编码英文行为分类或词组作为结论;重复文本、n-gram、FTS 命中与 SQL 聚合只作为证据线索而非解释;解读“go ahead”等短句前需查看上下文;保留多语言文本、拼写错误、缩写与粘贴日志;重要结论需引用会话路径或消息键;区分观察事实、解释、置信度、替代解释与建议。涉及高信号干预时先参考 references/intervention-events.md。产出前建议阅读 references/reflection-protocol.md,选查询时参考 references/query-cookbook.md。
适用场景:用户希望了解自身 pi 使用模式、复盘提示习惯或定位工作流摩擦点时使用。
限制:属于本地日志分析技能,不提供云端分析;具体效果、收费、平台支持等未在资料中提供,暂未提供。