Mending 是一个修复技能,专门处理“原本能正常工作、现在出现明确且可定位故障”的单个制品,比如配置文件、文件、构建或迁移脚本。它的定位是外科式修复:故障已被识别,只需用最小改动恢复原状,而不重新设计。
用途与范围 Mending 适用于请求中包含具体文件或制品名称(如 .gitignore、docker-compose.yml、Makefile、package.json、迁移脚本、清单文件)、局部性故障(语法错误、拼写错误、缺失字符、错误引用、缩进问题、未闭合括号、多余逗号、键名拼错),并且有证据表明此前可正常工作(“昨天坏的”“上周还好”“合并前没问题”),或出现“直接修复”“修一下拼写错误”“缺分号”“引用坏了”等表述。
明确不适用的情况 该技能不是诊断或排查:若问题是“API 一直返回 500,查原因”,那属于调查,而 Mending 要求故障已定位。它不是格式化或清理:数据正确但排版乱(排序键、统一缩进)属于格式化。它不是状态重置:标志卡住或告警需要清除属于操作开关。它不是重构或重新设计:系统“根本上有缺陷”需要重做属于重建。它不是全面清理:跨表多年孤立记录属于数据完整性项目,不是外科式修复。
使用方式 触发后,先复述目标、成功条件和不得改动的边界,再确认故障具体且局部——指明确切文件、确切错误以及此前“正常”的样子。随后只施加能恢复原行为的最小改动:修正拼写、补上缺失字符、纠正引用、移动错位指令,不做改进、现代化或结构调整。修复后展示前后差异(diff),使修复可审计、可回滚。如果故障暴露出更深层结构问题(同一拼写错误出现在 12 个文件、配置格式根本不可靠),应报告,而不是用重复补丁掩盖。最后按交付物打包,并明确区分已确认事实、假设和未解决风险。
前置条件 除 Hermes Agent 及本次会话的常规工具外,无需额外运行时依赖。
交付物 修复后处于可用状态的制品;准确展示改动的前后差异;若故障暗示更深层结构问题,附说明。
注意事项 保持比喻对应真实机制;只修复故障,不重新设计,也不借机清理;若损坏范围超出定点修复,应说明并建议更大范围的干预;保留制品原有设计、风格和结构。
验证 检查结果是否包含上述每项交付物;检查已确认事实、假设与推断是否清晰分开;检查比喻是否仍能对应真实操作机制。
示例调用 /mending fix this broken artifact with the smallest repair that restores it to working condition