# 每周刷新 Issue 知识库示例

> 端到端演示：定期归纳已关闭 Issue，更新知识库 Wiki。

## 场景

gitlink-cli 项目维护者，本周关闭了 20 个 Issue，想更新知识库。

## 完整对话流程

### 触发

```
用户: 帮我整理这周关闭的 Issue，更新知识库

AI: 好的，先采集最近关闭的 Issue。
```

### Step 1-2: 采集 + 筛选

```bash
gitlink-cli issue +list --state closed --limit 100 --format json
```

```
AI 采集到 20 个已关闭 Issue：
- 排除 5 个测试 Issue
- 剩余 15 个有效 Issue，读取详情中...
```

### Step 3-4: 分类 + 聚类

```
AI 展示分析结果：

📊 Issue 分类结果（共 15 条有效）

类型分布：
| 类型 | 数量 | 占比 |
|------|------|------|
| 🐛 Bug 报告 | 8 | 53% |
| 💡 功能请求 | 5 | 33% |
| 📖 使用问题 | 2 | 13% |

───────────────

🐛 Bug 高频模块：
| 模块 | Bug 数 | 典型症状 |
|------|--------|----------|
| Issue/PR 数据展示 | 4 | view 命令返回字段与网页不一致 |
| 命令执行 | 2 | 特定参数下命令静默失败 |
| 平台兼容 | 2 | Windows 下行为异常 |

💡 功能请求热度：
| 领域 | 请求数 | 用户期望 |
|------|--------|----------|
| API 查询增强 | 3 | 支持更丰富的查询和字段返回 |

📖 使用问题（2 条）：
- 安装后如何配置环境变量？
- API 命令占位符怎么用？
```

### Step 5: 生成并确认

```
AI 生成知识库 Markdown，展示前几段预览...

用户: 可以，发布到 Wiki

AI: 好的，更新 Wiki 页面...
```

### Step 6: 发布

```bash
gitlink-cli wiki +update --title "Issue-知识库" --file ./issue-knowledge-base.md
```

```
AI: ✅ 知识库已更新！
- Wiki 页面: Issue-知识库
- 本次新增: 15 条 Issue → 6 个聚类
- 下次建议: 2 周后刷新
```
