managing-github-issues

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Managing GitHub Issues

管理GitHub Issues

Use this skill when starting a session to find work, creating/triaging issues, or completing work and updating issue status.

本技能适用于开始工作会话、寻找任务、创建/分类问题，或是完成工作并更新问题状态时使用。

Finding Work

寻找任务

Start of session — check what's ready:

gh issue list --label priority:high --label status:ready
gh issue list --label priority:high
gh issue list --milestone "v0.1.0" --state open

会话开始时——查看待处理的就绪任务：

gh issue list --label priority:high --label status:ready
gh issue list --label priority:high
gh issue list --milestone "v0.1.0" --state open

Creating Issues

创建问题

Use structured bodies with Summary + Acceptance Criteria checklist:

gh issue create --title "Add X component" \
  --body "## Summary\n\nBrief description.\n\n## Acceptance Criteria\n\n- [ ] Criterion 1\n- [ ] Criterion 2" \
  --label "type:feature,area:components,priority:medium"

使用包含摘要+验收标准清单的结构化内容：

gh issue create --title "Add X component" \
  --body "## Summary\n\nBrief description.\n\n## Acceptance Criteria\n\n- [ ] Criterion 1\n- [ ] Criterion 2" \
  --label "type:feature,area:components,priority:medium"

Working on Issues

处理问题

Reference
```
#N
```
in commit messages
Use
```
Fixes #N
```
in PR descriptions to auto-close

在提交信息中引用
```
#N
```
在PR描述中使用
```
Fixes #N
```
以自动关闭问题

Completing Work

完成工作

Close issues via PR merge (preferred) or
```
gh issue close N
```
After closing, check for newly unblocked work

通过PR合并（推荐方式）或
```
gh issue close N
```
关闭问题
关闭后，检查是否有新的解锁任务

Label Taxonomy

标签分类体系

Category	Labels
Type	`type:feature` , `type:bug` , `type:task`
Priority	`priority:high` (do next), `priority:medium` (soon), `priority:low` (backlog)
Area	`area:components` , `area:tokens` , `area:infra` , `area:docs` , `area:storybook`
Status	`status:ready` (can start), `status:needs-design` (needs decisions)
OSS	`good first issue`

类别	标签
类型	`type:feature` , `type:bug` , `type:task`
优先级	`priority:high` （优先处理）, `priority:medium` （尽快处理）, `priority:low` （待办积压）
领域	`area:components` , `area:tokens` , `area:infra` , `area:docs` , `area:storybook`
状态	`status:ready` （可开始）, `status:needs-design` （需决策）
开源项目	`good first issue`