SuperAPI AI 工具集

edit-article

写作与研究

查看项目

更新于 10-16 03:13

技能介绍

用途:对已有文稿做机械式、纯结构性编辑,压缩冗长内容,但不改变文风。语气与语域被视为承重结构,逐字保留。

允许的改动:按信息依赖关系重排章节顺序(信息视为有向无环图,后文可依赖前文,反之不可);把含两个不同要点的段落拆成两段;把表达同一要点的两个短段合并;删除重复的句子、从句或词语;内容重叠时把并列列表或表格合并为单一规范形式;把冗长句收紧为更短更清晰的句子,尽量保留原意与原用词;在不需改写措辞的前提下把段落控制在约 240 字符内;把打断行文的插入语提升为脚注或边栏;降级冗余标题,把孤立段落提升为独立小节。

禁止的改动(硬性边界):不得改变语态(主动/被动、第一/第二/第三人称);不得改变语域(正式↔随意);不得改变语气(技术性、决策导向、祈使);不得改写 ODIN 规定的措辞;不得引入原文没有的新论断、示例或类比;不得删除技术细节(文件路径、命令参数、版本号、具名常量);不得重命名标题、字段或列表项;不得为非英文规定内容“为清晰起见”改换风格;不得添加表情、暖场、营销语言或模糊措辞。若某项改动看似必要但属于禁止项,应停止并向用户提出该问题。

使用方式:先派发 Explore 智能体(或对不超过 50 行代码的文档直接阅读)按标题把文档映射为章节并构建依赖图;编辑前先与用户确认章节顺序与依赖图;按依赖顺序逐节处理,只应用允许清单中的改动,把禁止清单中的候选作为问题提出;编辑后用 difft 做差异比对,若语态、语域或语气发生变化则拒绝该改动;全部章节处理完后通读全文确认流畅,不再二次编辑;提交信息为:docs: tighten <document-name> (mechanical edits only)。

适用场景:压缩由 request-refactor-plan 生成的冗长 docs/refactor-plans/<n>.md;合并前压缩长篇 ADR;删除 README 各章节间重复的句子;重排引用了后续概念的教程步骤。

不适用场景:以不同文风重写草稿(应手动重写);翻译非英文文档(ODIN 的英文规定约束原始起草);从笔记生成新文档(应使用通用实现规划或 request-refactor-plan)。

限制:仅做机械式结构编辑,不改变文风、不新增内容、不删除技术细节;具体安装命令与运行环境资料暂未提供。