SuperAPI AI 工具集

review-doc

写作与研究

查看项目

更新于 10-16 09:52

技能介绍

用途:对目标文档进行结构化审阅与质量改进,适用于用户要求 review、proofread、check、audit 或 improve 文档(Markdown、文本等)的场景。

主要能力:先完整读取文档并记录总行数,再扫描文档中引用的 PRD、设计文档、规格或风格指南并读取作为上下文(找不到则跳过)。审阅检查正确性、结构、完整性、清晰度和语法,把问题分为 Critical / Important / Minor,返回 Markdown 表格,列包含 Severity、Line、Category、Issue、Fix,并按严重程度、再按行号排序。

使用方式:按文档大小选择模式。≤300 行走单代理模式,通过 Task 工具启动一个通用子代理(subagent_type: general-purpose),传入全文与引用上下文。>300 行走并行多代理模式:按 h1/h2 顶层标题切分为 2–5 个块(无标题则按约 300 行切块并留 20 行重叠),在同一条消息中用多个 Task 调用并行启动所有分节子代理,同时额外启动一个结构子代理从整体审阅结构、逻辑流、缺失内容、跨节不一致、重复或矛盾内容以及目录准确性;最后合并子代理表格,在重叠区域按行号就近(±3 行)与类别相同去重,保留更具体的描述。

修复与验证:用 Edit 一次性应用全部修复,然后重读文档;若仍有新问题,最多再做一轮修复。最后按给定格式输出摘要,包含审阅模式、问题表(含 Source 与 Fix Applied 列)以及 Critical/Important/Minor 的发现与修复数量、Passes 和状态。

边界情况:超过 1000 行时按 500 行分块完整读取后再审阅;无明确分节边界时退化为约 300 行固定切块加 20 行重叠;未发现问题时如实报告干净结果,不虚构问题;用户指定重点领域时优先但仍在全文范围审阅;文件不存在或不可读时报错并终止;某个并行子代理失败时合并其余结果并记警告,全部失败则回退到主会话直接审阅;引用的文档不可读时在报告中记警告并继续;未提供收费、价格、平台等更多信息。