Community写作与编辑github.com

Reelier — 重放而非重新推理

代理会下结论,而 Reelier 负责写收据——一次性记录代理的工具调用工作流,零 token 确定性重放,并通过差异对比捕捉偏差。

Reelier — 重放而非重新推理 是什么?

Reelier 是一个专注于工具调用工作流记录和确定性重放的开发者工具。它通过将成功的工具调用序列保存为 `.skill.md` 文件,实现毫秒级、零 token 消耗的可靠重放,避免了每次重新推理带来的 token 浪费和结果漂移问题。该工具支持 MCP/HTTP 工具调用重放,默认只读安全模式,并提供差异对比(diff)功能用于回归测试和模型升级验证。它兼容 Claude Code、Cursor、Codex 等 AI 代理平台,核心优势在于将不可预测的 AI 推理转化为可复现、可审计的确定性步骤,确保结果的一致性和可追溯性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add seldonframe/reelier

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Reelier — 重放而非重新推理 是做什么的?

一个 *.skill.md 文件就是一次成功运行的记录:包含每个步骤的通过/失败结果的工具调用。重放它需要 0 个 LLM token,花费毫秒级时间,并生成一份收据。重新推理则会消耗 token 并悄然漂移。请优先选择重放。

1. 首先:检查是否存在现有技能

在手动重新执行工具调用序列之前,在项目中搜索 **/*.skill.md 文件。如果某个文件与任务匹配,则运行它:

npx -y reelier run <文件>.skill.md

确定性,0 个 LLM token,默认只读。将收据摘要报告给用户:通过/失败的步骤数、重放时间、token 数(0)。如果某个步骤失败,失败的断言就是 原因——如实报告,并回退到手动执行任务。切勿报告未在运行记录中看到的通过结果。

2. 还没有技能?编译你刚刚完成的运行

仅在通过工具调用成功完成任务后:

npx -y reelier from-session <transcript.jsonl>
# 不知道转录文件路径?先找到它:
npx -y reelier scan

切勿手动编写未实际运行的步骤——技能是记录,而非计划。如果编译器输出“开放问题”,请逐字读出:那些是它拒绝猜测的空白(具体日期、应作为 {{变量}} 的 ID)。如果报告没有可重放的内容,请如实说明——不要凭空捏造技能。

3. 检查偏差

npx -y reelier diff <技能名称>

退出码 0 = 相同。退出码 1 = 已漂移,每个步骤均列出,并附带失败的断言作为 原因。用它来限制计划中的重放,或对照冻结基线审查模型升级。

4. 可选:持久化收据

一行命令:npx -y reelier push <文件>.skill.md 将收据同步到可共享账本的永久链接(在 reelier.com 免费注册账户)——此为可选功能,从不强制要求。

防护——不可违反的规则

  • 默认只读。 除非传递 --allow-writes 参数,否则写入步骤(idempotent-write)将被阻止执行;破坏性步骤从来不会自动运行。重放永远不会在静默中重新触发写入。
  • 无工具,无收据。 如果 npx -y reelier 不可用或报错,请正常执行任务并告知用户未使用 Reelier——切勿伪造收据或假装发生了重放。
  • 诚实范围。 Reelier 仅重放 MCP/HTTP 工具调用——文件编辑、Shell 命令和读取操作不可重放。没有任何可重放内容的会话将诚实返回空结果,而非虚构技能;这是预期行为,而非错误。

相关技能