mcpField
I
issue-reporting

issue-reporting

github.com/manojbajaj95测试与质量109111 次安装6 周前更新
代码仓库

关于 issue-reporting

面向 Claude 的 GTM 技能问题报告 Skill，帮助整理故障现象、项目背景并生成 GitHub 问题报告；专注于报告，不负责修复。

主要功能

  1. 01收集提示词、输出和预期行为
  2. 02检查项目背景与插件版本
  3. 03归类常见技能问题
  4. 04生成 GitHub 问题报告

适用场景

  1. 01报告错误或有害的技能建议
  2. 02诊断技能未能触发的情况
  3. 03说明输出未应用品牌背景

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/manojbajaj95/claude-gtm-plugin --skill issue-reporting

安装后在 Claude Code 中输入/issue-reporting确认已加载。

详细介绍

问题报告

工作区上下文

在提问前，先阅读引导上下文：strategy/brand.md，了解品牌、受众、产品、渠道、工具、约束和指标；about/me.md，了解个人表达风格；content/ideas.md 和 content/calendar.md，了解内容规划。仅在必要时，将旧版产品营销上下文文件作为备用。将生成的草稿保存到 content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md，并将长期有效的经验反馈到 strategy/brand.md、about/me.md 或 content/ideas.md。

操作约定

此技能在其前置信息范围内独立运行：使用本地说明、参考资料、脚本和素材作为操作指南；只询问缺失的任务专属信息；将超出范围的工作交接给相关技能；并提供可执行的产物、决策、计划、草稿或诊断结果。

帮助用户清晰、完整地报告 GTM 技能的问题，以便维护者快速修复。

此技能的触发时机

  • 用户表示某个技能给出了错误或有害的建议
  • 用户表示某个技能在应该触发时没有触发
  • 用户表示系统没有应用其品牌上下文
  • 用户表示输出格式错误或出乎意料
  • 用户想要报告错误或提交问题
  • 用户表示某个技能“出了问题”

第 1 步 — 确认问题

询问用户出了什么问题。确定以下信息：

  1. 哪个技能 — 获取确切的技能名称（例如 seo-and-aeo-strategy、copywriting-core）
  2. 用户提出了什么要求 — 用户给 Claude 的确切提示词或任务
  3. 实际发生了什么 — 实际输出或行为
  4. 用户预期是什么 — 原本应该发生什么

如果用户描述模糊（例如“它给了糟糕的建议”），具体询问错误之处及原因。

第 2 步 — 收集上下文

检查用户的项目，查找有助于诊断问题的上下文：

上下文文件

检查以下文件是否存在，并记录其状态：

  • strategy/brand.md — 品牌定位、信息传达、受众
  • about/me.md — 个人表达风格、写作风格
  • CLAUDE.md — AI 指令

上下文文件缺失是“建议错误”问题最常见的原因。如果缺少 strategy/brand.md 或 about/me.md，请告诉用户：

“由于品牌上下文文件缺失，该技能可能给出了通用建议。运行 /bootstrap 进行设置。如果设置后该技能仍给出错误建议，那就是真正值得报告的错误。”

插件版本

检查 .claude-plugin/plugin.json 中的当前版本号。

安装方式

询问用户如何安装插件（Claude Code、Cowork、Skills CLI、git clone、submodule）。

第 3 步 — 分类问题

将问题归入以下类型之一：

类型描述常见原因
建议错误技能给出了不正确或有害的建议框架过时、领域假设错误
未触发技能应该触发但没有触发描述不匹配、缺少触发短语
误触发技能在不该触发时触发了描述范围过宽
上下文缺失输出未应用品牌/语气上下文文件缺失或未读取
格式错误输出结构不正确技能模板问题
崩溃/错误技能执行中途失败技能中的语法错误、参考路径错误

第 4 步 — 生成问题报告

使用错误报告模板编写 GitHub 问题。采用用户可以复制粘贴或点击打开的格式：

直接链接（预填模板）：

https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml

格式化的问题正文（如果用户更愿意手动粘贴）：

**Skill**: [skill-name]
**Type**: [category from Step 3]
**Plugin Version**: [version]
**Installation**: [method]

### What I asked
[exact prompt]

### What happened
[actual output — include relevant excerpt]

### What I expected
[expected behavior]

### Context files present
- [ ] strategy/brand.md
- [ ] about/me.md
- [ ] CLAUDE.md

### Steps to reproduce
1. [step-by-step if applicable]

### Impact
[Critical / High / Medium / Low]

第 5 步 — 提供后续步骤

生成问题报告后：

  1. 提供提交问题的直接链接：https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml
  2. 如果问题由上下文文件缺失导致，建议先运行 /bootstrap
  3. 如果明显是技能错误，鼓励用户提交报告——这有助于改进插件，让所有人受益
  4. 感谢用户报告问题——提交清晰问题的贡献者非常宝贵

重要事项

  • 切勿忽视用户的不满——如果他们认为建议有误，请认真对待
  • 不要尝试自行修复该技能——此技能用于报告问题，而非修补问题
  • 具体描述问题——“无法运行”这类模糊的报告难以处理
  • 尽可能附上实际输出——维护者需要了解出了什么问题

评论

支持 Markdown