SuperAPI AI 工具集

backfill

通用与其它

查看项目

更新于 10-15 22:10

技能介绍

用途:backfill 通过重放仓库的决策历史(git 提交与 Claude 会话记录),重建 OKF 知识包,效果如同 okf 技能的 Stop 钩子从一开始就启用。适用于为已有仓库创建 .okf/ 知识包。

主要能力:提取层是确定性的(同一仓库产生字节一致的事件),重放层是 LLM 循环,可重放、可审计但非字节一致。流程为 Preflight → Extract → Bootstrap → Replay(Map+Reduce)→ Finalize。事件以 JSONL 存储,git 事件来自 git log --first-parent --numstat,会话事件来自 ~/.claude/projects/<repo-slug>/*.jsonl。

使用方式:先运行提取脚本生成事件流:uv run "${CLAUDE_SKILL_DIR}/scripts/okf_backfill_events.py" <repo-dir> --out events.jsonl。随后 Bootstrap 创建 .okf/ 与游标文件,Replay 分两阶段:Map 阶段并行启动 okf:event-analyzer 代理分析事件,Reduce 阶段由单个 okf:bundle-weaver 代理按时间顺序折叠进 .okf/。Finalize 阶段手写 index.md、追加日志、删除游标并运行自检与覆盖率检查:uv run "${CLAUDE_SKILL_DIR}/scripts/okf_backfill_events.py" --check-coverage events.jsonl .okf,以及 uv run "${CLAUDE_SKILL_DIR}/../validate/scripts/okf_validate.py" .okf --strict。

限制:重放非字节一致(时间戳、摘要每次运行会变);提取的事件流写入暂存区,绝不提交;会话文本在提取前截断。历史超过 500 个事件时建议拆分或使用 --skip-globs 排除低信号路径。Map 阶段并发为 4 到 10。未来来源(GitHub PR/issue、发布说明、CI/部署日志)尚未实现。重建的概念为草稿状态,非稳定。具体收费、价格、平台信息暂未提供。