SuperAPI AI 工具集

github-stars-organizer

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:整理用户的 GitHub 星标仓库,复用已有列表、按需创建少量宽泛列表,并把未归类的星标仓库加入合适列表。仅用于整理星标,不负责一般 GitHub 账号维护。默认立场是保守、先审阅、只做增量;错误归类比暂时不归类更糟。

必要工具与前置:首选浏览器自动化技能 chrome-cdp,或具备控制已登录本地浏览器、读取 GitHub Stars 页、查看仓库列表归属、创建列表、添加仓库能力的等效技能;否则停止并说明需要已认证的浏览器自动化。若未开启 Chrome 远程调试,先打开 chrome://inspect/#remote-debugging,启用远程调试/目标发现,确保该 Chrome 配置已登录 GitHub,确认本地调试端点(常见 127.0.0.1:9222)可用,并在出现时批准 GitHub 标签页的“允许调试”提示;未接通前不要继续。

输入:用户至少提供 GitHub 用户名、个人资料 URL 或 Stars URL 之一;不得硬编码任何账号、仓库或列表名。

安全规则:默认只做增量整理;不取消星标、不移除列表成员、不重命名或删除列表;已在列表中的仓库默认跳过;先复用现有列表再新建;保持列表体系紧凑可复用;每个仓库优先一个主列表,仅在明显有助于检索时加第二个,真正跨领域才加第三个;置信度不高时不猜,报告模糊仓库;若用户要求改动现有归属,须先获确认。

模式:默认 review-first,先分析列表、未归类仓库,提出分类法并等待确认再写入;仅当用户明确要求直接执行时用 auto-apply,歧义高或列表数超上限仍停止。

流程:在已认证会话打开目标 Stars 页;先读取所有现有列表并建立规范化映射(名称、语义、疑似重复);读取所有星标仓库时注意分页为游标式,须跟随 Next 游标,不能假设 page=N 可靠;逐个检查列表归属,分为已归类和未归类,默认只整理未归类者;制定分类计划(优先现有列表,新列表须宽泛可复用,避免近似重复),按主要意图而非描述中的偶然词归类,并标注高/中/低置信度;列表总数最好 5 至 15,超过 15 须先询问并列新列表名与理由;歧义显著时先问用户(如超过 10 个仓库或超过 10% 的未归类仓库为中/低置信度,或许多仓库需要未经批准的新类别);创建获批缺失列表;把每个未归类仓库加入最小合理数量的列表;更新后重新读取成员关系验证;报告复用/新建的列表、新增与跳过的仓库、因置信度过低而留下的仓库及需人工判断之处。

分类规则:偏好宽泛稳定主题;少于 3 个仓库不新建列表(除非用户明确要);列表名单一职责,不用 & / 等复合含义;避免琐碎区分(如 AI Agents 与 Agent Frameworks),可合并为宽泛列表;通常混合领域、工具与学习/参考类;不建纯语言列表(除非用户明确要);采用两遍规划:先复用匹配,再为无法干净归入现有列表、且足够宽泛的集群建新列表。写入策略:只自动应用高置信度;中置信度批量写入前问用户;低置信度绝不自动应用。

归属判断信号优先级:仓库名、简短描述/标语、项目类型与用户、生态与技术,之后才是次要关键词。负面规则:提到 server/node/API/auth 不等于后端;有 UI 或 demo 不等于前端;有文档或示例不等于学习/参考;被开发者使用不等于 AI 编程工具;是应用不等于效率工具。

各类别意图:Learning 仅用于 awesome 列表、教程、指南、课程、示例、模板、参考与教学起始材料;Frontend 用于 UI 框架、组件库、CSS 系统、动画库、编辑器、设计系统、浏览器交互工具与明确前端应用框架;Backend 用于 API、数据库、部署栈、可观测性、基础设施平台、队列、认证服务端、服务端平台与运维工具;AI Coding Tools 用于主要帮助写、查、运行、审阅或管理代码的 AI/开发者自动化工具;AI Agents 用于 agent 运行时、编排、运行环境、自主助手与多 agent 控制面;AI Skills & Prompts 用于可复用提示、技能、指令包、子代理、模板等;RAG & Search 用于检索、向量搜索、记忆系统、嵌入管道、索引与语义搜索;Productivity & Personal Tools 用于终端用户笔记、个人系统、自动化、消息桥接与个人工作流软件。若无法干净归入现有类别,宁可提议新稳定列表或留待审核,不勉强塞入。

GitHub 细节:实现指引见 references/algorithm.md,保守分类指引见 references/classification.md;仓库归属核心端点为 /<owner>/<repo>/lists,用于检测是否已归类,已勾选则默认跳过,添加后重新拉取同一菜单确认勾选状态。

何时询问用户:目标账号不明、浏览器自动化不可用、未启用 Chrome 远程调试、GitHub 会话未认证、需要超过 15 个列表、歧义高到批量写入可能产生错误归属、或存在大量边界/重复列表名且安全复用不明确。

禁止项:不得把特定用户账号作为隐藏默认;不得盲目创建数十个列表;不得未经许可破坏或重写现有组织;不得用 page=N 遍历 Stars;检查当前列表归属前不得视为未归类;不得仅按编程语言归类;不得把 Learning & Reference 当作不确定时的偷懒兜底;不得据微弱偶然关键词归入 Backend & Infra 或 Frontend & UX。