技能介绍

你要解决的问题

想分析某个 GitHub 仓库的 issue 创建趋势、PR 作者分布或 stargazer 的地区构成，传统路径要么去 OSS Insight 网页手动翻页截图，要么自己写查询语句对着底层数据集跑。结果无法进入自动化流程，脚本里也拿不到结构化返回。

能力与工作方式

这个技能通过 oo CLI 调用 OSS Insight 的 connector，把 18 个分析动作暴露给 Agent。凭证由 OOMOL 在服务端注入，本地不接触原始 token，因此脚本里不需要处理任何鉴权细节。

动作分三类：

历史统计：get_issue_creators_history、get_pull_request_creators_history、get_stargazers_history 拿到随时间累积的计数。
实体分布：list_issue_creator_countries、list_pull_request_creator_organizations、list_stargazer_organizations 等按国家、组织、具体贡献者切分。
集合与排行：list_collections、list_hot_collections 枚举仓库集合，rank_collection_repos_by_issues、rank_collection_repos_by_pull_requests、rank_collection_repos_by_stars 按增长量排序，list_trending_repos 看近期热门。

调用流程固定：先跑 oo connector schema 拿到权威的输入输出契约，再按 schema 构造 --data（接受 JSON 对象字符串或 @path/to/file.json），执行后从 meta.executionId 取回本次执行的标识。

适用边界与注意点

这个技能本身不存数据，只是查询入口，所以返回内容取决于 OSS Insight 已收录的范围，新仓库或刚推送的事件可能存在延迟。

安全约束要留意：get / list 类只读动作可以直接跑；任何创建、更新、发送类动作会改变 OSS Insight 侧的状态，执行前必须和用户确认 payload 与预期效果；删除类动作需要显式批准。另外不要主动触发 oo auth login，只有命令真正因未登录失败时才走一次性的签名流程。如果返回 HTTP 402 或 OOMOL_INSUFFICIENT_CREDIT，说明账户额度耗尽，充值后重试即可，这不是技能配置问题。