SuperAPI AI 工具集

polyscan-repo-discovery

编程与开发

查看项目

更新于 10-16 17:27

技能介绍

用途

polyscan-repo-discovery 用于发现适合用 polyscan 运行误报审计的仓库,并把它们追加到本地审计队列 .polyscan/audit/queue.md(相对于 monorepo 根目录)。其目标是避免样本偏差:每次运行都轮换语言与主题,并始终纳入一些冷门仓库(★50–500),因为热门项目只呈现已被充分覆盖的模式,而较小项目能暴露长尾场景,polyscan 在这些场景更可能误报。

输入

无参数,或接收 <n>(目标数量,默认 8)。

主要步骤

  1. 读取队列:读取 .polyscan/audit/queue.md;若文件缺失,则用技能底部提供的模板创建。绝不重复添加已出现在队列中(无论 pending 还是 audited)的 URL。

  2. 选择语言与主题:挑选 3 组 (语言, 主题) 组合。语言在 go、rust、cpp、js、ts 之间轮换;检查 queue.md 中的 <!-- last-languages: ... --> 与 <!-- last-themes: ... --> 标记,避免与上一次运行重叠。多次运行后,每种语言都应被均匀覆盖。

主题包括:CLI / TUI 工具;Web 框架与中间件(HTTP 路由器、ORM、鉴权库);数据 / 数值 / ML 运行时;DevOps / 基础设施 / IaC / Kubernetes operator;静态分析 / linter / 编译器 / 解析器;网络 / 协议 / 代理;游戏 / 图形 / 音频;嵌入式 / 系统 / OS 组件;密码学 / 安全;异步 / 并发运行时;数据库 / 存储引擎 / 缓存;教学 / 新手友好项目(低星仓库的良好来源)。

  1. 通过子代理发现:为每个 (语言, 主题) 组合并行派生一个通用 Agent。给每个代理的简要说明要求:在 GitHub 上寻找主要以该语言编写、匹配该主题的开源仓库;约束为 ★50–★10000 且偏向较小项目(至少一个候选低于 ★500);最近 12 个月内有提交(跳过归档仓库);约 1k–50k LOC(约 10–500 个源文件);排除知名大型项目(kubernetes、docker、terraform、prometheus、cobra、gin、hugo、tokio、serde、ripgrep、rustc、clippy、llvm、tensorflow、opencv、electron、react、vue、typescript、vite、next.js、express);排除已存在于队列中的 URL 以及重大项目的个人 fork;对 C++ 优先选择大部分代码为 .cpp/.hpp/.h 而非 C 的仓库;对 JS/TS 优先选择源码仓库而非打包分发产物。使用 WebSearch 查询(如 site:github.com <语言> <关键词>)、awesome 列表、近期 HN/Lobsters/Reddit 帖子。返回 3–5 个候选,格式为 JSON:{"url": "https://github.com/owner/repo", "stars": 1234, "language": "<language>", "loc_estimate": "small|medium|large", "theme": "<theme>", "why": "一句话说明为何值得用 polyscan 审计"}。三组并行 → 9–15 个候选,按 URL 去重。

  2. 追加到队列:把每个新条目添加在 ## Pending 区域下,格式为:- [ ] https://github.com/owner/repo — <language> — ★1234 — <theme> — discovered 2026-09-05 — <why>。并更新尾部标记:<!-- last-languages: go, rust, ts -->、<!-- last-themes: cli, networking, security -->、<!-- last-run: 2026-09-05 -->。

  3. 报告:只在一行内告诉用户数量、语言和主题,不要输出完整列表(用户可自行读取 queue.md)。

queue.md 模板(缺失时创建)

polyscan FP Audit Queue

JavaScript/TypeScript, Go, Rust and C++ repositories discovered as candidates for polyscan false-positive auditing. Consumed by /polyscan-fp-audit.

Pending

<!-- new - [ ] ... entries appended here -->

Audited

<!-- when audited, flip [ ] to [x], append "audited YYYY-MM-DD", and move here -->

<!-- last-languages: --> <!-- last-themes: --> <!-- last-run: -->

注意事项

跳过归档仓库——WebSearch 结果可能过时;许可证无关紧要(仅本地审计,不重新分发);跳过上游项目的个人 fork(owner 是最终用户而非维护者);Python 仓库属于 pyscn checkout 中的 pyscn-repo-discovery,不在本技能范围内。

限制

资料未提供收费、价格、平台限制或效果数据;技能本身依赖 WebSearch 与子代理,实际可用性取决于运行环境。