ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

GSD-2 Issue Triage 工作流模板实战:让 Agent 自动化 GitHub Issue 分类、定级与行动建议

GSD-2 Issue Triage 工作流模板实战:让 Agent 自动化 GitHub Issue 分类、定级与行动建议 人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址https://gitcode.com/gh_mirrors/gs/gsd-2点击查看免费下载导读本文围绕 GSD-2 仓库中随附的 issue-triage 工作流模板 展开讲解如何让 Agent 以一次性oneshot方式读取一个 GitHub Issue完成分类、打标签、定级并输出下一条具体行动建议。读完本文你将掌握该模板的完整协议从gh拉取数据、六类主分类 七类辅助标签、p0–p3 优先级、结构化输出格式以及它如何与 GSD-2 的工作流模板注册表、/gsd start命令和workflow-oneshot提示词机制协同工作可直接用于你自己的开源仓库维护场景。模板在 GSD-2 中的定位issue-triage是 GSD-2 扩展内置的 25 个工作流模板之一目录见 workflow-templates/属于oneshot模式其元数据在 registry.json 中登记如下issue-triage: { name: Issue Triage, description: Categorize, label, prioritize a GitHub issue and suggest next action (oneshot), file: issue-triage.md, mode: oneshot, phases: [], triggers: [triage issue, categorize issue, label issue, prioritize issue], artifact_dir: null, estimated_complexity: low, requires_project: false }几个关键语义mode: oneshot纯提示词驱动。正如 workflow-oneshot.md 所描述的——没有 STATE.json、没有阶段跟踪、没有产物目录、没有恢复机制执行完指令就返回。这与bugfix、small-feature等markdown-phase模板形成鲜明对比后者会创建.gsd/workflows/...产物目录、写 STATE.json、切gsd/template/slug分支并支持/gsd start resume恢复见 commands-workflow-templates.ts 的writeWorkflowState与findInProgressWorkflows实现。requires_project: false不需要.gsd/项目目录在任何仓库下都能直接对 GitHub 上的 Issue 进行分流。artifact_dir: null不产生任何落盘产物符合只读、只思考、只回复的定位。triggerstriage issue、categorize issue、label issue、prioritize issue。当你在对话中描述这类意图而没有显式指定模板名时workflow-templates.ts 的autoDetect函数会做词法匹配多词 trigger 得分翻倍得分 ≥4 为 high 置信度自动命中该模板。启动方式/gsd start issue-triage模板通过 GSD-2 的斜杠命令派发最直接的调用方式是/gsd start issue-triage #123 /gsd start issue-triage issue-URL如果只给出自然语言描述如 帮我对 #123 做 issue triage系统会先尝试把第一个词解析为模板名resolveByName支持精确名、前缀模糊、别名映射失败后再走autoDetect自动检测命中即触发。相关命令还支持/gsd start --list或/gsd templates——列出全部模板及各自的 phases、复杂度、触发词/gsd templates info issue-triage——查看该模板的详细注册信息/gsd start --dry-run issue-triage #123——只预览会执行的动作而不真正执行。从源码看handleStart在派发前还会做几件事若 auto-mode 正在运行则拒绝启动模板派发会切分支、发消息与自动循环冲突需先/gsd pause若是markdown-phase模板则创建分支与 STATE.json而oneshot 模板全部跳过这些状态化步骤直接把模板内容注入workflow-start提示词后通过pi.sendMessage触发一轮 Agent 回合见 commands-workflow-templates.ts。模板执行协议详解1. 拉取 Issue 数据模板要求从用户参数中取得 Issue 编号#123或 URL缺失则只询问一次。随后用ghCLI 一次性拉取结构化数据gh issue view ref --json number,title,body,labels,author,createdAt,updatedAt,reactions,comments这一步取回了正文、标签、作者、创建/更新时间、reactions 和评论数并顺带检查 linked PRs。判断依据全部来自这些字段评论数反应社区讨论热度reactions 反应关注度createdAt/updatedAt计算年龄与新鲜度。若 Issue 已关闭则直接说明并停止除非用户明确要求复审。这与仓库的 issue-tracker.md 约定的用ghCLI 操作全部 issue 事务保持一致需要注意该文档提醒在 fork 多 remote 场景下应始终显式传-R指向规范仓库。2. 分类一个主分类 辅助标签模板规定恰好选择一个主分类主分类判定标准bug可复现的破坏行为feature-request新能力而非修复question/support用户需要帮助不隐含代码改动docs文档缺口discussion开放式讨论无明确行动invalid重复、离题、垃圾信息在此基础上按需叠加辅助标签needs-repro、needs-info、good-first-issue、regression、security发现安全问题要强烈标记、breaking、external-dep。这套标签词汇与本仓库的 triage-labels.md 描述的跟踪器标签体系needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix互补前者是模板运行时按内容打的语义标签后者是仓库级维护流程的角色标签二者都用gh label/gh issue edit --add-label落地。3. 优先级评估p0–p3优先级含义典型场景p0破坏生产 / 安全 / 数据丢失线上故障、安全漏洞、数据损坏p1显著影响常用工作流高频路径被阻塞p2常规 bug / 功能默认档位p3次要 / 外观 / 远期低影响打磨项评估维度明确给出影响面blast radius、复现频率、reactions 数、是否存在 workaround、是否被既有 issue 引用。这五个维度共同决定级别避免只看单点证据。4. 推荐下一步行动四选一模板要求输出一条具体行动而不是空泛建议Ask for info列出缺失的 1–3 项具体信息复现步骤、版本、日志并起草评论文本Accept and schedule建议接下来运行的工作流例如/gsd start bugfix --issue #123或/gsd workflow small-feature——这里与 bugfix 模板的--issue标志打通把 triage 结论直接喂给后续开发流程Close起草礼貌的关闭评论并给出理由Escalate标记人工复核并给出具体原因。5. 固定输出格式模板强制要求以下结构化输出便于人工或下游脚本消费Issue: #n — title Author: user Age: dd Comments: n Reactions: n Classification: primary, secondary labels Priority: p0/p1/p2/p3 Why: 2–3 sentence rationale Next action: recommendation Comment draft: text to post — or n/a if no comment needed首行浓缩 Issue 身份与热度中间给出分类/定级与理由末尾给出行动与可粘贴的评论草稿——一次调用即可产出可直接执行的维护决策。6. 只建议、不落盘模板最后一条是硬性红线评论草稿与标签变更都只是建议绝不在未获用户明确确认时执行gh issue comment或gh issue edit。这与仓库src/web、扩展工具层的只读/写入门控思路一致例如 GSD-2 的write-gate.ts等工具拦截机制保证 Agent 的自动化和人类在环审批之间的边界清晰。与 GSD-2 运行机制的印证从源码层面可以交叉验证模板的设计oneshot 语义有专门的提示词包装workflow-oneshot.md 明确写出四条执行规则——不建脚手架、不切分支、一次回合内输出单一产物报告/总结/评论、仅在真正被阻塞时才提问。issue-triage正是典型的报告型 oneshot。模板加载与匹配链路完整workflow-templates.ts 提供loadRegistry带缓存、resolveByName精确名 → 大小写不敏感名 → 前缀模糊 → 别名表、autoDetect按 triggers 词法打分排序、loadWorkflowTemplate按注册表 file 字段读取 .md 原文。issue-triage.md即通过file: issue-triage.md被定位加载。无状态设计可反复调用由于artifact_dir: null、mode: oneshot同一条命令可以对任意数量的 Issue 重复执行而不会互相污染非常适合配合脚本批量分流。使用建议与限制适用前提需在本机安装并认证ghCLI且对目标仓库有读取权限Issue 引用必须能从参数中解析出编号或 URL。批量场景可对一批gh issue list结果循环调用本模板但要注意模板输出为单 Issue 报告更适合逐个消费。与后续流程衔接Accept and schedule分支推荐/gsd start bugfix --issue #123等命令将分流结论无缝转交 GSD-2 的 bugfix 工作流执行修复。不越权模板的输出永远是建议与草稿真正的gh issue edit/gh issue comment需人工确认后手动执行。结语issue-triage模板把仓库维护者日常最机械、最耗时的环节——看 Issue、定性、定级、想下一步——压缩成一条 oneshot 命令。它依靠固定的六步协议拉取 → 分类 → 定级 → 建议行动 → 格式化输出 → 不落盘保证了输出的可复现性与可消费性同时通过只建议不执行保留了人类的最终决定权。配合 GSD-2 的模板注册表与/gsd start命令它可以直接嵌入到任何以gh为后端的开源仓库维护流程中。赞分享人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址https://gitcode.com/gh_mirrors/gs/gsd-2点击查看免费下载相关推荐GSD-2 PR Triage 工作流模板用 AI Agent 自动化 PR 分诊与合并建议GSD 2 PR Triage 工作流模板用 AI Agent 自动化 PR 分诊与合并建议 导读 PR TriagePR 分诊是 GSD 2 内置的一类人工智能AI Agent代码智能体Agent 编排CLIAI 应用Claude Code Issue Triage用 Agentic 工作流自动化 GitHub Issue 分类与标签管理Claude Code Issue Triage用 Agentic 工作流自动化 GitHub Issue 分类与标签管理 导读 本篇文章基于 ClaudeAI 应用AI 技能/插件开发工具apify-mcp-server Bug Triage 工作流用 Claude Agent Skill 自动化 GitHub Issue 分诊apify mcp server Bug Triage 工作流用 Claude Agent Skill 自动化 GitHub Issue 分诊 导读 本文讲解上一篇Dioxus WebGL图形编程创建高性能可视化应用的终极指南下一篇CANN ops-cv 3D上采样反向算子创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表