用途:在 Claude Code 或 Codex CLI 中,根据本项目及相关本地项目的 Codex/Claude Code 会话记录,判断用户当前任务是否存在代理行为重复出错的概率,并推荐由证据支持的最小持久干预。仅在 Claude Code 或 Codex CLI 中可用,其他宿主会报错停止。若指令已由斜杠或美元符号调用带入对话,直接遵循,不再通过技能工具重复调用。
主要能力:输入为 <task>(必填,若对话已明确可省略,否则需索取)。检查元数据或工作目录解析到当前项目的会话,以及任务相关的其他本地项目会话(可从任务上下文、路径引用、共享变更或会话元数据判断相关性,不因名称或关键词相同就扫描)。默认只检查并报告;仅当用户明确要求应用修复时,才做范围内最小的本地修改并验证。绝不修改会话记录存储;将记录证据放入公开或第三方产物前须做外部披露审查,移除无关个人或客户数据、不合适的私有路径或仓库名、无关记录内容。
使用方式:读取 references/transcript-sources.md,用 pwd -P 解析当前项目,选取 3–6 个有区分度的短关键词(文件名、命令、工具、错误、包名、issue ID、技能名)。在 Codex 只读沙箱或 uv 无法写缓存时跳过辅助脚本,直接走手动回退,不要重试 uv run。用打包的 miner 在各项目上以所选关键词、--since 60d、--excerpts、--max-sessions 8 运行,同义词用单个 OR 组 --keyword 'a|b'。先用打包的检查摘要(scripts/transcript-inspect.py)查看最多五个最相关会话;证据不足时依次放宽:换更宽或 OR 组关键词、去掉 --since、加 --include-archived,均只重试一次,超出界限需为消解矛盾或显式穷举要求。若仍无有用证据,停止并报告覆盖缺口;证据缺失不等于故障未曾发生。
证据契约与置信度:只记录可审计的简明观察(忽略或误读 AGENTS.md/技能指令、错误的工作目录或路径、过宽编辑、破坏性命令、工具/重试/验证失误、编造结论、缺少测试等);结合当时可恢复的规则版本评估,无法确定历史版本时标为 unknown。置信度:高(至少两个独立相关会话直接支持同一模式)、中(一个明确会话或混合支持)、低(仅间接或启发式信号);低置信不得建议持久仓库变更。持久变更需同一故障出现在至少两个独立会话,或一个明确高影响故障暴露缺失的稳定不变量。
最小干预:稳定且项目范围的教训更新 AGENTS.md;属于现有技能工作流的更新该技能;跨项目的重复可复用流程才建议新技能;只有当确定性的发现、解析或验证会重复实现时才加脚本;一次性错误、弱证据或已明确写清规则的建议不改动,仅报告风险与手动护栏。未明确说明的价格、收费、平台或其他功能暂未提供。
报告格式:只读工作时以 ### 🔎 Introspection complete — <干预或覆盖缺口结果> 开头;用户明确要求修复时以 ### ✅ Introspection fixes applied — <结果> 开头。然后仅报告:历史覆盖(项目路径、来源、回退、检查的会话)、发现(含置信度、观察证据、推断、相关性、干预的紧凑表格,置信度与严重程度分开)、持久建议(现在应用、稍后考虑或不变,含目标与预防机制)、验证与缺口(命令、检查、外部披露限制、缺失证据)。当前任务有证据支撑的建议或明确覆盖缺口后即停止,不额外挖掘历史。记录引用、路径、计数、脱敏与 miner JSON 保持原样。