SuperAPI AI 工具集

feature-review

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

feature-review 用于评审已实现功能并基于证据提出新功能建议,核心是 RICE+WSJF 混合评分与 Kano 分类,并为被采纳的建议创建 GitHub issue。

用途:路线图评审(冲刺规划、季度回顾)、回顾评估、规划新开发周期。不适用于紧急缺陷修复、简单文档更新,或正在进行的实现(应使用 scope-guard)。

主要能力:

  • 功能发现:分析代码构件(入口点、公开 API、配置面)、文档(README、CHANGELOG)、Git 历史,输出功能清单表。
  • 分类:按主动/被动、静态/动态两个轴分类。
  • 评分:Feature Score = Value Score / Cost Score;Value Score =(Reach + Impact + Business Value + Time Criticality)/ 4;Cost Score =(Effort + Risk + Complexity)/ 3;Adjusted Score = Feature Score * Confidence,采用斐波那契刻度,阈值 >2.5 高优先、1.5-2.5 中优先、<1.5 低优先。
  • 取舍分析:评估质量、延迟、Token 用量、资源用量、冗余、可读性、可扩展性、集成、API 面等维度(1-5 分)。
  • 研究增强(--research,需 tome 插件):并行派发 code-search、discourse、papers、triz 渠道,合成结果并调整评分;未安装 tome 时打印警告并保持初始分数。
  • 缺口分析与建议:识别缺失的 Kano 基础项、高价值低成本机会、技术债,推荐构建/改进/弃用/维持。
  • GitHub 集成:生成标题与正文,应用 feature、enhancement、priority/* 标签,链接相关 issue,创建前需用户确认。

使用方式:执行 /feature-review --inventory 清点;/feature-review 评分分类;/feature-review --suggest 生成建议;/feature-review --research 研究增强;/feature-review --suggest --create-issues 创建 issue。修改后运行 make test-feature-review 验证评分逻辑。对未采纳且分数 >2.5 的建议,自动执行 python3 scripts/deferred_capture.py --title "<suggestion title>" --source feature-review --context "RICE score: <score>. <description>" 进行延迟捕获,不提示用户。

配置:在项目根目录创建 .feature-review.yaml,可设置权重、阈值与取舍维度权重。护栏规则:至少评估 5 个取舍维度、复核置信度低于 50% 的评分、API 面破坏性变更需确认、建议队列上限 25 项。集成点包括 imbue:scope-guard(提供 Worthiness Scores)、sanctum:do-issue(按高分排序)、superpowers:brainstorming、tome:research。输出格式为功能清单表、研究增强表与建议报告。

限制:研究增强依赖 tome 插件,未安装则降级;issue 创建需用户确认;紧急修复与简单文档更新不适用。其余细节资料未提供。