用途:用户给出 GitHub 仓库后,本技能在本地克隆该仓库,并通过多个并行子代理从不同视角分析,最终在对话中输出一份以“What/Why”为核心的开源项目报告。目标是帮助用户快速判断“这是不是我需要的,我为什么要用它”,而不是做实现层深挖。
主要能力:提供四个默认分析视角——what-lens(这是什么,一句话定义与 3–5 项核心能力)、why-lens(为什么存在,解决什么问题、有无它时的替代做法、同类替代品与差异点)、who-when-lens(谁在用、何时用,目标用户、具体用例与不适用场景)、how-used-lens(用户视角怎么用,安装、最小示例、从零到首次成功的典型流程、交互入口)。支持用户附加自定义问题,每个问题单独派发一个子代理,并在最终报告的 Custom Q&A 部分给出带文件路径引用的回答。
使用方式:触发词包括“/analyze-oss”、“분석해줘 이 오픈소스”等。输入可接受 GitHub URL(https://github.com/owner/repo 或 git@github.com:...)、owner/repo 简写,以及可选的自定义问题。执行流程为:克隆仓库到 ~/opensource-analysis/<repo-name>/,主代理先做快速侦察(README、包描述文件、目录列表、最近提交),再并行派发子代理,最后合成报告。克隆相关命令按资料保持原样,例如使用 git clone --depth 50 <repo-url> 到目标目录,已有 .git 时用 git pull --ff-only 更新。
适用场景:用户给出 GitHub URL 想了解它是什么、为何存在;问“这个仓库是做什么的”“为什么要用它”;评估是否引入某个库;快速入门一个开源项目。
限制与边界:输出仅在对话中呈现,除非用户明确要求否则不写报告文件;不鼓励断言项目流行度或质量;推断内容会标注 [inferred]。私有或 404 仓库克隆会失败并提示用户;超大仓库(>500MB)可能较慢;单仓库多包时需先确认聚焦哪个子包;非代码仓库(如 awesome 列表、文档)会调整“如何使用”视角;本地有改动导致无法拉取时不强制覆盖。报告生成后还会询问是否需要进一步深挖(如与某项目对比、认证机制、许可证细节等)。