mcpField
G
github

github

github.com/johnlindquist开发2638 次安装45 周前更新
代码仓库

关于 github

github 是使用 `gh` 命令行管理 GitHub 问题的技能，适用于处理问题工作流的团队。它支持创建、筛选、查看、编辑、分派和关闭问题，并要求执行前先读取对应操作的参考文件。

主要功能

  1. 01根据对话内容创建问题
  2. 02列出并筛选问题
  3. 03查看问题详情和评论
  4. 04修改标题、正文、标签和负责人
  5. 05分派及关闭问题

适用场景

  1. 01将报告的缺陷整理为问题
  2. 02按状态或标签进行问题分流
  3. 03在冲刺规划中分派问题
  4. 04添加评论后关闭已解决问题

安装

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

$npx skills add https://github.com/johnlindquist/claude --skill github

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

ASSIGN_ISSUE.md
CLOSE_ISSUE.md
CREATE_ISSUE.md
LIST_ISSUES.md
UPDATE_ISSUE.md
VIEW_ISSUE.md

详细介绍

GitHub Issues 管理器

使用 gh CLI 工具完成完整的 GitHub issue 管理。本 Skill 提供创建、查看、更新和管理 GitHub issue 的全面能力。

能力

  1. 创建 issue - 结合对话中的上下文创建新的 GitHub issue
  2. 列出 issue - 按状态、标签、负责人查看和筛选 issue
  3. 查看 issue - 显示 issue 的完整详情，包括评论
  4. 更新 issue - 修改标题、正文、标签和负责人
  5. 关闭 issue - 关闭 issue，可选择添加关闭评论
  6. 分配 issue - 将 issue 分配给团队成员

快速参考

有关每项操作的详细说明，请参阅：

常见工作流

Bug 报告工作流
  1. 用户在对话中报告 bug
  2. 使用 /create-issue 创建 issue，或让我创建一个
  3. 结合我们讨论的上下文创建 issue
  4. 分配给合适的团队成员
  5. 添加标签（bug、priority 等）
Issue 分类工作流
  1. 使用筛选条件列出未关闭的 issue
  2. 查看特定 issue 的详情
  3. 更新标签和分配
  4. 关闭已解决的 issue 并更新状态
迭代规划工作流
  1. 按标签或里程碑列出 issue
  2. 将 issue 分配给团队成员
  3. 更新优先级和估点
  4. 通过状态更新跟踪进度

关键说明

必需：在执行任何 GitHub issue 操作之前，你必须使用 Read 工具加载相关的参考文件。这些参考文件包含本概述中未提供的关键命令模式、参数和工作流。

当用户要求处理 GitHub issue 时：

  1. 确定操作：他们想要执行的操作（创建、列出、查看、更新、关闭、分配）
  2. 强制要求：在执行任何命令之前，使用 Read 工具加载相关的参考文件：
    • 创建 issue → 先阅读 CREATE_ISSUE.md
    • 列出 issue → 先阅读 LIST_ISSUES.md
    • 查看 issue → 先阅读 VIEW_ISSUE.md
    • 更新 issue → 先阅读 UPDATE_ISSUE.md
    • 关闭 issue → 先阅读 CLOSE_ISSUE.md
    • 分配 issue → 先阅读 ASSIGN_ISSUE.md
  3. 执行 gh CLI 命令，遵循已加载参考文件中的确切模式
  4. 使用临时文件存放 issue 正文，以避免 markdown 冲突（如参考文件中所指定）
  5. 确认操作并显示结果

不要在未先加载并阅读相关参考文档的情况下尝试执行 GitHub issue 命令。

最佳实践

  • 始终使用 --body-file 存放 issue 正文，以避免 shell 转义问题
  • 在临时文件名中使用 $$ 以避免冲突（会展开为进程 ID）
  • 格式化 issue 正文，采用正确的 markdown 结构
  • 包含上下文：创建 issue 时纳入对话中的上下文
  • 清理临时文件：操作完成后清理临时文件
  • 显示 issue URL，方便用户跳转到 GitHub

示例

根据上下文创建 issue
User: "I found a bug where login fails with special characters"
Me: *Creates issue with details from conversation*
列出并筛选 issue
User: "Show me all open bugs assigned to alice"
Me: gh issue list --state open --label bug --assignee alice
更新 issue
User: "Add high-priority label to issue #123"
Me: gh issue edit 123 --add-label "high-priority"
结合上下文关闭
User: "Close issue #456, it was fixed in the last PR"
Me: gh issue close 456 --comment "Fixed in PR #789"

评论

支持 Markdown