zclaw_openfang/skills/github-deep-research/SKILL.md

name, description, triggers, tools

name	description	triggers	tools
github-deep-research	GitHub 仓库深度研究 — 多轮研究结合 GitHub API、Web搜索和内容抓取，产出包含执行摘要、时间线、指标分析和架构图的全面分析报告。	分析仓库 研究这个项目 GitHub分析 开源项目分析 仓库调研 项目深度研究	web_fetch bash read write

GitHub 深度研究技能

多轮研究结合 GitHub API、Web 搜索和内容抓取，产出全面的 Markdown 分析报告。

研究工作流

Round 1: GitHub API 基础数据

通过 GitHub API 获取核心指标：

# 仓库基本信息
curl -s "https://api.github.com/repos/{owner}/{repo}"

# Star 历史（需 token）
# 贡献者
curl -s "https://api.github.com/repos/{owner}/{repo}/contributors?per_page=30"

# 最近提交
curl -s "https://api.github.com/repos/{owner}/{repo}/commits?per_page=30"

# Issues 和 PR 统计
curl -s "https://api.github.com/repos/{owner}/{repo}/issues?state=all&per_page=30"

提取指标：

• Star/Fork/Watch 数量及趋势
• 贡献者数量和活跃度
• 提交频率和最近活动
• Issue 解决速度
• 语言分布
• License 类型

Round 2: 发现与概览

通过 Web 搜索了解项目全貌：

搜索关键词:
- "{project} overview"
- "{project} architecture"
- "{project} 使用教程"
- "{project} vs alternatives"

Round 3: 深度调查

针对关键问题深入研究：

搜索关键词:
- "{project} 性能测试"
- "{project} 生产环境"
- "{project} known issues"
- "{project} roadmap"

Round 4: 深度分析

综合所有信息，产出最终报告。

报告模板

# {项目名称} 深度研究报告

## 执行摘要
[3-5 句话概括项目定位、成熟度和建议]

## 1. 项目概览
- 定位与目标
- 核心功能
- 技术栈

## 2. 关键指标

| 指标 | 数值 | 说明 |
|------|------|------|
| Stars | XX | 增长趋势 |
| Forks | XX | 社区分支活跃度 |
| Contributors | XX | 核心贡献者数量 |
| Last Commit | XX | 项目活跃度 |
| License | XX | 开源许可 |

## 3. 架构分析
[目录结构、核心模块、依赖关系]

## 4. 社区与生态
[贡献者分析、Issue 处理效率、生态系统]

## 5. 发展时间线
[关键版本和里程碑的 Mermaid 时间线图]

## 6. 竞品对比
[与同类项目的功能/性能/生态对比表]

## 7. 风险与建议
[技术风险、社区风险、使用建议]

Mermaid 图表

报告中可使用 Mermaid 语法嵌入：

时间线图:

timeline
    title 项目发展时间线
    2024-Q1 : v1.0 发布
    2024-Q2 : 获得 1000 Stars
    2024-Q3 : v2.0 架构重构

架构图:

graph TB
    A[核心模块] --> B[插件系统]
    A --> C[API层]
    B --> D[扩展1]
    B --> E[扩展2]

输出

1. 完整的 Markdown 分析报告
2. 关键指标汇总表
3. 架构图（Mermaid）
4. 发展时间线
5. 客观的风险评估和使用建议