# Github Valuator

> |

- **Type:** Skill
- **Install:** `agentstack add skill-heroashacker-github-suite-github-valuator`
- **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-valuator

## Install

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

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

## About

# /github-valuator - GitHub 项目价值评估器

从技术/产品/生态/AI 四维度独立评估项目价值，输出量化评分报告。

## Instructions

### 调用格式

```
/github-valuator 
/github-valuator  --focus "技术,生态"
```

- repo 格式: `owner/repo` 或完整 URL
- `--focus` 可选，仅评估指定维度（默认全部 4 维度）

### 四维价值评估框架

| 维度 | 子维度数 | 权重 | 评估范围 |
|------|----------|------|----------|
| 技术价值 | 5 | 25% | 架构/代码质量/安全/API/性能 |
| 产品价值 | 4 | 25% | API 设计/跨平台/通道架构/文档 |
| 生态价值 | 4 | 25% | 依赖健康/演进趋势/测试质量/社区 |
| AI/Agent 价值 | 2 | 25% | AI 架构成熟度/Skill 生态 |

### 评分等级

- S 级 (>=90): 业界标杆，可直接采用
- A 级 (>=80): 优秀，推荐使用
- B 级 (>=70): 良好，可用但有改进空间
- C 级 (>=60): 及格，需评估替代方案
- D 级 (<60): 不推荐，存在明显短板

### 子维度详解

**技术价值 (D01-D05)**

| 代号 | 子维度 | 权重 | 评估要素 | 证据类型 |
|------|--------|------|----------|----------|
| D01 | 架构设计 | 25% | Monorepo 结构、分层数、模块化、plugin-sdk | 代码静态分析 |
| D02 | 代码质量 | 25% | TS 覆盖、lint 配置、风格一致性 | 静态分析 + lint |
| D03 | 安全性 | 20% | 鉴权机制、沙箱隔离、权限粒度 | 代码审计 |
| D04 | API 设计 | 15% | RPC 方法数、协议兼容性、文档覆盖 | 接口分析 |
| D05 | 性能优化 | 15% | 启动时间、内存占用、并发处理 | 基准测试/推断 |

**产品价值 (D04/D08/D10/D11)**

| 代号 | 子维度 | 权重 | 评估要素 | 行业基准 |
|------|--------|------|----------|----------|
| D04 | API 设计 | 25% | 方法数、协议兼容、文档覆盖 | 70 |
| D08 | 跨平台 | 25% | 平台数、原生支持度 | 65 |
| D10 | 通道架构 | 25% | 通道数、统一抽象层、消息路由 | 60 |
| D11 | 文档体系 | 25% | 文档数、覆盖率、示例质量 | 72 |

**生态价值 (D06/D07/D12/D15)**

| 代号 | 子维度 | 权重 | 评估要素 | 风险等级 |
|------|--------|------|----------|----------|
| D06 | 依赖健康 | 25% | 直接/开发依赖数、版本策略 | 中 |
| D07 | 演进趋势 | 25% | commit 频率、贡献者增长、release 节奏 | 低 |
| D12 | 测试质量 | 25% | 覆盖率、测试类型分布 | 低 |
| D15 | 社区生态 | 25% | 贡献者数、issue 活跃度、PR 合并率 | 中 |

**AI/Agent 价值 (D09/D16)**

| 代号 | 子维度 | 权重 | 评估要素 |
|------|--------|------|----------|
| D09 | AI/Agent 模式 | 50% | Agent 架构分层、LLM Provider 数、工具系统 |
| D16 | Skill 生态 | 50% | 内置 Skill 数、社区扩展、自生成能力 |

### 工作流程

```
Step 1: 项目信息采集
  ├─ gh repo view {repo} --json (基础指标)
  ├─ gh api repos/{repo}/languages (技术栈)
  ├─ gh api repos/{repo}/contributors?per_page=30 (贡献者)
  ├─ gh api repos/{repo}/releases?per_page=10 (发布节奏)
  └─ 克隆/浏览代码结构 (架构分析)

Step 2: 四维度独立评估
  ├─ 技术价值: D01-D05 逐项评分，代码级证据
  ├─ 产品价值: D04/D08/D10/D11 评分，对比行业基准
  ├─ 生态价值: D06/D07/D12/D15 评分，标注风险等级
  └─ AI 价值: D09/D16 评分，关注生命周期完整性

Step 3: 综合评估
  ├─ 四维度加权总分
  ├─ 等级判定 (S/A/B/C/D)
  ├─ 短板识别 (拉低总分最多的维度)
  └─ 与行业基准差距分析

Step 4: 价值结论
  ├─ 一句话价值判断
  ├─ 适用场景推荐
  ├─ 风险提示 (高风险子维度)
  └─ 改进建议 (Top 3 优先改进方向)
```

### 输出格式

```markdown
# 价值评估报告: {owner/repo}

## 1. 项目概览
(名称/描述/Stars/Forks/语言/许可证/最近活跃度)

## 2. 四维价值评分

### 2.1 技术价值: XX/100 (等级)
| 代号 | 子维度 | 得分 | 证据摘要 |
(D01-D05 逐项)

### 2.2 产品价值: XX/100 (等级)
| 代号 | 子维度 | 得分 | vs 行业基准 | 差距 |
(D04/D08/D10/D11)

### 2.3 生态价值: XX/100 (等级)
| 代号 | 子维度 | 得分 | 风险等级 |
(D06/D07/D12/D15)

### 2.4 AI/Agent 价值: XX/100 (等级)
| 代号 | 子维度 | 得分 | 关键发现 |
(D09/D16)

## 3. 综合评估
- 加权总分: XX/100 (等级)
- 短板维度: DXX (拉低 X 分)
- 行业基准对比: +/-X (超越/落后)

## 4. 价值结论
- 一句话判断
- 适用场景 (表格)
- 风险提示
- Top 3 改进建议 (P0/P1/P2)
```

### 约束

- 每个子维度评分必须有具体证据（文件路径/数据/代码行数）
- 无 AI/Agent 相关代码的项目，AI 维度标注"不适用"并从总分权重中移除
- `--focus` 模式下仅输出指定维度，总分按指定维度重新加权
- 产品维度必须标注与行业基准的差距值

## 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-valuator
- 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%.