用途
polyscan-repo-discovery 用于发现适合用 polyscan 运行误报审计的仓库,并把它们追加到本地审计队列 .polyscan/audit/queue.md(相对于 monorepo 根目录)。其目标是避免样本偏差:每次运行都轮换语言与主题,并始终纳入一些冷门仓库(★50–500),因为热门项目只呈现已被充分覆盖的模式,而较小项目能暴露长尾场景,polyscan 在这些场景更可能误报。
输入
无参数,或接收 <n>(目标数量,默认 8)。
主要步骤
-
读取队列:读取 .polyscan/audit/queue.md;若文件缺失,则用技能底部提供的模板创建。绝不重复添加已出现在队列中(无论 pending 还是 audited)的 URL。
-
选择语言与主题:挑选 3 组 (语言, 主题) 组合。语言在 go、rust、cpp、js、ts 之间轮换;检查 queue.md 中的 <!-- last-languages: ... --> 与 <!-- last-themes: ... --> 标记,避免与上一次运行重叠。多次运行后,每种语言都应被均匀覆盖。
主题包括:CLI / TUI 工具;Web 框架与中间件(HTTP 路由器、ORM、鉴权库);数据 / 数值 / ML 运行时;DevOps / 基础设施 / IaC / Kubernetes operator;静态分析 / linter / 编译器 / 解析器;网络 / 协议 / 代理;游戏 / 图形 / 音频;嵌入式 / 系统 / OS 组件;密码学 / 安全;异步 / 并发运行时;数据库 / 存储引擎 / 缓存;教学 / 新手友好项目(低星仓库的良好来源)。
-
通过子代理发现:为每个 (语言, 主题) 组合并行派生一个通用 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 去重。
-
追加到队列:把每个新条目添加在 ## 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 -->。
-
报告:只在一行内告诉用户数量、语言和主题,不要输出完整列表(用户可自行读取 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 与子代理,实际可用性取决于运行环境。