前言¶

在开发和运维过程中，把调查结果、漏洞报告、回归问题或功能需求转化为一份结构清晰、信息完整的 GitHub Issue，往往需要反复调整。现有做法通常是手动编写模板，或者依赖团队内部的约定，容易遗漏关键信息，导致 issue 提交质量参差不齐。Github Issue Writer 旨在针对这类场景提供结构化、可复现的写作流程。

这是什么¶

Github Issue Writer 是一个基于通用 SKILL.md 格式的 Skill，由社区用户 @user_4bc11d61/issue-writer 维护，版本 1.0.0。它的核心定位是：在起草、重组、审查或提交 GitHub Issue 时，根据问题类型选择合适的 Issue 结构，并确保证据、影响、建议和验收标准与 Issue 类型相匹配。

核心功能¶

• 根据问题类型选择 Issue 模板：支持调查结果、缺陷、安全审查、回归、功能请求、技术债务等场景。
• 结构化内容组织：在 Issue 中包含证据、影响范围、建议措施和验收标准等关键模块。
• 适配不同 Issue 类型：针对每种类型调整内容侧重和格式。

安装与启用¶

Skill 依赖 SkillHub 平台。安装命令如下：

skillhub install user_4bc11d61/issue-writer

安装完成后，在支持的客户端（如 Cursor、Codex CLI、Claude Code）中启用 Skill，即可在对话中使用。

典型用法¶

以提交一个缺陷 Issue 为例，对话流程如下：

1. 告知 Skill 场景：缺陷、已复现、影响线上环境。
2. Skill 根据缺陷类型，生成包含以下模块的 Issue 文本：
   - 标题
   - 严重程度
   - 环境信息（平台、版本、复现步骤）
   - 证据（日志、截图、堆栈）
   - 影响范围
   - 建议修复方案
   - 验收标准
3. 在对话中确认或补充内容后，将 Issue 文本复制到 GitHub。

适用场景与注意¶

适用场景：需要规范提交 GitHub Issue 的团队或个人，包括但不限于：
- 调查发现整理
- 缺陷与安全审查报告
- 回归问题
- 功能请求
- 技术债务记录

注意：Skill 依赖 SkillHub 平台，需确保网络可访问；部分客户端可能需要单独启用 Skill 才能生效。

结尾¶

Github Issue Writer 通过结构化模板与类型适配，帮助开发者把调查与审查结果快速转化为高质量的 GitHub Issue。官方地址：https://www.skillhub.cn/skills/user_4bc11d61/issue-writer