forked from Gitlink/gitlink-cli
86 lines
1.8 KiB
Markdown
86 lines
1.8 KiB
Markdown
# 每周刷新 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 周后刷新
|
||
```
|