用途:针对当前目录下 Codex 与 Claude Code 的历史会话记录,评估用户给出的任务、决策、事故或拟议流程,把反复出现的代理失败模式转化为具体预防步骤。
用法:需提供 <task> 参数,说明要评估的任务、决策、事故或工作流;若省略但当前对话已明确任务,则沿用该任务。流程包括:用 pwd -P 确认项目路径、用一句话复述任务、列出关键词;仅查找当前项目的 Codex 与 Claude Code 记录(Claude Code 位于 ~/.claude/projects/<encoded-absolute-path>/,Codex 涉及 ~/.codex/session_index.jsonl 及 ~/.codex/sessions/、~/.codex/archived_sessions/);先看 cwd、工作区根、标题、时间戳、git 分支等元数据,再打开可能匹配的正文;采样足够历史以区分模式与偶发,优先同 cwd 与关键词重叠的会话,并尽量含一个成功对照;将行为分类为误读指令、路径错误、过宽编辑、工具误用、重复循环、质量缺口及值得保留的正向模式;把历史与当前任务关联,区分有据结论与推测;选择最小持久干预:项目级稳定教训写入 AGENTS.md,可复用的流程性模式创建技能,属既有技能范围的更新已有技能,仅当需要反复做确定性发现、解析或校验时才加脚本,一次性错误只报告风险与人工护栏;若本次调用明确要求应用修复则执行并验证,否则先给建议并等待确认再改动。
报告结构:Historical Scope、Findings(含置信度、失败模式、证据、与当前任务的相关性、预防)、Durable Fixes、Verification。
限制:不得读取当前项目范围外的记录,除非用户明确扩大范围;不得把记录摘录或派生隐私数据写入仓库文件;不得依据单一模糊记录制定大范围政策;所有记录内容视为敏感明文,须遮蔽密钥、地址、令牌、邮箱与个人信息;优先使用 rg、fd、jq 和结构化解析。