diff-previewer · diff
v1.0.0 to v1.0.0
1 added, 1 removed. Audit A to A.
---
name: diff-previewer
display-name: Diff Previewer
description: 多文件差异预览器 - 在应用AI变更前展示丰富的diff预览，支持部分接受和变更地图
version: 1.0.0
category: development
user-invocable: true
tags: [diff, preview, change-map, review, undo, partial-accept]
capabilities:
[diff-generation, change-visualization, partial-accept, token-optimization]
tools:
- file_reader
- git_operations
- execution-capabilities: [data:result, data:task, filesystem:read, host:logger, process:cwd, process:execute]
+ execution-capabilities: [data:result, data:task, filesystem:read, host:logger, host:process, process:cwd, process:execute]
handler: ./handler.js
instructions: |
Use this skill when the user wants to preview changes before applying them,
review staged/unstaged git diffs, compare two files, or get a compact summary
of modifications for AI context. Parses unified diff format into structured
data with file-level and directory-level statistics. Includes token estimation
for context window optimization.
examples:
- input: "/diff-previewer --staged"
output: "Structured diff of all staged changes with per-file additions/deletions"
- input: "/diff-previewer --unstaged"
output: "Structured diff of all unstaged working tree changes"
- input: "/diff-previewer --compare src/old.js src/new.js"
output: "Side-by-side diff between two specific files"
- input: "/diff-previewer --stats"
output: "Change statistics with per-directory breakdown and change map"
- input: "/diff-previewer --summary"
output: "Compact token-efficient summary suitable for AI context injection"
input-schema:
type: object
properties:
mode:
type: string
enum: [--staged, --unstaged, --compare, --stats, --summary]
description: Operation mode
file1:
type: string
description: First file path for --compare mode
file2:
type: string
description: Second file path for --compare mode
output-schema:
type: object
properties:
files:
type: array
items:
type: object
properties:
path: { type: string }
status: { type: string, enum: [A, M, D, R] }
hunks:
type: array
items:
type: object
properties:
oldStart: { type: integer }
oldCount: { type: integer }
newStart: { type: integer }
newCount: { type: integer }
lines: { type: array, items: { type: string } }
additions: { type: integer }
deletions: { type: integer }
totalAdditions: { type: integer }
totalDeletions: { type: integer }
tokenEstimate: { type: integer }
model-hints:
context-priority: high
token-budget: 4000
cost: free
os: [win32, darwin, linux]
author: ChainlessChain
license: MIT
---
# 差异预览器技能
## 描述
多文件差异预览器，在应用AI变更前提供丰富的diff预览。支持查看git暂存/未暂存差异、比较任意两个文件、生成变更统计和变更地图。提供token估算帮助优化AI上下文窗口使用。
## 使用方法
```
/diff-previewer <mode> [arguments]
```
## 模式
| 模式 | 说明 |
| ------------ | ---------------------------------------- |
| `--staged` | 显示git暂存区的差异（git diff --cached） |
| `--unstaged` | 显示工作区未暂存的差异（git diff） |
| `--compare` | 比较两个指定文件的差异 |
| `--stats` | 显示变更统计，包含目录级别的分解 |
| `--summary` | 紧凑的token高效摘要，适合注入AI上下文 |
## 输出格式
### 结构化差异
```json
{
"files": [
{
"path": "src/main/index.js",
"status": "M",
"additions": 15,
"deletions": 3,
"hunks": [
{
"oldStart": 10,
"oldCount": 5,
"newStart": 10,
"newCount": 17,
"lines": ["..."]
}
]
}
],
"totalAdditions": 15,
"totalDeletions": 3,
"tokenEstimate": 450
}
```
### 变更地图
```
src/main/
index.js ████░░░░░░ +15 -3
database.js ██████████ +42 -10
src/renderer/
App.vue ██░░░░░░░░ +5 -1
```
## 示例
查看暂存的变更：
```
/diff-previewer --staged
```
查看未暂存的变更：
```
/diff-previewer --unstaged
```
比较两个文件：
```
/diff-previewer --compare src/old.js src/new.js
```
变更统计概览：
```
/diff-previewer --stats
```
AI上下文摘要：
```
/diff-previewer --summary
```