历史推理检索Skill recall-reasoning

---

name: recall-reasoning description: 搜索过去的推理以找到相关决策和方法 user-invocable: false

回顾过去的工作

搜索之前的会话，找到相关的决策、成功的方法和失败的方法。查询两个来源：

1. Artifact Index - 交接文档、计划、带有事后分析（什么成功/失败）的分类账
2. Reasoning Files - 构建尝试、测试失败、提交上下文

何时使用

• 开始与过去会话相似的工作时
• “我们上次处理X时做了什么？”
• 寻找之前有效的模式
• 调查为什么某种方式被采用
• 调试之前遇到的问题

使用方法

主要：Artifact Index（丰富上下文）

uv run python scripts/core/artifact_query.py "<query>" [--outcome SUCCEEDED|FAILED] [--limit N]

这个命令搜索带有事后分析（什么成功、什么失败、关键决策）的交接文档。

次要：Reasoning Files（构建尝试）

bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "<query>"

这个命令搜索 .git/claude/commits/*/reasoning.md 以找到构建失败和修复。

示例

# 搜索与认证相关的工作
uv run python scripts/core/artifact_query.py "authentication OAuth JWT"

# 只找到成功的方法
uv run python scripts/core/artifact_query.py "implement agent" --outcome SUCCEEDED

# 找到失败的方法（以避免重复错误）
uv run python scripts/core/artifact_query.py "hook implementation" --outcome FAILED

# 搜索构建/测试推理
bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "TypeError"

搜索内容

Artifact Index（交接文档、计划、分类账）：

• 任务摘要和状态
• 什么成功 - 成功的方法
• 什么失败 - 死胡同及原因
• 关键决策 - 选择及其理由
• 来自分类账的目标和约束

Reasoning Files（.git/claude/）：

• 失败的构建尝试和错误输出
• 失败后的成功构建
• 提交上下文和分支信息

解释结果

从 Artifact Index：

• ✓ = 成功结果（要遵循的模式）
• ✗ = 失败结果（要避免的模式）
• ? = 未知结果（尚未标记）
• 事后分析部分展示提炼的学习

从 Reasoning：

• build_fail = 无效的方法
• build_pass = 最终成功的方法
• 多次失败后才成功 = 非平凡问题

流程

1. 首先运行 Artifact Index 查询 - 更丰富的上下文，事后分析
2. 查看相关交接文档 - 检查什么成功/失败部分
3. 如果需要，搜索推理 - 针对特定构建错误
4. 应用学习 - 遵循成功模式，避免失败模式

无结果？

Artifact Index 为空：

• 运行 uv run python scripts/core/artifact_index.py --all 以索引现有交接文档
• 为将来回顾创建带有事后分析部分的交接文档

Reasoning 文件为空：

• 在构建后使用 /commit 捕获推理
• 检查 .git/claude/ 目录是否存在