SuperAPI AI 工具集

detool

写作与研究

查看项目

更新于 10-24 16:19

技能介绍

detool 是一个面向文档与产物可移植性的处理技能,其核心用途是移除那些声称能超越其写作技术栈而长期存续的产物中偶然的工具耦合。

用途

一个可长期存续的产物,应当在代理、运行框架、操作系统、厂商、模型或工具链发生变化后仍然保持真实且可操作。detool 会在可移植内容中查找特定于技术栈的名词,并将其改写为底层机制,同时不删除这些名词原本所支撑的动作。其重点是可移植性,而非含糊其辞:改写之后,读者仍应知道要检查、运行、测量、比较或验证什么。

主要能力

  • 角色判断:在编辑之前,将整个产物(若内容混合则按章节)分类为可移植内容、来源/操作记录,或关于某个具名工具的陈述。
  • 耦合清扫:在可移植内容中查找偶然耦合,包括运行框架路径、厂商 CLI 与标志、被当作机制使用的模型或产品品牌、工具专属环境变量、配额、UI 步骤、缓存目录、会话文件,以及被表述为永恒真理的版本固定行为。
  • 机制替换:将每个可移植内容命中项替换为保留动作的中性机制。如果中性措辞会丢失动作,则保留具体细节作为该机制的示例,而不是假装它可以泛化。
  • 保留具体内容:来源与操作内容保持具体。构建记录、胶囊、基准日志、安装指南、运行手册、面向特定工具的操作指南、命令记录和精确复现步骤,本就应当指明产生它们的技术栈。
  • 保留比较性与工具主语陈述:如果句子是关于某个具名工具、厂商、模型、缺陷、先前技术来源或实测限制,那么该名称是主语,而非偶然耦合。
  • 复读验证:以处于不同技术栈的读者视角重新阅读,产物应仍然真实、可移植,并在其承诺动作之处可执行。
  • 报告:报告哪些内容被中性化、哪些被有意保留,以及每次保留背后的角色判断。

使用方式

工作流程为:首先端到端通读目标产物;然后在编辑前判断角色;接着在可移植内容中清扫偶然耦合;随后用保留动作的中性机制替换命中项;来源与操作内容保持具体;比较性与工具主语名称保持具体;最后以不同技术栈读者的视角复读,并报告中性化内容、有意保留内容及判断依据。

规则

  • 先判断角色再编辑。在决定文本是可移植内容、来源、操作指令还是工具主语陈述之前,绝不先行清洗。
  • 用机制,而非委婉语。“使用会话执行日志并汇总使用记录”是机制;“检查日志”是丢失工作的委婉语。
  • 保留可操作细节。只抽象耦合,不抽象过程、证据、比较或约束。
  • 来源与操作记录保持精确。当具体路径、命令、标志、版本、产品和 UI 步骤记录的是已发生之事,或解释如何驱动特定工具时,应予以保留。
  • 保留比较性/工具主语名称。关于 CLI 的缺陷报告、针对模型的基准测试、先前技术引用或厂商特定限制,保留具名主语。
  • 若一次处理未发现偶然耦合,则不做任何改动。
  • 编辑安全:断言每个目标存在,若不存在则报告 MISS 而非静默无操作;编辑需 Unicode 安全;按出现位置替换,绝不整体清扫;大型结构移动应脚本化。

验证

完成前需确认:每个被修改的命中项都位于可长期存续或可移植内容中;每次改写都保留了可操作机制;每个被保留的工具名词都是来源、操作指令或其陈述的主语;报告需列出被中性化的耦合、有意保留项以及任何判断取舍。

适用场景与限制

该技能适用于需要长期存续、跨技术栈复用的文档、指南或产物,尤其是其中混有偶然工具耦合的情况。它不适用于来源记录、操作记录、安装指南、运行手册、命令记录、精确复现步骤,以及关于具名工具、厂商、模型、缺陷或实测限制的比较性陈述,这些内容应保持具体。资料未提供关于收费、价格、平台或具体效果的信息。