SuperAPI AI 工具集

analytics-flow

数据与分析

查看项目

更新于 10-16 02:01

技能介绍

analytics-flow 是一个分析与数据工作流技能,定位为面向软件开发项目的指标分析、文档分析、进度跟踪与趋势分析工具。其用途是让项目进度、文档质量、需求覆盖情况与开发速度变得可观测,并从 SDD 产物中生成可执行的洞察,以识别瓶颈并优化工作流。该技能在资料中被归类为数据分析与报告,复杂度中等,属于数据聚合加可视化的类型。

主要能力分为八个方面。第一,文档覆盖率指标:按类型统计文档总量(BRD、PRD、REQ、BDD 等)、Token 数量分布、文档完整度百分比、识别过期文档以及跟踪文档债务。第二,需求跟踪:按类别统计需求总量、需求状态(草稿、已批准、已实现、已测试)、需求覆盖(REQ 到 BDD 再到 TASK 的映射)、孤立需求,以及需求年龄与陈旧度。第三,可追溯性分析:完整的可追溯链(BRD 一直到代码)、断裂的可追溯链接、可追溯覆盖率百分比、缺口识别与循环依赖检测。第四,实现进度:任务完成数与总数对比、实现阶段进度、阻塞任务与活跃任务、时间线符合度与里程碑跟踪。第五,速度跟踪:每冲刺或每周完成的需求数、实现速度、文档速度、测试覆盖率速度以及随时间变化的趋势分析。第六,质量指标:代码评审得分变化、测试覆盖率趋势、安全漏洞趋势、代码复杂度趋势与文档质量得分。第七,瓶颈识别:停滞需求、阻塞任务、资源约束、阻碍进展的依赖链与评审瓶颈。第八,自定义报告生成:高层摘要、冲刺或周报、里程碑报告、团队绩效报告与风险评估报告。

使用方式以命令行调用为主。例如使用 analytics-flow dashboard 命令生成项目仪表盘并输出到指定 HTML 文件,仪表盘包含整体健康度、文档覆盖率、实现进度、可追溯性覆盖率、质量指标、速度与已识别瓶颈等区块。使用 requirements 命令可生成需求报告,支持 JSON 格式输出,包含按优先级、状态、类别的统计,以及覆盖率、年龄分析、陈旧需求与孤立需求。使用 traceability 命令可生成可追溯性矩阵,支持 Mermaid 格式输出,展示从 BRD 到 PRD、REQ、BDD、TASK、代码再到测试的链路。使用 sprint 命令可按起止日期生成冲刺报告,包含冲刺摘要、成果、完成的需求、速度指标、质量指标、已解决阻塞、当前阻塞、风险与下个冲刺目标。使用 velocity 命令可跟踪多周速度趋势,输出平均速度、趋势方向、速度变化百分比与预测。

关键绩效指标涵盖五个方面。文档类指标包括文档覆盖率、文档债务与平均文档年龄。需求类指标包括需求覆盖率、需求周期时间与孤立需求数。实现类指标包括实现速度、任务完成率与阻塞任务百分比。可追溯性指标包括前向可追溯性、后向可追溯性与完整可追溯链比例。质量类指标包括代码覆盖率趋势、代码评审得分与安全漏洞密度。报告中给出了各指标的目标值,例如文档覆盖率目标为不低于 95%,MUST 需求覆盖率目标为 100%,任务完成率目标为每冲刺不低于 90%,前向与后向可追溯性目标均为 100%,代码覆盖率目标为不低于 90%。

数据来源方面,主要来源包括全部 SDD 产物文件(BRD、PRD、REQ、BDD、ADR、SPEC、TASK、CTR)、Git 提交历史、测试执行结果、代码覆盖率报告、安全扫描结果与 CI/CD 流水线日志;派生指标包括速度计算、趋势分析、预测性预测与异常检测。可视化方面支持燃尽图、速度图、覆盖率趋势、可追溯性矩阵、依赖图、风险热力图与质量仪表盘,导出格式包括 HTML 仪表盘、PDF 报告、JSON 数据、Markdown 报告、Mermaid 图与 CSV 数据。所需工具包括 Read、Glob、Grep 与 Bash,所需库包括 pandas、matplotlib/plotly、jinja2 与 pyyaml。该技能可与 doc-flow、test-automation、code-review 与 project-mngt 集成。

最佳实践包括:每日自动采集、每周生成报告;项目开始时建立基线指标;关注趋势而非绝对数值;每个指标都应服务于决策;对异常模式进行告警;保留 6 个月以上历史数据;针对不同受众定制报告;根据反馈持续改进指标。

限制方面:该技能要求一致的 SDD 产物结构;历史分析受限于可用数据;预测准确性取决于数据质量;无法测量主观质量因素;需要定期采集数据以保证准确性。报告中还列出了成功标准,例如实时仪表盘可用、报告生成时间小于 5 分钟、数据准确率 100%、全部 KPI 自动跟踪、趋势分析预测准确率达到 90%、无需人工采集数据、利益相关者满意度不低于 4/5。备注信息显示,报告保存至 reports/analytics/,历史数据存储于 metrics/history.json,仪表盘每 15 分钟自动刷新,可为 KPI 阈值突破配置告警,自定义指标可通过 .analytics.yml 配置。

关于定价、收费、支持的平台与具体安装方式,资料中暂未提供。