用途:从本地智能体日志中找出反复出现的痛点,将其转化为可落地的技能候选、复用机会或对已有技能的更新建议。
主要能力:初始化来源集(如 ~/.codex/history.jsonl、~/.codex/archived_sessions/.jsonl、~/.codex/sessions/.jsonl 及 ~/.codex/log/*,以及已知 dotfiles 目录下的 Cursor/Codex 日志);归一化提取信号,解析堆栈并分类失败类型(auth、type-check、llm-error、git/ci、runtime、refactor-merge、test),识别重复命令短语(rg、mypy、pytest、gh、git、包管理器失败),记录频率、新近度与项目上下文;按领域、命令谱系和错误签名聚类,降低一次性会话权重;与现有技能按名称和描述比对,重叠高则建议更新,无覆盖则建议新建;输出影响、频率、置信度、技能契合度与首次应用命令集。
使用方式:需提供 SCOPE(必填,仓库路径/工作区/工具域)、SOURCES(必填,有序来源列表)、PRIVACY_POLICY(必填,个人日志的明确指示);TIMEFRAME 与 TOP_N 可选。默认通过聊天/stdout 返回结果,仅在用户选择或工作流要求时创建持久化产物。可选扩展个人信号源,须经明确授权,且与编码信号输出隔离。
适用场景:希望从历史智能体活动中发现缺失技术技能、在创建新技能前需要可复现标准、验证已有技能是否覆盖某模式时。
限制:未经明确许可不得推断或输出消息日志中的私密内容;跳过二进制/损坏文件;避免提出含未解决运行上下文(凭据、环境、私有 URL)的技能;证据模糊时返回低置信度并要求补充会话样本。参考 references/sources.md 与 references/scorecard.md。