mcpField
R
recall-reasoning

recall-reasoning

github.com/parcadeiAgent 工作流3.9k603 次安装39 周前更新
代码仓库

关于 recall-reasoning

一项用于检索过往项目会话的技能，可查找决策、有效做法和失败记录。它优先查询 Artifact Index，再搜索推理文件中的构建与测试上下文。

主要功能

  1. 01搜索交接记录、计划和台账
  2. 02按结果筛选记录
  3. 03搜索构建与测试推理记录
  4. 04查看决策和复盘内容

适用场景

  1. 01复用以往工作中的有效方法
  2. 02调查某项决策的缘由
  3. 03查找历史构建失败的修复方法

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill recall-reasoning

安装后在 Claude Code 中输入/recall-reasoning确认已加载。

详细介绍

回顾过往工作

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

  1. 工件索引 - 包含事后总结（哪些有效／失败）的交接记录、计划和日志
  2. 推理文件 - 构建尝试、测试失败和提交背景

使用时机

  • 开始与过往会话相似的工作
  • “我们上次处理 X 时是怎么做的？”
  • 查找之前有效的方法
  • 调查某件事为何采用某种做法
  • 调试之前遇到的问题

用法

主要来源：工件索引（背景信息丰富）
uv run python scripts/core/artifact_query.py "<query>" [--outcome SUCCEEDED|FAILED] [--limit N]

此命令会搜索包含事后总结（哪些有效、哪些失败、关键决策）的交接记录。

次要来源：推理文件（构建尝试）
bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "<query>"

此命令会搜索 .git/claude/commits/*/reasoning.md，查找构建失败和修复记录。

示例

# Search for authentication-related work
uv run python scripts/core/artifact_query.py "authentication OAuth JWT"

# Find only successful approaches
uv run python scripts/core/artifact_query.py "implement agent" --outcome SUCCEEDED

# Find what failed (to avoid repeating mistakes)
uv run python scripts/core/artifact_query.py "hook implementation" --outcome FAILED

# Search build/test reasoning
bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "TypeError"

搜索内容

工件索引（交接记录、计划、日志）：

  • 任务摘要和状态
  • 有效的方法 - 成功的方法
  • 失败的方法 - 行不通的方法及其原因
  • 关键决策 - 附有理由的选择
  • 日志中的目标和限制条件

推理文件（.git/claude/）：

  • 构建失败尝试及错误输出
  • 失败后成功的构建
  • 提交背景和分支信息

结果解读

来自工件索引：

  • ✓ = 已成功（可遵循的模式）
  • ✗ = 已失败（应避免的模式）
  • ? = 未知结果（尚未标记）
  • 事后总结部分会展示提炼后的经验

来自推理文件：

  • build_fail = 未奏效的方法
  • build_pass = 最终成功的方法
  • 成功前多次失败 = 问题并非易事

流程

  1. 先运行工件索引查询 - 背景信息更丰富，且包含事后总结
  2. 查看相关交接记录 - 检查哪些方法有效或失败
  3. 如有需要，搜索推理文件 - 查找具体的构建错误
  4. 应用经验 - 遵循成功的模式，避免失败的方法

没有结果？

工件索引为空：

  • 运行 uv run python scripts/core/artifact_index.py --all，为现有交接记录建立索引
  • 创建包含事后总结部分的交接记录，便于今后查阅

推理文件为空：

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

评论

支持 Markdown