GitHub 问题整理器
把杂乱的故障信息整理成可执行的 GitHub 问题报告。
技能明确要求对可能敏感的数据使用占位符,并限定输出为仓库内/issues/目录的Markdown文件;但没有用户确认、权限范围、数据流披露、回滚方案或创建前预览,且“从记忆补全上下文”可能引入未经核实的信息,因此扣分。
输入类型、模板和严重性规则基本一致,且未声明外部依赖;但缺少对空输入、信息冲突、无附件、无仓库目录或非法文件名的处理和诊断反馈,静态评估不超过10分,因此扣分。
目标用户、输入形式和期望的GitHub issue结构较清楚;但未定义不适用场景、触发边界、必填信息或中文输出支持,截图/GIF处理也仅说明引用格式,因此扣分。
具备名称、描述、分节结构、指南和两个示例,仓库还提供MIT许可证、官方组织来源及持续开发信号;但技能自身没有版本、变更记录、维护责任、安装说明、FAQ或已知限制,且输出路径假设未解释,因此扣分。
对整理原始笔记、错误日志并生成可读issue有直接价值,示例展示了可用结构;但结果依赖模型推断,可能需要人工核实,文件创建流程未定义,严重性和环境字段可能被臆测,因此仅给有限静态分。
技能文本提供模板和示例,但示例不是可独立复现的测试证据;提供的仓库测试与CI主要覆盖通用Copilot harness,未证明该技能的关键路径,因此只能给低分。
- 创建/issues/文件前应确认用户授权、目标仓库和文件名,最好先展示草稿。
- 不要依赖“记忆”补全事实;无法确认的环境、版本、产品和影响应使用占位符或明确标注未知。
- 需要补充空输入、冲突信息、附件缺失、敏感信息识别和目录/文件写入失败时的处理规则。
- 未见该技能专属的验收标准或测试证据,结果应视为需要人工复核的草稿。
它能做什么 & 适用场景
此技能将错误日志、语音转写、原始笔记或截图说明整理为结构化的 GitHub 风格 Markdown 问题报告。输出包含摘要、环境、复现步骤、预期与实际行为、错误详情、视觉证据、影响和补充背景。它还会根据影响匹配严重程度,并用占位符替换可能敏感的信息。适合需要统一问题报告格式的开发团队,但不会直接调用 GitHub API 创建远程 Issue。
读取用户提供的故障描述、错误信息和截图上下文;提取产品、版本、环境、复现步骤、预期行为和实际行为;整理错误代码或消息;引用附加的图片或 GIF;为敏感字段生成如 [PROJECT_NAME]、[USER_ID] 的占位符;根据服务中断、数据丢失、功能受损或轻微不便判断严重程度;按固定 Markdown 模板生成问题报告,并将其作为 /issues/ 目录下的日期命名 Markdown 文件。
- 开发者粘贴一段混乱的错误日志,需要生成可直接提交的 GitHub 问题。
- 测试人员提供语音转写或零散笔记,需要补全结构化的复现步骤和影响说明。
- 支持工程师附上截图或 GIF,需要在问题报告中保留视觉证据引用。
- 团队希望把服务中断、功能受损和界面问题统一成相同的 Markdown 格式。
- 包含项目名、用户 ID 等敏感信息的故障记录需要先替换为安全占位符。
优缺点一览
- 固定模板覆盖环境、复现、行为差异、错误详情和影响。
- 支持从语音转写、错误日志和截图说明中提取结构。
- 包含严重程度规则和敏感数据占位符指导。
- 支持在 Markdown 中引用截图和 GIF。
- 来源没有展示该技能的专门测试场景或测试结果。
- 技能只描述 Markdown 文件输出,没有证据表明它会直接创建远程 GitHub Issue。
- 需要可写入本地 /issues/ 目录的运行环境。
- 缺失信息的补全依赖对话上下文或记忆,可能需要人工复核。
如何安装
在项目中运行:
npx skills add microsoft/skills
在安装向导中选择 github-issue-creator。技能会安装到所选 Agent 的目录,例如 GitHub Copilot 使用的 .github/skills/。也可以从仓库中复制 .github/skills/github-issue-creator/ 目录。
如何使用
向 Agent 提供原始故障信息,并明确要求整理为 GitHub Issue,例如:“请把以下错误日志和复现经过整理成 GitHub 问题报告:……”。生成的问题应保存为 /issues/YYYY-MM-DD-short-description.md。来源没有说明具体的文件创建命令或远程 GitHub 提交流程。