SuperAPI AI 工具集

learning-capture

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

Learning Capture 是 Terraphim 的自动学习捕获系统技能,用于在 AI 辅助开发会话中记录失败的 bash 命令及其上下文。

用途:自动捕获 bash 命令失败,把每次失败保存为结构化 Markdown 文档,包含命令、错误输出、退出码、工作目录和时间戳。

主要能力:通过 PostToolUse Claude Code 钩子自动捕获;文档存储在 ~/.local/share/terraphim/learnings/,含 YAML frontmatter;可按命令模式查询历史失败;可为已有学习记录添加修正;支持为 Claude Code、Codex、OpenCode 安装钩子。钩子仅处理 Bash 工具且仅处理非零退出码,会跳过测试命令(如 cargo test、npm test),捕获失败时仍继续运行。

使用方式:安装钩子 terraphim-agent learn install-hook claude(也支持 codex、opencode);查询用 terraphim-agent learn list、terraphim-agent learn query "cargo build";添加修正用 terraphim-agent learn correct <id> "..."。可手动创建 ~/.claude/hooks/learning-capture.sh 并配置到 ~/.claude/settings.json 的 hooks.PostToolUse。调试用 export TERRAPHIM_LEARN_DEBUG=true。

适用场景:搭建新开发环境、排查钩子未捕获问题、开始复杂任务前回顾积累的学习、为反复出现的错误补充修正、配置钩子行为。

限制:仅针对 bash 命令失败;测试命令被跳过;其余未提供。