# 项目健康度报告生成工作流示例（含数据分析）

**场景**：项目维护者需要生成一份带评分和改进建议的健康度报告。

## 前置条件

- `gitlink-cli` 已安装并登录

## 工作流步骤

### Step 1：采集原始数据

```bash
gitlink-cli repo +info --owner z2_cc --repo gitlink-cli --format json
gitlink-cli issue +list --owner z2_cc --repo gitlink-cli --state all --format json
gitlink-cli issue +list --owner z2_cc --repo gitlink-cli --state open
gitlink-cli issue +list --owner z2_cc --repo gitlink-cli --state closed --limit 50
gitlink-cli pr +list --owner z2_cc --repo gitlink-cli --state all --format json
gitlink-cli pr +list --owner z2_cc --repo gitlink-cli --state merged --limit 30
gitlink-cli commit +list --owner z2_cc --repo gitlink-cli --limit 50
gitlink-cli milestone +list --owner z2_cc --repo gitlink-cli
```

### Step 2：AI 分析数据

对采集到的 JSON 数据进行以下分析：

```
1. Issue 分析：
   - 从 all 数据中统计 open 和 closed 数量
   - 从 closed 数据中计算平均响应时间（created_at → closed_at）
   - 判断关闭率是否 > 80%

2. PR 分析：
   - 从 all 数据中统计 open/merged/closed 数量
   - 从 merged 数据中计算平均合并时间
   - 判断是否有 PR 长期未合并

3. 活跃度分析：
   - 从 commit 数据中统计 unique author 数量
   - 根据提交时间判断频率
```

### Step 3：生成带评分的报告

按 SKILL.md 中定义的分析逻辑计算各维度评分（Issue 关闭率/响应时间、PR 合并率/堆积、贡献者活跃度），然后按加权公式计算综合得分：

```
综合得分 = Issue得分 × 30% + PR得分 × 30% + 活跃度得分 × 25% + 里程碑得分 × 15%
```

```markdown
# 📊 项目健康度报告 — z2_cc/gitlink-cli

**报告日期：** 2026-06-25
**综合评分：** 7.2/10 🟢 良好

---

## 一、基本信息

| 指标 | 数据 |
|------|------|
| 项目 | z2_cc/gitlink-cli |
| 默认分支 | master |
| Issue 总数 | 16 |
| PR 总数 | 5 |
| 近 30 天活跃贡献者 | 1 人 |

---

## 二、Issue 状况（评分：8/10 🟢）

| 指标 | 数据 | 状态 |
|------|------|------|
| 总 Issue 数 | 16 | — |
| 打开中 | 2 | — |
| 已关闭 | 14 | — |
| 关闭率 | 87.5% | 🟢 优秀 |
| 平均响应时间 | < 2 天 | 🟢 响应及时 |

**分析：** 关闭率优秀，积压很少，响应及时。

---

## 三、PR 状况（评分：7/10 🟢）

| 指标 | 数据 | 状态 |
|------|------|------|
| 总 PR 数 | 5 | — |
| 打开中 | 1 | — |
| 已合并 | 4 | — |
| 合并率 | 80% | 🟢 良好 |
| 平均合并时间 | 3-7 天 | 🟡 正常 |

**分析：** 合并率良好，处理效率正常。

---

## 四、贡献者活跃度（评分：7/10 🟢）

| 指标 | 数据 | 状态 |
|------|------|------|
| 近 50 次提交贡献者 | 1 人 | 🔴 单人维护 |
| 提交频率 | 每天都有提交 | 🟢 非常活跃 |
| 新贡献者比例 | 0% | 🔴 缺少新人 |

**分析：** 目前单人维护，提交活跃但缺乏新贡献者，建议标记一些 good-first-issue 吸引新人。

---

## 五、里程碑进度

| 里程碑 | 到期日 | 完成度 | 状态 |
|--------|--------|--------|------|
| （无活跃里程碑） | — | — | 🟡 暂无数据 |

---

## 六、综合评分计算

| 维度 | 得分 | 权重 | 加权得分 |
|------|:----:|:----:|:--------:|
| Issue 健康度 | 8/10 | × 30% | 2.4 |
| PR 健康度 | 7/10 | × 30% | 2.1 |
| 贡献者活跃度 | 7/10 | × 25% | 1.75 |
| 里程碑进度 | 6/10 | × 15% | 0.9 |
| **综合得分** | | | **7.15/10 → 7.2 🟢 良好** |

**评分区间：**
- 9-10 分 → 🟢 优秀：项目健康，保持现状
- 7-8 分  → 🟢 良好：个别方面需关注
- 5-6 分  → 🟡 一般：需要改进
- 3-4 分  → 🔴 堪忧：需重点治理
- 0-2 分  → 🔴 危险：项目急需干预

---

## 七、改进建议

1. **🔴 高优先级** — 添加 good-first-issue 标签吸引新贡献者
2. 🟡 关注堆积 PR，及时 review
3. 🟢 考虑添加 CI/CD 自动化

---

