Similar Judge

对比两份文本差异,输出相似度与词级差异 JSON。当 agent 需要量化产物与目标的文本差距时使用

gitbyeos d911d4c 2 files · 5.9 KB Updated

File contents

Similar Judge

量化两份文本的差异。输入产物与目标,输出 JSON:相似度 + 词级差异原文。

只量差异,不评质量。相似度高不等于内容正确(可能因果倒置、数量级错误),质量判断交给上层 LLM。

调用

# 默认输出 JSON
{skill}/bin/similar-judge 产物.txt 目标.txt

# 调试模式(人类可读)
{skill}/bin/similar-judge 产物.txt 目标.txt --text

参数顺序固定:先产物,后目标。目标为基准。默认忽略空白差异(git -w 口径)。

JSON 字段

{
  "line_sim_ratio": 0.5,
  "word_sim_ratio": 0.8103,
  "target_lines": 20,
  "product_lines": 20,
  "added_lines": 10,
  "deleted_lines": 10,
  "diff_chars": 386,
  "diff": "# 用户中心\n[-用户中心提供登录注册功能。-]{+用户中心负责身份认证与会话管理。+}\n..."
}
字段 含义
line_sim_ratio 行级相似度,对行顺序错位敏感
word_sim_ratio 词级相似度,跟人眼感受一致,推荐主指标
target_lines / product_lines 两侧行数
added_lines / deleted_lines 产物冗余 / 产物遗漏的行数
diff_chars diff 字段字符长度,供 LLM 预判体量
diff git word-diff 内容,含 [-old-]{+new+} 词级标记

边界

能做:相似度计算、增删行数统计、词级差异原文输出

不做:质量评判、事实核查、优化建议、闭环决策,交给 LLM

硬性规则

  • 默认输出 JSON,--text 仅调试用
  • diff 字段剥掉 git 元数据 header,只留 word-diff 内容
  • 不输出评判语义文案("质量高/低"等),避免误导上层
  • 不修改产物与目标,只读

gitbyeos/open-part-skills/tree/main/skills/similar-judge commit d911d4cb4c

Frequently asked questions

npx skillmds@latest add gitbyeos/similar-judge