# Github Comparator

> |

- **Type:** Skill
- **Install:** `agentstack add skill-heroashacker-github-suite-github-comparator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [HeroAshacker](https://agentstack.voostack.com/s/heroashacker)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [HeroAshacker](https://github.com/HeroAshacker)
- **Source:** https://github.com/HeroAshacker/github-suite/tree/main/github-comparator

## Install

```sh
agentstack add skill-heroashacker-github-suite-github-comparator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /github-comparator - GitHub 项目竞品对比分析器

多项目横向对比，生成能力矩阵、差异分析和推荐结论。

## Instructions

### 调用格式

```
/github-comparator   [repo3...] [--dimensions "维度1,维度2,..."]
```

- 支持 2-5 个项目同时对比
- `--dimensions` 可选，指定自定义对比维度（默认使用标准 6 维度）
- repo 格式: `owner/repo` 或完整 URL

### 标准对比维度（默认 6 维）

| # | 维度 | 权重 | 评估要素 |
|---|------|------|----------|
| 1 | 架构设计 | 20% | 分层数、模块化、技术栈先进性、可扩展性 |
| 2 | 代码质量 | 15% | TS/类型覆盖、lint 配置、错误处理、命名规范 |
| 3 | 功能完整度 | 20% | 核心功能覆盖、API 丰富度、配置灵活性 |
| 4 | 生态与社区 | 20% | Stars/Forks/贡献者、插件生态、文档质量 |
| 5 | AI/Agent 能力 | 15% | LLM 集成、Agent 架构、工具系统、MCP 支持 |
| 6 | 安全与合规 | 10% | 鉴权机制、沙箱隔离、许可证、漏洞管理 |

### 评分标准

- ★★★★★ (5): 业界领先，S 级 (>=90)
- ★★★★☆ (4): 优秀，A 级 (>=80)
- ★★★☆☆ (3): 良好，B 级 (>=70)
- ★★☆☆☆ (2): 及格，C 级 (>=60)
- ★☆☆☆☆ (1): 不足，D 级 (<60)

### 工作流程

```
Step 1: 项目信息采集（并行）
  ├─ 对每个 repo 执行:
  │   ├─ gh repo view {repo} --json name,description,stargazerCount,forkCount,...
  │   ├─ gh api repos/{repo}/languages
  │   ├─ gh api repos/{repo}/contributors?per_page=10
  │   └─ gh api repos/{repo}/commits?per_page=1 (最近活跃度)
  └─ 汇总基础指标表

Step 2: 逐维度分析
  ├─ 对每个维度:
  │   ├─ 采集各项目在该维度的证据（代码结构/文件统计/API 数量等）
  │   ├─ 给出 ★1-5 评分 + 简要理由
  │   └─ 标注该维度的领先者和落后者
  └─ 自定义维度: 用户指定 --dimensions 时替换默认维度

Step 3: 能力矩阵生成
  ├─ 构建 项目×维度 矩阵表（★ 评分）
  ├─ 计算加权总分
  └─ 生成排名

Step 4: 差异分析
  ├─ 逐维度对比: 各项目优劣势说明
  ├─ 结构性差异: 按价值分组（技术/产品/生态/AI）的组内均分
  └─ 关键差异点: Top 3 最大分差维度详解

Step 5: 推荐结论
  ├─ 综合排名（加权总分）
  ├─ 场景化推荐（不同使用场景下的最佳选择）
  └─ 选型建议（明确推荐 + 理由）
```

### 输出格式

```markdown
# 竞品对比报告: {项目列表}

## 1. 基础指标对比
| 指标 | 项目A | 项目B | 项目C |
|------|-------|-------|-------|
| Stars | ... | ... | ... |
| Forks/Contributors/语言/最近提交/许可证 ...

## 2. 能力矩阵
| 维度 (权重) | 项目A | 项目B | 项目C |
|-------------|-------|-------|-------|
| 架构设计 (20%) | ★★★★☆ | ★★★☆☆ | ★★★★★ |
| ... | ... | ... | ... |
| **加权总分** | **X.X** | **X.X** | **X.X** |

## 3. 差异分析
### 3.1 逐维度对比 (每维度: 领先者、优势说明、差距原因)
### 3.2 结构性差异 (技术/产品/生态/AI 四组均分)
### 3.3 关键差异点 (Top 3 最大分差维度)

## 4. 推荐结论
### 4.1 综合排名
### 4.2 场景化推荐 (表格: 场景 | 推荐项目 | 理由)
### 4.3 选型建议
```

### 约束

- 评分必须有代码级或数据级证据支撑，不可凭印象打分
- 每个维度的评分理由不超过 2 句话，保持简洁
- 自定义维度时权重自动均分
- 项目数超过 5 个时提示用户缩减范围

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [HeroAshacker](https://github.com/HeroAshacker)
- **Source:** [HeroAshacker/github-suite](https://github.com/HeroAshacker/github-suite)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-heroashacker-github-suite-github-comparator
- Seller: https://agentstack.voostack.com/s/heroashacker
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.