Issues 协作
issues、labelling、mentions、reactions。
25 分钟
Issues 协作
Issues 是 GitHub 上的任务与讨论板:bug 报告、功能请求、文档改进都可追踪。与 PR 配合:Closes #N 自动关单。本课对应 git-github 路线图 的 issues、labelling、mentions、reactions。
PR 流程见上一课;组织级看板在 ghg-org;自动化可用 github-actions-essentials。
学习目标
- 写可执行的 Issue(复现步骤、期望/实际)
- 使用 Labels、Assignees、Milestone 分类
- 用
@mention、cross-reference、Reactions 协作
创建有效 Issue
## 环境
- OS: Windows 11
- Node: 20.x
- 分支: main @ abc1234
## 复现步骤
1. 打开 /tracks/git-github
2. 点击未完成节点
## 期望
跳转到对应课时
## 实际
404
## 截图
(如有)
标题具体:路线图 git-github 节点链接 404,而非 坏了。
Labels 与分类
常见 label 体系(可按仓库自定义):
| Label | 用途 |
|---|---|
| bug | 缺陷 |
| enhancement | 功能增强 |
| good first issue | 新人友好 |
| documentation | 文档 |
| help wanted | 欢迎社区 PR |
# GitHub CLI 创建 issue
gh issue create --title "docs: 补充 ghg-pr 练习说明" --label documentation
gh issue list --label "good first issue"
Mentions 与关联
@username通知用户#123引用本仓 Issueowner/repo#456跨仓引用- PR/Issue 描述写
Closes #123、Fixes #456合并后自动关闭
在 commit message 中同样有效:
git commit -m "fix(roadmap): 修正 git-github 节点 slug
Closes #123"
Reactions 与轻量反馈
👍 👀 🚀 等 emoji 表达「同意 / 在看 / 优先」而不刷屏 comment。Maintainer 可用 reactions 做粗粒度优先级投票。
Issue → PR 工作流
Issue #88 描述需求
→ 评论认领「我来做这个」
→ 分支 feature/88-xxx
→ PR 描述写 Closes #88
→ Merge 后 Issue 自动 Closed
练习
- 在练习仓创建 1 个 bug 型 + 1 个 docs 型 Issue,各加 label