SuperAPI AI 工具集

harvest-sessions

通用与其它

查看项目

更新于 10-16 01:07

技能介绍

用途:作为全局 AGENTS.md 中“即时捕获”规则的无值守兜底。即时规则依赖智能体当场察觉,会漏掉没人注意到的内容;本技能读取这些会话留下的记录,补上本应归档的内容。每次只处理水位线之后的新会话,然后停止,不自行调度,由 acron 负责周期触发。

主要能力:状态保存在水位线文件中,因此单次运行是幂等的,安静的一天只做一次扫描即退出。空跑也算成功,多数日子没有可长期留存的内容,应报告“nothing to capture”并推进水位线,不要为凑数而造页面。捕获标准是“持久且不可恢复”:六个月后仍成立且仍被需要,且读 HEAD 仓库无法得知,例如费力的根因、决策与约束、实测数字、与文档矛盾的第三方行为、被迫的变通方案、用户表达的跨会话策略。两项独立判断,任一不满足即拒绝,边界情况一律拒绝。

使用方式:先做预检,设置 SKILL_DIR 为本技能目录,cd 到 secondbrain 检出目录,工作树脏则中止,阅读 CLAUDE.md 与目标领域的 CLAUDE.md,并用 mkdir -p ~/.local/state/secondbrain-harvest 与 touch ~/.local/state/secondbrain-harvest/.tick 记录本次开始时间。随后用 python3 "$SKILL_DIR"/scripts/digest_sessions.py --list 列出候选,无水位线时回退到 24 小时窗口,零会话则跳到第 5 步。再用 python3 "$SKILL_DIR"/scripts/digest_sessions.py 生成摘要,对每条摘要应用捕获标准并记录判定;摘要信息不足时用 --only <path> 重读完整记录。之后按全局 AGENTS.md 的工作产物规则路由,优先编辑已有页面,确无覆盖才新建,属于待办的内容应开 issue。写入时遵循仓库的 ingest 流程,内联引用会话路径,双向交叉链接,新页面更新主题 index.md,并向领域 _log.md 追加一行。最后创建 harvest/YYYY-MM-DD 分支,按全局 git 规则提交,用 gh 开 PR,正文每条捕获一行,列出判定与拒绝的会话数,停在开 PR 处,由用户合并,最后把 .tick 移动为 watermark。

限制与红线:只开 PR,绝不提交到 main;写入前必须脱敏,逐行检查凭据、令牌、客户名与第三方个人数据;引用会话路径而非复制原始记录,原始记录位于 ~/.claude 或 ~/.codex;只操作 wkentaro/secondbrain,不得编辑或对仅读取过的源仓库提交、开 issue。失败时不要推进水位线,下次会重新判定同一窗口。资料未提供具体安装命令、收费与平台信息。