其他
当需要理解函数、文件或代码行为何存在时…
面对函数、文件或特定代码行,想知道它为什么存在、由什么需求驱动时,可用 Entire CLI 追溯创建它的原始会话。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 39/100 ×0.15
适用场景
当需要理解函数、文件或代码行为何存在时,特定
解决思路
- 通过追踪源码创建时的原始对话,解释源码背后的意图;可处理函数、文件或代码行。
- 对函数:解释该函数为什么存在、当时在解决什么问题。
- 对文件:解释该文件的用途、哪些需求驱动其创建。
- 对行变更:解释该特定行为何被添加或修改。
- 接收 `<function, file, or line>` 参数来指定要解释的函数、文件或代码行。
- 在技能调用的第一次响应开头输出 `Entire Explain:`,后跟一个空行,然后输出内容。
- 仅对该调用的第一次响应应用该 header;在同一调用的后续回合中不要重新打印(例如用户回答澄清问题后)。
- 不要在错误或提前退出响应中包含该 header(例如 “Entire CLI is required but not installed”、“this file is not tracked by git”、“no session transcript was found for this commit”);header 的出现应表示技能已运行并产生真实输出。
- 运行 `entire version` 验证 `entire` CLI 已安装。
- 如果 `entire` 命令未找到,停止并告诉用户:“The Entire CLI is required but not installed. Install it from https://entire.io/docs/cli and try again.”
- 使用 Haiku agent 通过 `git blame` 或 `git log` 识别引入该代码的 commit。
- 如果文件未被 git 跟踪,停止并告诉用户:“This file is not tracked by git, so I can't trace its history.”
- 如果 `git blame` 返回无有用结果(例如代码未提交),停止并告诉用户:“This code hasn't been committed yet, so there's no history to trace.”
- 使用 Sonnet agent 通过 `entire checkpoint explain --no-pager --commit COMMIT_SHA` 读取会话记录。
- 如果该命令失败或返回无会话记录,停止并告诉用户:“No session transcript was found for this commit. It may have been created outside of an Entire session (e.g., a manual commit).”
适用边界 · 注意事项
- 未安装 `entire` CLI 时不适用;需先从 https://entire.io/docs/cli 安装。
- 目标文件未被 git 跟踪,或目标代码尚未提交时,无法追踪历史。
- 目标 commit 没有 Entire 会话记录(例如手动提交)时,无法找到原始会话。