SuperAPI AI 工具集

hai-rewrite-doc

写作与研究

查看项目

更新于 10-15 22:15

技能介绍

用途:针对经过多轮讨论与修补而失真的文档,先明确当前真实共识,再据此重建文档。旧文档只作为素材与证据,不作为修补基础。

主要能力:建立锚点(当前仍成立的决策、被推翻的决策以推翻为准、仍有效的约束、目标读者与用途);将旧文档拆分为块(章节、论断、表格、示例、命令、数字);分宏观(frontmatter、标题、目的、顶层框架)与微观(逐条论断、表格、命令、示例)两级核验;对每块给出唯一处置:Keep(保留原文)、Delete(删除并引用失败核验)、Replace(由具名权威来源提供替换)、Undecided(无法核验则列入待确认问题);按锚点决定结构并完整重写,最后逐项对照锚点检查。

使用方式:先写锚点,锚点无法回答“文档给谁看”“X 最终怎么定”时先向用户提问;再清点旧文档全部块;宏观核验优先,失败框架下仅服务于该框架的内容需重新核验;微观逐条核验,列表须逐项通过;记录核验依据;按处置表重写;定稿前阅读 references/output-template.md。仅在用户明确指定修改该文件且存在可恢复历史(如版本控制)时原地编辑,否则写入命名清晰的同级文件或用户指定输出,并报告实际路径与原文件是否变更。

适用场景:需要重建已失真文档、且要求保留已验证措辞与作者语气时。不适用:只要发现报告用 hai-audit-docs;PRD 用 hai-prd;计划或目标文档用 hai-goal;仅结构格式问题用 readme-beautifier;需先判断概念是否应存在则先用 hai-razor。

限制:不是美化器、补丁合并器、摘要器或全新创作;替换文本必须可追溯到已验证权威,禁止凭猜测修补;任何删除都须在处置表中记录;无法核验的内容不得静默保留或丢弃。

其他事实(如安装命令、收费、平台支持)暂未提供。