gitlink-cli/skills/gitlink-issue-triage-rules/EXAMPLE.md

7.2 KiB
Raw Blame History

示例一:在个人仓库上分拣 Issue

完整运行记录:WorkBuddy 任务链接

场景说明

在自己有管理权限的 GitLink 仓库上,使用本 Skill 自动完成 Issue 分类、打标签、分配责任人和设置优先级。

运行环境

项目 内容
后端 GitLinkgitlink-cli
目标仓库 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 页面

示例二:在他人仓库上分拣 Issue

完整运行记录:WorkBuddy 任务链接

场景说明

在他人仓库上运行 Skill演示权限受限场景下的适配能力:

  • 无法获取成员列表403→ 跳过责任人分配
  • 仍可执行打标签、设优先级、添加审计评论
  • 体现 Skill 在开源社区协作场景中的实用性

运行环境

项目 内容
后端 GitLinkgitlink-cli
目标仓库 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中的实用价值。