SuperAPI AI 工具集

editorial-scoring

写作与研究

查看项目

更新于 10-15 21:12

技能介绍

用途:回答“这个功能对读者有多重要?”,为发布说明、博客和文档的候选功能排序与取舍提供统一的编辑评分标准。它本身不生成文件,而是作为共享评分尺度和 80/20 受众过滤器的规范来源,供 generate-features(首轮打分)、review-release-notes(审计并重新校准)、release-notes(依据取舍决定写什么)以及未来的博客/文档流程复用。

主要能力:提供以读者为中心的 0-10 分评分尺度。10 分是首要故事;8+ 是强发布说明功能;6+ 适合分组写入;4+ 可选提及或短段落;2+ 通常跳过;0 分属于内部工程工作,应从公开内容中删除。默认面向约 80% 受众,仅当其余 80% 仍能理解其价值时才保留更专门的功能。还列出强正负信号、常见评分错误(如技术新颖性偏差、API 清单模式、努力偏差、内部术语膨胀、受众乘法盲区、描述真空乐观、文档盲区、幽灵 API、关联提升、需求倒置、碎片化偏差)以及工作阈值:8+ 独立成节,6-7 通常分组,0-5 归入缺陷修复桶、一句话或删除。破坏性变更与评分分开,用 breaking_changes: true 表示迁移重要性。

使用方式:按读者(升级到新版本的开发者)视角而非实现者视角打分;多个 3-5 分同领域条目可合并为一个主题段落。规范参考包括 ../release-notes/references/feature-scoring.md、quality-bar.md 和 examples/README.md。

适用场景:发布说明、博客、文档的功能筛选与编辑校准。

限制:不生成文件;不替代具体写作流程;资料未提供具体安装命令、收费或平台信息。