vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 19:40:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

Diffs: Migrate tool usage guidance from before_prompt_build to a plugin skill (#32630)

Browse Source 
Merged via squash.

Prepared head SHA: 585697a4e1
Co-authored-by: sircrumpet <4436535+sircrumpet@users.noreply.github.com>
Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com>
Reviewed-by: @gumadeiras
This commit is contained in:
Eugene
2026-03-03 16:50:59 +10:00
committed by GitHub
parent 997197c6c9
commit 5341b5c71c
9 changed files with 91 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
extensions/diffs/skills/diffs/SKILL.md Normal file
View File

@@ -0,0 +1,22 @@
---
name: diffs
description: Use the diffs tool to produce real, shareable diffs (viewer URL, file artifact, or both) instead of manual edit summaries.
---
When you need to show edits as a real diff, prefer the `diffs` tool instead of writing a manual summary.
The `diffs` tool accepts either `before` + `after` text, or a unified `patch` string.
Use `mode=view` when you want an interactive gateway-hosted viewer. After the tool returns, use `details.viewerUrl` with the canvas tool via `canvas present` or `canvas navigate`.
Use `mode=file` when you need a rendered file artifact. Set `fileFormat=png` (default) or `fileFormat=pdf`. The tool result includes `details.filePath`.
For large or high-fidelity files, use `fileQuality` (`standard`|`hq`|`print`) and optionally override `fileScale`/`fileMaxWidth`.
When you need to deliver the rendered file to a user or channel, do not rely on the raw tool-result renderer. Instead, call the `message` tool and pass `details.filePath` through `path` or `filePath`.
Use `mode=both` when you want both the gateway viewer URL and the rendered artifact.
If the user has configured diffs plugin defaults, prefer omitting `mode`, `theme`, `layout`, and related presentation options unless you need to override them for this specific diff.
Include `path` for before/after text when you know the file name.