text-diff#

Show line-by-line differences between two text files using Python's difflib.

Usage Scenarios#

Scenario 1: Compare Configuration File Versions#

User input: "比较两个版本的配置文件有什么不同。"

Expected output: Unified diff output showing added lines with +, removed lines with -, and context around changes for old_config.ini vs new_config.ini.

Scenario 2: Side-by-Side Comparison#

User input: "帮我并排对比这两份文案的差异。"

Expected output: Side-by-side layout with original on left, revised on right, differences highlighted. Changed lines shown aligned with their counterparts.

Scenario 3: Check if Files Are Identical#

User input: "检查这两个文件是不是完全一样。"

Expected output: Exit code 0 with message "Files are identical" if no differences found, or exit code 1 with detailed diff output showing all changes if files differ.

Scenario 4: 合同版本对比#

User input: "我把租房合同改了几个地方发给中介了，他怎么改的我没看出来，帮我对比一下两版合同的区别。" Expected output: 对原始版和修改版进行逐行差异对比（diff），高亮增删改的部分。用颜色标注：红色删除、绿色新增、黄色修改。支持word/PDF/markdown格式。输出差异摘要：几处新增、几处删除、几处修改。针对合同中的关键条款（租金、违约责任、租期等）的变更做特别标注。

Description#

A utility skill for comparing two text files and displaying their differences in a readable format. Supports unified diff output and side-by-side comparison modes.

Usage#

bash

# Show unified diff between two files
python ~/.openclaw/skills/text-diff/text_diff.py unified file1.txt file2.txt

# Show side-by-side comparison
python ~/.openclaw/skills/text-diff/text_diff.py side-by-side file1.txt file2.txt

# Show context diff (3 lines of context)
python ~/.openclaw/skills/text-diff/text_diff.py context file1.txt file2.txt

# Compare with custom context lines
python ~/.openclaw/skills/text-diff/text_diff.py unified file1.txt file2.txt -c 5

Options#

• unified: Show unified diff format (default)
• context: Show context diff format
• side-by-side: Show line-by-line comparison
• -c, --context: Number of context lines (default: 3)
• -o, --output: Save diff to file instead of stdout
• --no-color: Disable colored output

Examples#

bash

# Basic unified diff
python ~/.openclaw/skills/text-diff/text_diff.py unified old.txt new.txt

# Side-by-side comparison with no colors (for piping)
python ~/.openclaw/skills/text-diff/text_diff.py side-by-side old.txt new.txt --no-color

# Save diff to file
python ~/.openclaw/skills/text-diff/text_diff.py unified old.txt new.txt -o diff.txt

# Compare with 10 lines of context
python ~/.openclaw/skills/text-diff/text_diff.py context old.txt new.txt -c 10

Output Format#

Unified Diff#

text

--- old.txt
+++ new.txt
@@ -1,5 +1,5 @@
 line 1
 line 2
-line 3 (removed)
+line 3 (added)
 line 4
 line 5

Side-by-Side#

text

OLD                          | NEW
---------------------------- | ----------------------------
line 1                       | line 1
line 2                       | line 2
line 3 (removed)             | line 3 (added)
line 4                       | line 4

Exit Codes#

• 0: Files are identical
• 1: Files differ
• `