github-issues by github/awesome-copilot
npx skills add https://github.com/github/awesome-copilot --skill github-issues使用 @modelcontextprotocol/server-github MCP 服务器管理 GitHub Issues。
| 工具 | 用途 |
|---|---|
mcp__github__issue_read | 读取 Issue 详情、子 Issue、评论、标签(方法:get、get_comments、get_sub_issues、get_labels) |
mcp__github__list_issues | 按状态、标签、日期列出和筛选仓库 Issue |
mcp__github__search_issues | 使用 GitHub 搜索语法跨仓库搜索 Issue |
mcp__github__projects_list |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 列出项目、项目字段、项目项、状态更新 |
mcp__github__projects_get | 获取项目、字段、项目项或状态更新的详细信息 |
mcp__github__projects_write | 添加/更新/删除项目项,创建状态更新 |
MCP 服务器目前不支持创建、更新 Issue 或添加评论。请使用 gh api 进行这些操作。
| 操作 | 命令 |
|---|---|
| 创建 Issue | gh api repos/{owner}/{repo}/issues -X POST -f title=... -f body=... |
| 更新 Issue | gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f title=... -f state=... |
| 添加评论 | gh api repos/{owner}/{repo}/issues/{number}/comments -X POST -f body=... |
| 关闭 Issue | gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f state=closed |
| 设置 Issue 类型 | 在创建调用中包含 -f type=Bug(仅限 REST API,gh issue create CLI 不支持) |
注意: gh issue create 可用于基本的 Issue 创建,但不支持 --type 标志。需要设置 Issue 类型时,请使用 gh api。
gh api 进行写入使用 gh api 创建 Issue。这支持包括 Issue 类型在内的所有参数。
gh api repos/{owner}/{repo}/issues \
-X POST \
-f title="Issue title" \
-f body="Issue body in markdown" \
-f type="Bug" \
--jq '{number, html_url}'
向 gh api 调用添加以下任意标志:
-f type="Bug" # Issue 类型(Bug、Feature、Task、Epic 等)
-f labels[]="bug" # 标签(可重复添加多个)
-f assignees[]="username" # 负责人(可重复添加多个)
-f milestone=1 # 里程碑编号
Issue 类型是组织级别的元数据。要发现可用的类型,请使用:
gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'
分类时优先使用 Issue 类型而非标签。 当有可用的 Issue 类型(例如 Bug、Feature、Task)时,请使用 type 参数,而不是应用等效的标签如 bug 或 enhancement。Issue 类型是 GitHub 上对 Issue 进行分类的规范方式。仅当组织未配置 Issue 类型时,才回退使用标签。
[Bug]启用 SSO 时登录失败(配合 type=Bug)添加深色模式支持(配合 type=Feature)为认证模块添加单元测试(配合 type=Task)始终使用 references/templates.md 中的模板。根据 Issue 类型选择:
| 用户请求 | 模板 |
|---|---|
| Bug、error、broken、not working | Bug Report |
| Feature、enhancement、add、new | Feature Request |
| Task、chore、refactor、update | Task |
使用 gh api 并指定 PATCH 方法:
gh api repos/{owner}/{repo}/issues/{number} \
-X PATCH \
-f state=closed \
-f title="Updated title" \
--jq '{number, html_url}'
仅包含您想要更改的字段。可用字段:title、body、state(open/closed)、labels、assignees、milestone。
用户:"创建一个 Bug Issue - 使用 SSO 时登录页面崩溃"
操作:
gh api repos/github/awesome-copilot/issues \
-X POST \
-f title="Login page crashes when using SSO" \
-f type="Bug" \
-f body="## Description
The login page crashes when users attempt to authenticate using SSO.
## Steps to Reproduce
1. Navigate to login page
2. Click 'Sign in with SSO'
3. Page crashes
## Expected Behavior
SSO authentication should complete and redirect to dashboard.
## Actual Behavior
Page becomes unresponsive and displays error." \
--jq '{number, html_url}'
用户:"创建一个高优先级的深色模式功能请求"
操作:
gh api repos/github/awesome-copilot/issues \
-X POST \
-f title="Add dark mode support" \
-f type="Feature" \
-f labels[]="high-priority" \
-f body="## Summary
Add dark mode theme option for improved user experience and accessibility.
## Motivation
- Reduces eye strain in low-light environments
- Increasingly expected by users
## Proposed Solution
Implement theme toggle with system preference detection.
## Acceptance Criteria
- [ ] Toggle switch in settings
- [ ] Persists user preference
- [ ] Respects system preference by default" \
--jq '{number, html_url}'
适用时使用这些标准标签:
| 标签 | 用于 |
|---|---|
bug | 某些功能无法正常工作 |
enhancement | 新功能或改进 |
documentation | 文档更新 |
good first issue | 适合新贡献者 |
help wanted | 需要额外关注 |
question | 需要更多信息 |
wontfix | 将不会处理 |
duplicate | 已存在 |
high-priority | 紧急问题 |
Related to #123以下功能需要超出基本 MCP 工具的 REST 或 GraphQL API。每个功能都在其自己的参考文件中记录,以便代理仅加载所需的知识。
| 功能 | 何时使用 | 参考 |
|---|---|---|
| 高级搜索 | 包含布尔逻辑、日期范围、跨仓库搜索、Issue 字段过滤器(field.name:value)的复杂查询 | references/search.md |
| 子 Issue 与父 Issue | 将工作分解为分层任务 | references/sub-issues.md |
| Issue 依赖关系 | 跟踪被阻塞/阻塞关系 | references/dependencies.md |
| Issue 类型(高级) | 超出 MCP list_issue_types / type 参数的 GraphQL 操作 | references/issue-types.md |
| 项目 V2 | 项目看板、进度报告、字段管理 | references/projects.md |
| Issue 字段 | 自定义元数据:日期、优先级、文本、数字(私有预览) | references/issue-fields.md |
| Issue 中的图片 | 通过 CLI 在 Issue 正文和评论中嵌入图片 | references/images.md |
每周安装量
8.3K
仓库
GitHub 星标数
26.9K
首次出现
2026 年 1 月 20 日
安全审计
安装于
opencode8.1K
github-copilot8.1K
codex8.1K
gemini-cli8.1K
kimi-cli8.0K
cursor8.0K
Manage GitHub issues using the @modelcontextprotocol/server-github MCP server.
| Tool | Purpose |
|---|---|
mcp__github__issue_read | Read issue details, sub-issues, comments, labels (methods: get, get_comments, get_sub_issues, get_labels) |
mcp__github__list_issues | List and filter repository issues by state, labels, date |
mcp__github__search_issues | Search issues across repos using GitHub search syntax |
mcp__github__projects_list | List projects, project fields, project items, status updates |
mcp__github__projects_get | Get details of a project, field, item, or status update |
mcp__github__projects_write | Add/update/delete project items, create status updates |
The MCP server does not currently support creating, updating, or commenting on issues. Use gh api for these operations.
| Operation | Command |
|---|---|
| Create issue | gh api repos/{owner}/{repo}/issues -X POST -f title=... -f body=... |
| Update issue | gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f title=... -f state=... |
| Add comment | gh api repos/{owner}/{repo}/issues/{number}/comments -X POST -f body=... |
| Close issue | gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f state=closed |
| Set issue type | Include -f type=Bug in the create call (REST API only, not supported by CLI) |
Note: gh issue create works for basic issue creation but does not support the --type flag. Use gh api when you need to set issue types.
gh api for writesUse gh api to create issues. This supports all parameters including issue types.
gh api repos/{owner}/{repo}/issues \
-X POST \
-f title="Issue title" \
-f body="Issue body in markdown" \
-f type="Bug" \
--jq '{number, html_url}'
Add any of these flags to the gh api call:
-f type="Bug" # Issue type (Bug, Feature, Task, Epic, etc.)
-f labels[]="bug" # Labels (repeat for multiple)
-f assignees[]="username" # Assignees (repeat for multiple)
-f milestone=1 # Milestone number
Issue types are organization-level metadata. To discover available types, use:
gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'
Prefer issue types over labels for categorization. When issue types are available (e.g., Bug, Feature, Task), use the type parameter instead of applying equivalent labels like bug or enhancement. Issue types are the canonical way to categorize issues on GitHub. Only fall back to labels when the org has no issue types configured.
[Bug]Login fails with SSO enabled (with type=Bug)Add dark mode support (with type=Feature)Add unit tests for auth module (with type=Task)Always use the templates in references/templates.md. Choose based on issue type:
| User Request | Template |
|---|---|
| Bug, error, broken, not working | Bug Report |
| Feature, enhancement, add, new | Feature Request |
| Task, chore, refactor, update | Task |
Use gh api with PATCH:
gh api repos/{owner}/{repo}/issues/{number} \
-X PATCH \
-f state=closed \
-f title="Updated title" \
--jq '{number, html_url}'
Only include fields you want to change. Available fields: title, body, state (open/closed), labels, assignees, milestone.
User : "Create a bug issue - the login page crashes when using SSO"
Action :
gh api repos/github/awesome-copilot/issues \
-X POST \
-f title="Login page crashes when using SSO" \
-f type="Bug" \
-f body="## Description
The login page crashes when users attempt to authenticate using SSO.
## Steps to Reproduce
1. Navigate to login page
2. Click 'Sign in with SSO'
3. Page crashes
## Expected Behavior
SSO authentication should complete and redirect to dashboard.
## Actual Behavior
Page becomes unresponsive and displays error." \
--jq '{number, html_url}'
User : "Create a feature request for dark mode with high priority"
Action :
gh api repos/github/awesome-copilot/issues \
-X POST \
-f title="Add dark mode support" \
-f type="Feature" \
-f labels[]="high-priority" \
-f body="## Summary
Add dark mode theme option for improved user experience and accessibility.
## Motivation
- Reduces eye strain in low-light environments
- Increasingly expected by users
## Proposed Solution
Implement theme toggle with system preference detection.
## Acceptance Criteria
- [ ] Toggle switch in settings
- [ ] Persists user preference
- [ ] Respects system preference by default" \
--jq '{number, html_url}'
Use these standard labels when applicable:
| Label | Use For |
|---|---|
bug | Something isn't working |
enhancement | New feature or improvement |
documentation | Documentation updates |
good first issue | Good for newcomers |
help wanted | Extra attention needed |
question | Further information requested |
Related to #123The following features require REST or GraphQL APIs beyond the basic MCP tools. Each is documented in its own reference file so the agent only loads the knowledge it needs.
| Capability | When to use | Reference |
|---|---|---|
| Advanced search | Complex queries with boolean logic, date ranges, cross-repo search, issue field filters (field.name:value) | references/search.md |
| Sub-issues & parent issues | Breaking work into hierarchical tasks | references/sub-issues.md |
| Issue dependencies | Tracking blocked-by / blocking relationships | references/dependencies.md |
| Issue types (advanced) | GraphQL operations beyond MCP list_issue_types / type param |
Weekly Installs
8.3K
Repository
GitHub Stars
26.9K
First Seen
Jan 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
opencode8.1K
github-copilot8.1K
codex8.1K
gemini-cli8.1K
kimi-cli8.0K
cursor8.0K
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
102,200 周安装
gh issue createwontfix | Will not be addressed |
duplicate | Already exists |
high-priority | Urgent issues |
| references/issue-types.md |
| Projects V2 | Project boards, progress reports, field management | references/projects.md |
| Issue fields | Custom metadata: dates, priority, text, numbers (private preview) | references/issue-fields.md |
| Images in issues | Embedding images in issue bodies and comments via CLI | references/images.md |