GitHub Issue 创建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/github-issue-creator-zh。
技能介绍
问题从哪来
日常排障和反馈往往落在 Slack 语音转写、随手粘贴的堆栈、或「部署又挂了但控制台啥也没有」这类半结构化碎片里。直接丢进 GitHub Issue 标题和正文,读者要自己猜复现路径、严重程度和是否涉及敏感信息,Issue 质量参差,也不利于后续检索。
技能如何整理输出
本技能把杂乱输入收敛成一份可执行的 Issue 草稿,并以 Markdown 文件形式写入仓库根目录的 issues/(命名:YYYY-MM-DD-short-description.md),而不是只在对话里给一段文字。
核心做法包括:
- 从口语里抽事实:听写里的「跑了三次、刷新才看见」会被整理成复现步骤与现象描述,去掉 filler。
- 补全隐含上下文:若提到「同一个项目」「那个仪表盘」,结合对话或记忆补全项目名、模块名(无法确认时用占位符)。
- 敏感信息占位:对可能泄露的内容使用
[PROJECT_NAME]、[USER_ID]等,避免原样进仓库。 - 严重程度对齐影响:按 Critical / High / Medium / Low 与「宕机、数据丢失、安全」到「轻微 UI」的梯度匹配,而不是一律标 High。
- 错误块与附件:错误消息单独成块;截图/GIF 用行内附件引用格式,便于在 Issue 正文里对齐。
输出结构通常包含:标题级摘要、错误消息/代码(如适用)、复现或背景、期望与实际行为,以及已标注的严重级别。
适用边界
- 产出是本地/仓库内的 Issue 草稿文件,是否创建 GitHub 上的远程 Issue 仍取决于你的工作流(例如再粘贴或由其它工具提交)。
- 严重级别与占位符依赖模型对上下文的推断;涉及合规或生产事故时,提交前应由人复核。
- 图片/GIF 需要你在环境中具备可引用的附件路径或约定,技能只规范引用格式,不负责上传 GitHub Assets。
使用场景
- CI 失败后只有一段 403 权限错误粘贴,需要整理成含错误块、严重级别和背景的 Issue 草稿 Markdown
- 语音转写里描述「部署静默失败、刷新三次才复现」,要抽成复现步骤并写入 issues/ 目录供 PR 引用
- 截图/GIF 说明 UI 异常,需按技能格式行内引用附件并占位敏感项目名后落盘
- 线上事故口述笔记杂乱,需推断上下文、用 [USER_ID] 等占位并标注 Critical/High 后再归档到仓库
适合人员
- 维护开源仓库、习惯在仓库内留 Issue 草稿而非直接开远程 Ticket 的维护者
- SRE 或后端工程师,常把 Slack 语音/日志片段整理成可检索的缺陷记录文件
- 团队用 Markdown 在 monorepo 的 issues/ 目录跟踪内部缺陷的产品或平台开发
- 需要统一 Critical/High/Medium/Low 表述、避免敏感信息进 Git 历史的合规敏感项目成员