用途:该技能是只读的,渲染一个自包含 HTML 页面,汇总 <tracker> 仓库随时间变化的状态,供安全团队审阅。它包装 tools/security-tracker-stats-dashboard/ 运行时工具,斜杠命令路径与脚本路径(run.sh)走同一套抓取加渲染流水线;技能只增加调用便利(解析缓存路径、输出 URL、提示刷新过期缓存),不修改任何内容。它不会创建或修改 issue、评论、标签或 PR,只通过 gh 抓取数据并渲染 HTML。
主要能力:抓取 issue 列表、协作者名单、issue 正文与关联 PR、标签历史事件、上游 PR 的 createdAt/mergedAt/state,然后按配置分桶渲染图表,包含生命周期分类、triage 中位数、PR 合并中位数、当前桶投影等。
使用方式:先运行预检命令(PYTHONPATH=.apache-magpie-local python3 -m setup_preflight --skill <name> --hash <surface_hash> [--requires <file>]...),verdict 为 ok 时静默继续。随后解析配置、检查缓存新鲜度,再执行:TRACKER_STATS_REPO=<tracker> TRACKER_STATS_UPSTREAM_REPO=<upstream> TRACKER_STATS_CONFIG=<adopter-repo>/.apache-magpie-overrides/security-tracker-stats.yaml bash <framework>/tools/security-tracker-stats-dashboard/run.sh <output-path>。可选参数包括 quarterly/monthly、<output-path>、clear-cache、since:YYYY-MM 或 since:YYYY-Qn。
适用场景与限制:适合安全团队定期审阅 tracker 趋势。需要 gh 已认证且对 <tracker> 有读权限、python3 3.9+、jq、访问 api.github.com 与 Plotly CDN;PyYAML 可选。全量抓取约 5-10 分钟,过期缓存需先征得用户确认;当前桶为部分数据,投影数字不得当作观测值。渲染器配置放在 .apache-magpie-overrides/security-tracker-stats.yaml,行为覆盖放在 .apache-magpie-overrides/security-tracker-stats-dashboard.md,快照目录 .apache-magpie/ 永不修改。