forked from Gitlink/gitlink-cli
164 lines
7.2 KiB
Markdown
164 lines
7.2 KiB
Markdown
# 示例一：在个人仓库上分拣 Issue
|
||
|
||
> 完整运行记录：[WorkBuddy 任务链接](https://codebuddy.work/agents/tasks/share/1OyFJtnSag?platform=workbuddy)
|
||
|
||
## 场景说明
|
||
|
||
在自己有管理权限的 GitLink 仓库上，使用本 Skill 自动完成 Issue 分类、打标签、分配责任人和设置优先级。
|
||
|
||
## 运行环境
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| **后端** | GitLink（gitlink-cli） |
|
||
| **目标仓库** | [Angel123456/gitlink-cli](https://www.gitlink.org.cn/Angel123456/gitlink-cli) |
|
||
| **运行模式** | `hybrid`（规则优先 + LLM 兜底） |
|
||
| **规则数量** | 3 条（bug-default / question-default / docs-typo） |
|
||
| **涉及 Issue** | 4 条（全部无标签、无责任人） |
|
||
|
||
## 分拣前状态
|
||
|
||
4 条 Issue 均为未分拣状态：
|
||
|
||
| # | 标题 | 标签 | 责任人 |
|
||
|---|------|------|--------|
|
||
| #4 | 服务启动时偶尔会崩溃 | 无 | 无 |
|
||
| #5 | 建议支持 JSON 格式日志输出 | 无 | 无 |
|
||
| #6 | 请问如何配置多环境变量？ | 无 | 无 |
|
||
| #7 | 建议支持 Markdown 格式的评论 | 无 | 无 |
|
||
|
||
## dry-run 预览
|
||
|
||
Agent 完成规则评估后输出预览，**此阶段未修改任何 Issue**：
|
||
|
||
| # | 标题 | 建议标签 | 责任人 | 优先级 | 命中规则 |
|
||
|---|------|----------|--------|--------|----------|
|
||
| #4 | 服务启动时偶尔会崩溃 | 缺陷 | Angel123456 | 高 | bug-default |
|
||
| #5 | 建议支持 JSON 格式日志输出 | 功能 | Hsy15889521073 | 正常 | LLM兜底 |
|
||
| #6 | 请问如何配置多环境变量？ | 疑问 | Priziq | 正常 | question-default |
|
||
| #7 | 建议支持 Markdown 格式的评论 | 重复 | Hsy15889521073 | 低 | LLM兜底(重复检测) |
|
||
|
||
## 执行写回
|
||
|
||
用户确认后，Agent 按工作流执行：
|
||
|
||
1. **回读**：每条 Issue 先 `view` 获取当前标题和正文
|
||
2. **PATCH**：写入 `issue_tag_ids` + `assigner_ids` + `priority_id`，同时带回标题和正文防止清空
|
||
3. **审计评论**：记录命中规则和关键词
|
||
|
||
## 验证结果
|
||
|
||
| # | 标题 | 标签 | 责任人 | 优先级 | 正文保留 | 审计评论 |
|
||
|---|------|------|--------|--------|----------|----------|
|
||
| #4 | 服务启动时偶尔会崩溃 | ✅ 缺陷 | ✅ Angel123456 | ✅ 高 | ✅ | ✅ |
|
||
| #5 | 建议支持 JSON 格式日志输出 | ✅ 功能 | ✅ Hsy15889521073 | ✅ 正常 | ✅ | ✅ |
|
||
| #6 | 请问如何配置多环境变量？ | ✅ 疑问 | ✅ Priziq | ✅ 正常 | ✅ | ✅ |
|
||
| #7 | 建议支持 Markdown 格式的评论 | ✅ 重复 | ✅ Hsy15889521073 | ✅ 低 | ✅ | ✅ |
|
||
|
||
## 执行统计
|
||
|
||
| 指标 | 数据 |
|
||
|------|------|
|
||
| 涉及 Issue | 4 条 |
|
||
| 规则命中 | 2 条（bug-default / question-default） |
|
||
| LLM 兜底 | 2 条（功能需求 / 重复检测） |
|
||
| API 调用 | 12 次（全部成功） |
|
||
| 人工干预 | 仅确认 dry-run + 指定责任人 |
|
||
| 总耗时 | 约 2 分钟 |
|
||
|
||
## 分拣后 Issue 页面
|
||
|
||
- [#4](https://www.gitlink.org.cn/Angel123456/gitlink-cli/issues/4)
|
||
- [#5](https://www.gitlink.org.cn/Angel123456/gitlink-cli/issues/5)
|
||
- [#6](https://www.gitlink.org.cn/Angel123456/gitlink-cli/issues/6)
|
||
- [#7](https://www.gitlink.org.cn/Angel123456/gitlink-cli/issues/7)
|
||
|
||
|
||
|
||
# 示例二：在他人仓库上分拣 Issue
|
||
|
||
> 完整运行记录：[WorkBuddy 任务链接](https://codebuddy.work/agents/tasks/share/mmnw7Ov594?platform=workbuddy)
|
||
|
||
## 场景说明
|
||
|
||
在他人仓库上运行 Skill，演示**权限受限场景**下的适配能力：
|
||
- 无法获取成员列表（403）→ 跳过责任人分配
|
||
- 仍可执行打标签、设优先级、添加审计评论
|
||
- 体现 Skill 在开源社区协作场景中的实用性
|
||
|
||
## 运行环境
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| **后端** | GitLink（gitlink-cli） |
|
||
| **目标仓库** | [Gitlink/gitlink-cli](https://www.gitlink.org.cn/Gitlink/gitlink-cli)（官方主仓库） |
|
||
| **当前用户** | Angel123456（非仓库成员） |
|
||
| **运行模式** | `hybrid`（规则优先 + LLM 兜底） |
|
||
| **涉及 Issue** | 9 条（全部无标签、无责任人） |
|
||
|
||
## 受限情况说明
|
||
|
||
| 操作 | 结果 | 处理方式 |
|
||
|------|------|----------|
|
||
| 查询成员列表 | ❌ 403 Forbidden | 跳过成员查询，责任人标记为「待指定」 |
|
||
| 查询 Issue 列表 | ✅ 成功 | 正常获取 9 条开放 Issue |
|
||
| 查询标签列表 | ✅ 成功 | 正常获取 10 个中文标签 |
|
||
| 写回 Issue | ⚠️ 需验证 | 用户确认后尝试执行 |
|
||
|
||
## dry-run 预览
|
||
|
||
| # | 标题 | 建议标签 | 责任人 | 优先级 | 命中规则 |
|
||
|---|------|----------|--------|--------|----------|
|
||
| #21 | dataset 快捷命令需要的后端 API 支持 | 功能 | 待指定 | 正常 | LLM兜底 |
|
||
| #20 | bug: api 命令单次调用不替换占位符 | 缺陷 | 待指定 | 高 | LLM兜底 |
|
||
| #6 | 只要创建Issue就让Agent开始干活 | 功能 | 待指定 | 正常 | LLM兜底 |
|
||
| #18 | issue +update后issue状态框变红色 | 缺陷 | 待指定 | 高 | LLM兜底 |
|
||
| #17 | API是否支持自动读取仓库内文件？ | 文档 | 待指定 | 低 | docs-typo |
|
||
| #14 | pr +view 的返回中缺少PR关闭时间 | 功能 | 待指定 | 正常 | LLM兜底 |
|
||
| #5 | 通过这个skill认领任务，描述信息消失 | 缺陷 | 待指定 | 高 | LLM兜底 |
|
||
| #15 | issue +view 返回数据与网页不一致 | 缺陷 | 待指定 | 高 | bug-default ✅ |
|
||
| #2 | gitlink-cli 使用讨论与反馈收集 | 协助 | 待指定 | 正常 | LLM兜底 |
|
||
|
||
## 执行写回
|
||
|
||
用户确认后，Agent 尝试执行写回：
|
||
|
||
- **打标签**：✅ 全部成功（9/9）
|
||
- **设置优先级**：✅ 全部成功（9/9）
|
||
- **审计评论**：✅ 全部成功（9/9）
|
||
- **分配责任人**：⏭️ 跳过（无成员列表权限）
|
||
|
||
## 验证结果
|
||
|
||
| # | 标题 | 标签 | 责任人 | 优先级 | 审计评论 |
|
||
|---|------|------|--------|--------|----------|
|
||
| #21 | dataset 快捷命令需要的后端 API 支持 | ✅ 功能 | 未分配 | ✅ 正常 | ✅ |
|
||
| #20 | bug: api 命令单次调用不替换占位符 | ✅ 缺陷 | 未分配 | ✅ 高 | ✅ |
|
||
| #6 | 只要创建Issue就让Agent开始干活 | ✅ 功能 | 未分配 | ✅ 正常 | ✅ |
|
||
| #18 | issue +update后issue状态框变红色 | ✅ 缺陷 | 未分配 | ✅ 高 | ✅ |
|
||
| #17 | API是否支持自动读取仓库内文件？ | ✅ 文档 | 未分配 | ✅ 低 | ✅ |
|
||
| #14 | pr +view 的返回中缺少PR关闭时间 | ✅ 功能 | 未分配 | ✅ 正常 | ✅ |
|
||
| #5 | 通过这个skill认领任务，描述信息消失 | ✅ 缺陷 | 未分配 | ✅ 高 | ✅ |
|
||
| #15 | issue +view 返回数据与网页不一致 | ✅ 缺陷 | 未分配 | ✅ 高 | ✅ |
|
||
| #2 | gitlink-cli 使用讨论与反馈收集 | ✅ 协助 | 未分配 | ✅ 正常 | ✅ |
|
||
|
||
## 执行统计
|
||
|
||
| 指标 | 数据 |
|
||
|------|------|
|
||
| 涉及 Issue | 9 条 |
|
||
| 规则命中 | 2 条（bug-default / docs-typo） |
|
||
| LLM 兜底 | 7 条 |
|
||
| API 调用 | 27 次（全部成功） |
|
||
| 权限受限处理 | 自动跳过责任人分配，不影响其他操作 |
|
||
| 总耗时 | 约 3 分钟 |
|
||
|
||
## 关键结论
|
||
|
||
即使在**无管理权限**的他人仓库上，Skill 仍然能够：
|
||
1. 正常读取 Issue 列表和标签列表
|
||
2. 完成规则评估和 dry-run 预览
|
||
3. 成功执行打标签、设置优先级、添加审计评论
|
||
4. 优雅处理权限不足的情况，不阻塞整体流程
|
||
|
||
这证明了 Skill 在**开源社区协作场景**（如帮助其他项目维护者分类 Issue）中的实用价值。 |