Github Issues

通过 gh 或 REST 创建、分类、标记、分配 GitHub Issues。

技能元数据


来源	内置（默认安装）
路径	`skills/github/github-issues`
版本	`1.1.0`
作者	赫尔墨斯智能体
许可证	MIT
平台	linux, macos, windows
标签	`GitHub`, `Issues`, `项目管理`, `缺陷跟踪`, `分类`
相关技能	`github-auth`, `github-pr-workflow`

信息

以下是 Hermes 在此技能被触发时加载的完整技能定义。这是技能激活时智能体所看到的指令。

GitHub 问题管理

创建、搜索、分类处理和管理 GitHub 问题。每个部分都先展示 gh 命令，然后是 curl 的备用方案。

前置条件

已通过 GitHub 认证（参见 github-auth 技能）
位于一个具有 GitHub 远程的 git 仓库内，或明确指定仓库

设置

if command -v gh &>/dev/null && gh auth status &>/dev/null; then
  AUTH="gh"
else
  AUTH="git"
  if [ -z "$GITHUB_TOKEN" ]; then
    if [ -f ~/.hermes/.env ] && grep -q "^GITHUB_TOKEN=" ~/.hermes/.env; then
      GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" ~/.hermes/.env | head -1 | cut -d= -f2 | tr -d '\n\r')
    elif grep -q "github.com" ~/.git-credentials 2>/dev/null; then
      GITHUB_TOKEN=$(grep "github.com" ~/.git-credentials 2>/dev/null | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|')
    fi
  fi
fi

REMOTE_URL=$(git remote get-url origin)
OWNER_REPO=$(echo "$REMOTE_URL" | sed -E 's|.*github\.com[:/]||; s|\.git$||')
OWNER=$(echo "$OWNER_REPO" | cut -d/ -f1)
REPO=$(echo "$OWNER_REPO" | cut -d/ -f2)

1. 查看问题

使用 gh:

gh issue list
gh issue list --state open --label "bug"
gh issue list --assignee @me
gh issue list --search "authentication error" --state all
gh issue view 42

使用 curl:

# 列出未解决的问题
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/repos/$OWNER/$REPO/issues?state=open&per_page=20" \
  | python3 -c "
import sys, json
for i in json.load(sys.stdin):
    if 'pull_request' not in i:  # GitHub API 在 /issues 端点也会返回 PR
        labels = ', '.join(l['name'] for l in i['labels'])
        print(f\"#{i['number']:5}  {i['state']:6}  {labels:30}  {i['title']}\")"

# 按标签筛选
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/repos/$OWNER/$REPO/issues?state=open&labels=bug&per_page=20" \
  | python3 -c "
import sys, json
for i in json.load(sys.stdin):
    if 'pull_request' not in i:
        print(f\"#{i['number']}  {i['title']}\")"

# 查看特定问题
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42 \
  | python3 -c "
import sys, json
i = json.load(sys.stdin)
labels = ', '.join(l['name'] for l in i['labels'])
assignees = ', '.join(a['login'] for a in i['assignees'])
print(f\"#{i['number']}: {i['title']}\")
print(f\"状态: {i['state']}  标签: {labels}  受指派人: {assignees}\")
print(f\"作者: {i['user']['login']}  创建时间: {i['created_at']}\")
print(f\"\n{i['body']}\")"

# 搜索问题
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/search/issues?q=authentication+error+repo:$OWNER/$REPO" \
  | python3 -c "
import sys, json
for i in json.load(sys.stdin)['items']:
    print(f\"#{i['number']}  {i['state']:6}  {i['title']}\")"

2. 创建问题

使用 gh:

gh issue create \
  --title "登录重定向忽略了 ?next= 参数" \
  --body "## 描述
登录后，用户总是被重定向到 /dashboard。

## 重现步骤
1. 在未登录状态下导航到 /settings
2. 被重定向到 /login?next=/settings
3. 登录
4. 实际：重定向到 /dashboard（应该跳转到 /settings）

## 预期行为
应遵守 ?next= 查询参数。" \
  --label "bug,backend" \
  --assignee "username"

使用 curl:

curl -s -X POST \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues \
  -d '{
    "title": "登录重定向忽略了 ?next= 参数",
    "body": "## 描述\n登录后，用户总是被重定向到 /dashboard。\n\n## 重现步骤\n1. 在未登录状态下导航到 /settings\n2. 被重定向到 /login?next=/settings\n3. 登录\n4. 实际：重定向到 /dashboard\n\n## 预期行为\n应遵守 ?next= 查询参数。",
    "labels": ["bug", "backend"],
    "assignees": ["username"]
  }'

错误报告模板

## 错误描述
<发生了什么>

## 重现步骤
1. <步骤>
2. <步骤>

## 预期行为
<应该发生什么>

## 实际行为
<实际发生了什么>

## 环境
- 操作系统: <操作系统>
- 版本: <版本>

功能请求模板

## 功能描述
<你想要什么>

## 动机
<为什么有用>

## 建议解决方案
<如何实现>

## 考虑的替代方案
<其他方法>

3. 管理问题

添加/移除标签

使用 gh:

gh issue edit 42 --add-label "priority:high,bug"
gh issue edit 42 --remove-label "needs-triage"

使用 curl:

# 添加标签
curl -s -X POST \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42/labels \
  -d '{"labels": ["priority:high", "bug"]}'

# 移除标签
curl -s -X DELETE \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42/labels/needs-triage

# 列出仓库中可用的标签
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/labels \
  | python3 -c "
import sys, json
for l in json.load(sys.stdin):
    print(f\"  {l['name']:30}  {l.get('description', '')}\")"

指派

使用 gh:

gh issue edit 42 --add-assignee username
gh issue edit 42 --add-assignee @me

使用 curl:

curl -s -X POST \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42/assignees \
  -d '{"assignees": ["username"]}'

使用 gh:

gh issue comment 42 --body "已调查 —— 根本原因在认证中间件。正在修复。"

使用 curl:

curl -s -X POST \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42/comments \
  -d '{"body": "已调查 —— 根本原因在认证中间件。正在修复。"}'

关闭与重新打开

使用 gh:

gh issue close 42
gh issue close 42 --reason "not planned"
gh issue reopen 42

使用 curl:

# 关闭
curl -s -X PATCH \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42 \
  -d '{"state": "closed", "state_reason": "completed"}'

# 重新打开
curl -s -X PATCH \
  -H "Authorization: token $GITHUB_TOKEN" \
  https://api.github.com/repos/$OWNER/$REPO/issues/42 \
  -d '{"state": "open"}'

将问题关联到 PR

当 PR 合并时，如果其正文包含正确的关键词，相关问题会自动关闭：

Closes #42
Fixes #42
Resolves #42

要从一个问题创建分支：

使用 gh:

gh issue develop 42 --checkout

使用 git (手动等效操作):

git checkout main && git pull origin main
git checkout -b fix/issue-42-login-redirect

4. 问题分类处理工作流

当被要求对问题进行分类处理时：

列出未分类的问题：

# 使用 gh
gh issue list --label "needs-triage" --state open

# 使用 curl
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/repos/$OWNER/$REPO/issues?labels=needs-triage&state=open" \
  | python3 -c "
import sys, json
for i in json.load(sys.stdin):
    if 'pull_request' not in i:
        print(f\"#{i['number']}  {i['title']}\")"

阅读并分类 每个问题（查看详情，理解错误/功能）
应用标签和优先级（参见上面的管理问题部分）
指派（如果负责人明确）
添加分类备注（如果需要）

5. 批量操作

对于批量操作，可以结合 API 调用和 shell 脚本：

使用 gh:

# 关闭所有带有特定标签的问题
gh issue list --label "wontfix" --json number --jq '.[].number' | \
  xargs -I {} gh issue close {} --reason "not planned"

使用 curl:

# 列出带有特定标签的问题编号，然后逐一关闭
curl -s \
  -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/repos/$OWNER/$REPO/issues?labels=wontfix&state=open" \
  | python3 -c "import sys,json; [print(i['number']) for i in json.load(sys.stdin)]" \
  | while read num; do
    curl -s -X PATCH \
      -H "Authorization: token $GITHUB_TOKEN" \
      https://api.github.com/repos/$OWNER/$REPO/issues/$num \
      -d '{"state": "closed", "state_reason": "not_planned"}'
    echo "已关闭 #$num"
  done

快速参考表

操作	gh	curl 端点
列出问题	`gh issue list`	`GET /repos/{o}/{r}/issues`
查看问题	`gh issue view N`	`GET /repos/{o}/{r}/issues/N`
创建问题	`gh issue create ...`	`POST /repos/{o}/{r}/issues`
添加标签	`gh issue edit N --add-label ...`	`POST /repos/{o}/{r}/issues/N/labels`
指派	`gh issue edit N --add-assignee ...`	`POST /repos/{o}/{r}/issues/N/assignees`
评论	`gh issue comment N --body ...`	`POST /repos/{o}/{r}/issues/N/comments`
关闭	`gh issue close N`	`PATCH /repos/{o}/{r}/issues/N`
搜索	`gh issue list --search "..."`	`GET /search/issues?q=...`

技能元数据​

GitHub 问题管理

前置条件​

设置​

1. 查看问题​

2. 创建问题​

错误报告模板​

功能请求模板​

3. 管理问题​

添加/移除标签​

指派​

评论​

关闭与重新打开​

将问题关联到 PR​

4. 问题分类处理工作流​

5. 批量操作​

快速参考表​

技能元数据

前置条件

设置

1. 查看问题

2. 创建问题

错误报告模板

功能请求模板

3. 管理问题

添加/移除标签

指派

评论

关闭与重新打开

将问题关联到 PR

4. 问题分类处理工作流

5. 批量操作

快速参考表