SuperAPI AI 工具集

plt-grade-doc

写作与研究

查看项目

更新于 10-16 03:48

技能介绍

用途:对已写好的产品文档做审阅、批评、打分或发布前检查,方向与 plt-fill-template(空白模板到成稿)相反,从已有文档生成针对该文档类型自身评分标准的报告卡。评分标准来自同一套27个bundle,覆盖25个可模板化的一级文档类型加两个二级类型。

主要能力:按三层分析——结构层(精简版章节是否齐全、顺序、是否出现仅完整版章节)、质量层(按指南评分标准逐条打0/1/2分)、反模式层(检测指南中的具名反模式及模板提示中的TRAP行,仅报告命中并附原文引用)。总成绩:结构40分、质量50分、反模式每命中最多-10分;A为90+、B为75+、C为60+、D为40+、F以下。还会给出最多三条首要修改建议、一句带引用的真实优点,以及升级路径。

使用方式:先确认库存在(检查 manifest.json 可读),缺失时按 metadata.version 对应标签从 GitHub 获取 manifest.json 与该类型的 guide.md,不要凭记忆评分。随后按顺序判定文档类型:读者明示的类型→文档 frontmatter 中的 source_template 或 doc_type→标题与标题层级对 manifest.json 的别名与标签匹配→H2 标题指纹。置信度不足时给出前两个候选并提一个区分性问题,不静默猜测。再加载该类型指南,识别其评分标准形式(评分表或清单)。评分低于2分必须引用原文或明确说明缺失。之后按 references/report-card-format.md 渲染报告卡,仅批评文档不批评作者;交付后按 references/feedback-form.md 收集反馈。

适用场景:文档需要发布前评审;准备把 PRD 发给工程团队前预判审阅者会问什么;检查文档是否遗漏该类型常见内容;智能体产出文档后交付前自检。

限制:文档尚未存在时应用 plt-fill-template;读者要求重写文档时本技能只产出批评与修改清单;文档不属于27类时明确说明并只提供结构审查;不对底层想法好坏作判断。约150词以下文档不给字母等级,只返回精简章节清单。非英语文档按结构正常评分,但质量判断基于英语范例校准。库中评分标准尚未被证明可预测文档质量,高/低分不等于文档好/坏。使用情况未知,反馈是库了解真实用户的唯一途径。缺少库或网络不可达时停止,不替代。