gitlink-cli/skills/gitlink-faq/examples/weekly-faq-refresh-workflow.md

每周刷新 Issue 知识库示例

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

场景

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

完整对话流程

触发

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

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

Step 1-2: 采集 + 筛选

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: 发布

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

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