用途:对 README.md 中指定章节的条目重新执行收录测试,用实时数据复核每个条目的评级,重新评估分层与结构,由维护者裁定后提交。规则本身在 CONTRIBUTING.md(Admission、Evidence、Entry Ordering),本技能是执行这些规则的流程,不重复规则内容;条目变更仅在维护者明确同意后落地。
主要能力与流程:
- 范围:按参数确定章节,命名章节即精确匹配;all 有歧义需询问;无参数时列出从未审计过的 Thematic Groups,每次处理一个组。
- 证据:先抓取实时证据。下载量用 cd website && uv run python fetch_pypi_downloads_via_clickpy.py(免费无密钥,全 README 扫描,唯一写入 data/pypi_downloads.tsv,每次重写并带 fetched_at 日期);缓存 7 天内可跳过,超期重跑。交叉核对可用 fetch_pypi_downloads_via_bigquery.py <name> ...(需维护者 GCP,先 --dry-run)或 fetch_pypi_downloads_via_pepy.py <name> ...(需 PEPY_TECH_API_KEY,限速 5 次/分钟),或 pypistats API(间隔 8 秒以上);不同来源不可混用比较。仓库状态用 gh api repos/{owner}/{repo} 或 GitLab API;PyPI 元数据用 https://pypi.org/pypi/{name}/json。重命名条目可能被扫描误查,需确认包身份,必要时在 website/data/pypi_name_overrides.json 加 null 条目。
- 评级:为每个条目起草评级与理由,先做拆分、新建、迁移,再按上限逐层应用升降级;理由须基于抓取证据,不可验证的标注为判断。
- 复核与执行:运行 preview-verdicts 技能生成交互式复核页,维护者反馈为最终结果;提交前提出隐含假设并取得明确同意。每个章节一次提交,提交信息列出移除项、理由与下载量及来源和抓取日期;结构调整需在 website/data/redirects.json 加 "old path": "new path";每次提交前 make test,最后重跑 ClickPy 扫描并 make build。
- 记录:将结论写入 CONTRIBUTING.md、CLAUDE.md 和 AGENTS.md。
限制:依赖外部 API 与密钥,BigQuery 全量扫描超出免费额度;pypistats 不含镜像/CI 流量,ClickPy、BigQuery、pepy 含;部分自动检查已被否决,不应重新提出。具体收费、平台与效果资料未提供。