github-explorer

GitHub Explorer — 项目深度分析

Philosophy: README 只是门面，真正的价值藏在 Issues、Commits 和社区讨论里。

Workflow

[项目名] → [1. 定位 Repo] → [2. 多源采集] → [3. 分析研判] → [4. 结构化输出]

Phase 1: 定位 Repo

• 用 web_search 搜索 site:github.com <project_name> 确认完整 org/repo
• 用 search-layer（Deep 模式 + 意图感知）补充获取社区链接和非 GitHub 资源：

  python3 skills/search-layer/scripts/search.py \
    --queries "<project_name> review" "<project_name> 评测 使用体验" \
    --mode deep --intent exploratory --num 5
  

• 用 web_fetch 抓取 repo 主页获取基础信息（README、Stars、Forks、License、最近更新）

Phase 2: 多源采集（并行）

⚠️ GitHub 页面抓取规则（强制）：GitHub repo 页面是 SPA（客户端渲染），web_fetch 只能拿到导航栏壳子，禁止用 web_fetch 抓 github.com 的 repo 页面。一律使用 GitHub API：

• README: curl -s -H "Authorization: token {PAT}" -H "Accept: application/vnd.github.v3.raw" "https://api.github.com/repos/{owner}/{repo}/readme"
• Repo 元数据: curl -s -H "Authorization: token {PAT}" "https://api.github.com/repos/{owner}/{repo}"
• Issues: curl -s -H "Authorization: token {PAT}" "https://api.github.com/repos/{owner}/{repo}/issues?state=all&sort=comments&per_page=10"
• Commits: curl -s -H "Authorization: token {PAT}" "https://api.github.com/repos/{owner}/{repo}/commits?per_page=10"
• File tree: curl -s -H "Authorization: token {PAT}" "https://api.github.com/repos/{owner}/{repo}/git/trees/{branch}?recursive=1"

PAT 见 TOOLS.md。

以下来源按需检查，有则采集，无则跳过：

来源	URL 模式	采集内容	建议工具
GitHub Repo	github.com/{org}/{repo}	README、About、Contributors	web_fetch
GitHub Issues	github.com/{org}/{repo}/issues?q=sort:comments	Top 3-5 高质量 Issue	browser
中文社区	微信/知乎/小红书	深度评测、使用经验	content-extract
技术博客	Medium/Dev.to	技术架构分析	web_fetch / content-extract
讨论区	V2EX/Reddit	用户反馈、槽点	search-layer（Deep 模式）

search-layer 调用规范

search-layer v2 支持意图感知评分。github-explorer 场景下的推荐用法：

场景	命令	说明
项目调研（默认）	python3 skills/search-layer/scripts/search.py --queries "<project> review" "<project> 评测" --mode deep --intent exploratory --num 5	多查询并行，按权威性排序
最新动态	python3 skills/search-layer/scripts/search.py "<project> latest release" --mode deep --intent status --freshness pw --num 5	优先新鲜度，过滤一周内
竞品对比	python3 skills/search-layer/scripts/search.py --queries "<project> vs <competitor>" "<project> alternatives" --mode deep --intent comparison --num 5	对比意图，关键词+权威双权重
快速查链接	python3 skills/search-layer/scripts/search.py "<project> official docs" --mode fast --intent resource --num 3	精确匹配，最快
社区讨论	python3 skills/search-layer/scripts/search.py "<project> discussion experience" --mode deep --intent exploratory --domain-boost reddit.com,news.ycombinator.com --num 5	加权社区站点