用途 visualize-changes 用于把当前会话中所做的代码变更整理成一份可视化说明,并显示在原生 Glimpse 窗口中。当用户希望对本次会话改动获得直观解释时,可使用该技能。
主要能力
- 通过 git status --short、git diff --stat、git diff --cached --stat 以及针对具体文件的 git diff --unified=5 调用,检查当前会话改动。
- 先编写一份 Markdown 说明,通常保存为 /tmp/session-diff-report.md。
- 使用 scripts/render-md.ts(通过 Bun 运行)渲染该 Markdown。
- 渲染器通过 glimpseui 包自动在 Glimpse 中打开页面。
- 围栏 diff 块始终使用来自 Diffs.com 的 @pierre/diffs 浏览器模块渲染,默认采用 split 布局;diff 块高度限制在约 60% 视口内,超出时在页面内滚动。
- 直接使用内置的类 Critique 主题资源:assets/critique-base.css 复制自 Critique Web 渲染器在 cli/src/ansi-html.ts 中的默认样式,assets/critique-markdown.css 提供 Markdown 布局与宿主级样式。
页面内容 页面通常包含:会话的简短标题与摘要;文件级分节,说明改了什么以及为何重要;使用命令 diff(如 !\git diff -- path/to/file``)内嵌展示变更;以简短代表性片段代替完整补丁(diff hunk 无需覆盖整个文件);按最能解释改动的顺序排列分节与 hunk,而非文件顺序;在相关时列出风险、后续工作或待定问题。
使用方式 内置 CLI 接受单个内联 Markdown 参数或标准输入,例如:
bun scripts/render-md.ts "# Session diff\n\n- Summary"
或
cat /tmp/session-diff-report.md | bun scripts/render-md.ts
在智能体会话中使用渲染器时:不要给它套上短超时;应在后台终端/PTY 会话中运行;在用户查看完 Glimpse 窗口前保持该会话存活。
渲染偏好与规则 优先使用命令 diff(!\git diff ...``)而不是把原始 diff 内容粘贴进围栏块;命令 diff 在渲染时执行,始终反映工作区当前状态。带有字面补丁内容的围栏 diff 块仍作为回退方式支持。此工作流中不要使用 pnpm cli 或 libretto open;展示优先使用内置 scripts/render-md.ts CLI,diff 检查使用 Git。如果 diff 较大,应汇总重复修改并只展示信息量最大的片段。必须保持渲染器进程在后台终端中存活,否则 Glimpse 窗口可能随父进程一起关闭。