用途:让声称能超越当前技术栈而长期存续的文档,在智能体、运行环境、操作系统、厂商、模型或工具链变化后仍然真实、可执行。detool 找出可移植内容中与特定技术栈绑定的名词,改写为其背后的机制,但不删除这些名词所支撑的动作。目标是可移植,而非含糊:改写后读者仍应知道要检查、运行、测量、比较或验证什么。
主要能力:先通读目标文档,在编辑前判断整体或各章节的角色,分为可移植内容、来源/操作记录、关于具名工具的陈述三类;随后在可移植内容中扫描偶然耦合,包括运行环境路径、厂商 CLI 与参数、被当作机制使用的模型或产品品牌、工具专属环境变量、配额、UI 步骤、缓存目录、会话文件,以及被当作永恒真理的版本绑定行为。改写时用保留动作的中性机制替换,若中性表述会丢失动作,则保留具体细节作为该机制的示例,而非假装其可泛化。
使用方式:按工作流逐条处理,先判断角色再编辑;对来源与操作内容保持具体,构建记录、胶囊、基准日志、安装指南、运行手册、面向特定工具的教程、命令记录和精确复现步骤本应指明其技术栈;对比较性及以工具为主语的陈述保持具体,若句子讨论具名工具、厂商、模型、缺陷、先前技术来源或实测限制,该名称是主语而非偶然耦合。完成后以不同技术栈的读者视角重读,确认文档仍然真实、可移植,并在承诺动作处可执行。最后报告被中性化的内容、被有意保留的内容及每次保留的角色判断依据。
限制与规则:编辑前必须先判断角色;机制而非委婉语,例如“使用会话执行日志并汇总用量记录”是机制,“查看日志”是丢失工作的委婉语;只抽象耦合,不抽象过程、证据、比较或约束;来源与操作记录中的具体路径、命令、参数、版本、产品和 UI 步骤应保留;比较性或工具主语名称应保留;若未发现偶然耦合则不做任何改动;编辑需具备安全性,断言每个目标存在,缺失时报告 MISS 而非静默无操作,使用 Unicode 安全编辑,按出现位置替换而非整体清扫,大规模结构移动应脚本化。验证时确认每个被改动的命中都位于可移植内容中,每次改写都保留了可执行机制,每个保留的工具名词都是来源、操作指令或其陈述的主语。