1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | github-issue-creator | — |
| 作者/维护者 | Microsoft（microsoft/skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/skills/github-issue-creator | — |
| 许可证 | MIT License（仓库级） | GitHub API |
| GitHub Stars / Forks | 所属合集仓库 2,815★ / 316 forks（该数字属整个合集，不代表本技能自身热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新；本子目录最近一次改动为 2026-04-20 | GitHub API（commits） |
| 安装方式 | npx skills add microsoft/skills 交互式安装向导；或手动 clone 仓库后复制该子目录 |
仓库 README |
2. 功能介绍与亮点
github-issue-creator 是一个纯提示词/模板类技能，把杂乱的原始输入——报错日志、语音转写文字、随手写的现象描述、甚至截图/GIF——转换成结构清晰、可直接提交的 GitHub Issue Markdown。核心是一套固定输出模板，覆盖：
- Summary：一句话概括问题
- Environment / Reproduction Steps / Expected & Actual Behavior：标准复现信息骨架
- Error Details：原始报错文本单独代码块呈现
- Impact：按 Critical/High/Medium/Low 四级自动匹配严重程度
- Visual Evidence：引用用户提供的截图/GIF
亮点：整个技能只有一份 SKILL.md、不带任何脚本或依赖，触发后直接在对话中产出 Markdown（默认建议落盘到仓库 /issues/ 目录），不调用任何外部服务；技能内置两组完整的“输入→输出”示例（语音转写、报错粘贴各一组），降低上手门槛；对涉及敏感信息的字段（项目名、用户 ID 等）会提示用占位符替换，而非原样保留。
3. 适用场景
固定分类：工程效率与代码质量
面向已经在用 Claude Code / Codex 等编程 Agent 的初中级开发者：调试到一半想随手把现象记录成规范 issue、维护开源项目需要统一 issue 格式、或团队内部想减少“标题模糊、复现步骤缺失”的低质量 issue。语音转写、截图粘贴、报错堆栈粘贴均可作为输入。
4. 跨 Agent 兼容性
| Agent | 结论 | 判断依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库 Quick Start 提供的 npx skills add 基于 skills.sh 通用安装器，其官方 Supported Agents 清单为 Claude Code 配置专属路径 .claude/skills/；README 也给出手动软链接示例 |
| Codex | ✅ 原生支持 | 同一安装器为 Codex 配置专属路径 ~/.codex/skills/ |
| OpenClaw | ✅ 原生支持 | 同一安装器为 OpenClaw 配置项目级 skills/ 与全局 ~/.openclaw/skills/ 路径 |
| Hermes Agent | ✅ 原生支持 | 同一安装器为 Hermes Agent 配置项目级 .hermes/skills/ 与全局 ~/.hermes/skills/ 路径 |
技能本体是纯 Markdown 指令，不依赖任何厂商专属运行时或 SDK，手动复制到任意支持 SKILL.md 格式的 Agent 目录同样可用。
5. 推荐理由
调试过程中最容易被跳过的一步就是把“发现问题”变成“一份别人能看懂、能复现的 issue”——这个技能把这层转译工作模板化了：不需要配置、不调用任何外部接口，输入一段语音转写或一截报错就能拿到结构完整的 Markdown，尤其适合把随手记录规范成团队可用的问题报告。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 微软官方仓库出品，但子目录自身仅 3 次提交（其中 1 次为跨技能批量测试覆盖的自动化提交），未见任何独立第三方讨论或专门 PR，证据密度偏薄 |
| 可用性 | 9 | 单文件 SKILL.md，复制或一条安装命令即可用；文档含两组完整输入输出示例；无任何依赖、无需 API Key、无付费项；子目录最近一次改动约 3 个月前 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令/权限范围 | 无任何 shell 命令或脚本，纯 Markdown 指令 |
| ② 运行时联网外发 | 无，产出内容为本地对话输出/建议落盘的 Markdown 文件，不请求任何外部接口 |
| ③ API Key/凭据 | 不需要任何凭据；技能本身还会提示对敏感字段做占位符处理 |
| ④ 可疑指令 | 通读全文（136 行），未发现隐藏指令、混淆代码或提示词注入迹象 |
| ⑤ 作者信誉 | Microsoft 官方账号出品，无刷星或造假迹象 |
| ⑥ License | MIT，仓库根目录明确标注 |
| ⑦ 维护时间 | 子目录约 3 个月前有实质更新，仓库整体近日仍在推送，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 项目 | 出品方 | 运作方式 | 特色 |
|---|---|---|---|
| github-issue-creator（本技能） | Microsoft | 纯提示词模板，不执行任何命令 | 零依赖、零配置；只产出 Markdown，不直接操作 GitHub，风险面最小 |
| skill-issue 中的 github-issue 子技能（个人开发者 enitrat 维护） | 独立开发者 | 配套脚本调用 GitHub CLI（gh），可直接创建/编辑/关联/推送 issue |
覆盖完整 issue 生命周期（创建、子 issue、跨仓库关联、round-trip 推送），功能更全但需要 gh 认证与仓库写权限 |
直接使用 gh issue create 手动整理 |
GitHub 官方 CLI | 命令行手动输入标题与正文 | 无格式模板与严重程度分级，整理耗时全靠人工，无 AI 辅助结构化 |
三者定位不同：追求“零风险、随手转一份规范 issue 草稿”选本技能；需要把 Agent 深度嵌入 issue 全流程管理（子 issue、跨仓库、CLI 直接提交）选 skill-issue 的 github-issue 子技能；只需最基础命令行操作则直接用 gh issue create。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；除微软官方仓库自身的工程提交记录外未见独立讨论。
9. 其他补充
同一 microsoft/skills 仓库的 Core 分组下还有 mcp-builder（构建 MCP Server 的方法论文档）、cloud-solution-architect（Azure 架构评审）等技能，风格一致（均为轻量级、聚焦单一任务的文档型技能），感兴趣的团队可在同一仓库内按需选用。
10. 安装使用方式
方式一（推荐）：
npx skills add microsoft/skills运行后在交互向导中勾选 github-issue-creator，会被安装到当前所用 Agent 的技能目录（如 Claude Code 为 .claude/skills/）。
方式二（手动）：
git clone https://github.com/microsoft/skills.git
cp -r skills/.github/skills/github-issue-creator your-project/.claude/skills/安装后无需重启 Agent，下次对话中粘贴报错信息、语音转写文字或截图并提出“帮我整理成 GitHub issue”等需求即会被自动触发。
11. 注意事项
- 技能默认只生成 Markdown 内容（建议存放到仓库
/issues/目录），并不会自动调用 GitHub API 或 CLI 创建真实 issue，如需真正提交仍需手动执行gh issue create或网页粘贴 - 子目录本身近 3 个月未见新提交，若需要更贴合特定仓库的 issue 模板规范，可结合项目自身
.github/ISSUE_TEMPLATE定制 - 严重程度分级（Critical/High/Medium/Low）为技能内置的通用启发式判断，涉及安全漏洞等场景仍建议人工复核后再对外发布