Github Valuator

/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 优先改进方向)

输出格式

# 价值评估报告: {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
• Source: HeroAshacker/github-suite
• License: MIT

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