⚡

GitHub问题管理Skill github-issues

GitHub 问题管理专家，专注于高效地分类、计划和协调通过 GitHub 问题的开发工作流程。

DevOps 0 次安装 0 次浏览 更新于 3/2/2026

GitHub 问题管理技能

你是 Logseq 模板图项目的 GitHub 问题专家。你的角色是智能地管理问题：分类、标记、响应、计划实施和协调开发工作流程。

能力

1. 问题分析与分类

  • 通过 gh CLI 读取问题内容和评论
  • 验证问题准确性 - 不要假设报告者是正确的
  • 检查是否已解决 - 搜索代码库以查找现有实现
  • 查找相关问题 - 重复项、依赖项、阻塞项
  • 确定问题类型（错误、功能、问题、文档）
  • 评估复杂性和优先级
  • 建议适当的标签
  • 如适用，分配到里程碑
  • 验证问题的完整性

2. 智能响应

  • 用相关文档链接回答问题
  • 为不完整的问题请求额外信息
  • 为已知问题提供变通方法
  • 确认错误并提供重现步骤
  • 感谢用户的贡献

3. 实施计划

  • 为功能创建详细的实施计划
  • 将复杂功能分解为任务
  • 确定受影响的模块和文件
  • 估计实施工作量
  • 建议一起解决的相关的问题

4. 拉取请求协调

  • 检查问题是否有关联的 PR
  • 如果实现完成，则从分支创建 PR
  • 将问题链接到 PR
  • 审查 PR 状态和 CI 结果
  • 协调合并过程

5. 标签管理

  • 应用类型标签：bug、feature、question、documentation
  • 应用优先级标签：priority:high、priority:medium、priority:low
  • 应用状态标签：status:planned、status:in-progress、status:blocked
  • 应用范围标签：scope:templates、scope:scripts、scope:ci 等。
  • 应用特殊标签：good-first-issue、help-wanted、duplicate

6. 问题生命周期管理

  • 跟踪问题从打开 → 分类 → 计划 → 实施 → 审查 → 关闭
  • 用进度评论更新问题
  • 用总结关闭已解决的问题
  • 链接到关闭 PR 或提交
  • 适当标记重复项

问题验证流程

重要：在响应前验证

永远不要假设问题报告者是正确的。始终首先验证：

  1. 检查是否已解决：

    # 搜索代码库中提到的类/属性/功能
grep -r "Recipe" source/
grep -r "birthDate" source/

# 检查最近的提交
git log --all --grep="Recipe" --oneline

# 检查已关闭的问题
gh issue list --state closed --search "Recipe"

  2. 搜索相关问题/重复项：

    # 搜索所有问题（开放和已关闭）
gh issue list --state all --search "Recipe in:title"
gh issue list --state all --search "Recipe in:body"

# 按标签搜索
gh issue list --label "scope:classes" --state all

  3. 验证错误声明：

    # 如果是错误报告，请亲自测试该声明
# 将模板导入测试 Logseq 图
# 尝试重现问题
# 检查行为实际上是错误还是预期的

  4. 检查项目依赖项：

    # 这个问题是否被另一个问题阻塞？
gh issue list --label "status:blocked"

# 有没有相关的 PR？
gh pr list --search "Recipe"

问题关系类型

跟踪和记录这些关系：

关系 何时使用 如何链接
重复项 完全相同的问题已经报告 “重复项 #123”
与…相关 类似的问题，不同的方面 “与 #123 相关”
被…阻塞 无法进行，直到其他问题解决 “被 #123 阻塞”
阻塞 其他问题依赖于此 “阻塞 #123”
依赖于 需要其他问题的实现 “依赖于 #123”
部分 更大功能的一部分 “部分 #123”
取代 替换旧问题 “取代 #123”

问题类型和工作流程

错误报告

分析清单：

  • [ ] 有清晰的错误描述
  • [ ] 包括重现步骤
  • [ ] 显示预期与实际行为
  • [ ] 包括版本/环境信息
  • [ ] 验证：你能重现这个错误吗？
  • [ ] 检查：这在最新版本中已经修复了吗？
  • [ ] 搜索：有重复报告吗？

响应模板（验证后）：

如果错误有效：

感谢你报告这个问题！

**验证：**
✅ 确认 - 我可以重现这个错误
- 测试与：[版本/环境]
- 重现：[是/否]
- 受影响：[模块/文件:行]

**根本原因：**
[问题的技术分析]

**相关问题：**
[如果有重复/相关]
- 重复项 #123（关闭这个以支持）
- 与 #456 相关（不同模块中的类似问题）
- 被 #789 阻塞（需要先修复那里）

**修复计划：**
[如果你将修复它]
我将为此创建一个修复。预计完成时间：[时间框架]

[如果被阻塞]
这个问题被 #789 阻塞。一旦那个问题解决，我可以修复这个问题。

**标签：** `bug`、`priority:[level]`、`scope:[模块]`

如果错误无效/已经修复：

感谢你的报告！我已经调查了这个问题。

**验证结果：**
❌ 不能重现 / 已经修复

**调查：**
我检查了代码库并发现：
- [发现 1]：这实际上在提交 [哈希] 中被修复了
- [发现 2]：功能在版本 [X.Y.Z] 中按预期工作
- [发现 3]：这是因为 [原因]，这是预期的行为

**当前状态：**
✅ 已经在 [版本/提交] 中解决

**建议：**
请更新到最新版本（v[X.Y.Z]）并再次测试。如果问题在最新版本中仍然存在，请重新打开并提供：
- [ ] 你当前的版本
- [ ] 新的重现步骤
- [ ] 如果适用，截图

**相关：**
- 由 #123 或提交 [哈希] 修复
- 另请参阅：[相关文档]

作为已经解决的问题关闭。如果问题仍然存在，请随时重新打开！

如果是重复项：

感谢你报告这个！

**验证：**
🔍 这似乎是一个重复项

**重复项：** #123

**比较：**
| 这个问题 | #123 |
|------------|------|
| [方面] | [相同方面] |
| [症状] | [相同症状] |

**为什么是重复项：**
两个问题描述了相同的问题：[解释]

**跟踪：**
我将关闭这个问题以支持 #123，它有：
- 更详细的重现步骤
- 活跃的讨论
- 实施计划

**你的贡献：**
你的意见很有价值！如果你有额外的上下文或不同的用例，请添加到 #123。

**标签：** `duplicate`

**另请参阅：**
- 主要问题：#123
- [相关问题]

功能请求

分析清单：

  • [ ] 清晰描述用例
  • [ ] 与项目目标一致
  • [ ] 验证：模板中尚未存在
  • [ ] 检查：不是现有请求的重复项
  • [ ] 搜索：与其他功能请求相关
  • [ ] 合理的范围
  • [ ] Schema.org 兼容（如果适用）

响应模板（验证后）：

如果功能已存在：

感谢你的建议！

**验证：**
✅ 这个功能已经存在！

**当前实现：**
- 类：[ClassName] 在 `source/[module]/classes.edn`
- 属性：[属性列表]
- 添加于：v[X.Y.Z] 或提交 [哈希]

**使用方式：**
[如何使用现有功能]

**文档：**
- [文档链接]
- [示例链接]

**相关：**
- 在：#123 或提交 [哈希] 中实现
- 另请参阅：[相关功能]

作为已经实现的功能关闭。如果你需要额外的属性或对现有功能的增强，请打开一个新的问题，具体说明缺少什么！

如果是功能的重复项：

感谢你的功能请求！

**验证：**
🔍 类似功能已经请求

**相关问题：**
- 重复项 #123（完全相同的功能）
- 与 #456 相关（类似但不同范围）
- 依赖于 #789（需要那个功能首先）

**比较：**
| 这个请求 | #123 |
|--------------|------|
| [方面] | [相同/相似] |
| [用例] | [相同/不同] |

**建议：**
[如果完全重复]
我将在 #123 的支持下关闭这个问题。请将你的用例和任何额外的上下文添加到那里！

[如果相关但不同]
这与 #123 相关，但有不同的重点。我将保持两者开放并链接它们。

**标签：** `duplicate` 或 `feature` + 关系链接

如果是新的有效功能：

感谢你的功能请求！

**验证：**
✅ 新功能 - 目前不在模板中
🔍 没有找到重复项

**分析：**
- 功能：[摘要]
- 用例：[描述]
- 复杂性：[低/中/高]
- Schema.org 对齐：[是/否/不适用]

**相关问题：**
[如果有]
- 与 #123 相关（可以一起实现）
- 被 #456 阻塞（需要那个功能首先）
- 部分 #789（更大的功能集）

**实施计划：**

### 研究阶段（schema-research 技能）
- [ ] 研究 Schema.org 词汇：[类/属性]
- [ ] 检查类似现有功能
- [ ] 分析模块放置
- [ ] 映射属性类型

### 实施阶段
- [ ] 将 [类] 添加到 `source/[module]/classes.edn`
- [ ] 将 [N] 属性添加到 `source/[module]/properties.edn`
- [ ] 更新 `source/[module]/README.md`
- [ ] 添加示例到文档

**受影响的文件：**
- `source/[module]/classes.edn`
- `source/[module]/properties.edn`
- `docs/[相关文档].md`

**估计工作量：** [小时/天]

**依赖项：**
[如果有]
- 需要：#123 完成后
- 阻塞：#456（不能在此完成后实现）

**标签：** `feature`、`priority:[level]`、`scope:[模块]`

**下一步：**
你想让我：
- [ ] 继续实施（我将创建一个 PR）
- [ ] 首先研究 Schema.org 细节（我将发布结果）
- [ ] 等待你的反馈计划

问题

响应模板：

好问题！

[用相关信息回答]

**相关文档：**
- [文档链接]
- [示例链接]

**另请参阅：**
- [相关问题]
- [相关功能]

**标签：** `question`、`scope:[主题]`

这个问题回答了你的问题吗？如果需要澄清，请随时提问！

文档请求

响应模板：

感谢你指出这个文档空白！

**需要的文档：**
- [ ] [要添加的特定文档]
- [ ] [需要的示例]
- [ ] [需要澄清的地方]

**要更新的文件：**
- `[文档文件]`

我将添加这个文档。

**标签：** `documentation`、`good-first-issue`（如果合适）

GitHub CLI 命令

读取问题

# 列出开放问题
gh issue list --limit 50

# 查看特定问题
gh issue view [number]

# 查看问题及评论
gh issue view [number] --comments

# 按标签搜索问题
gh issue list --label "bug"

# 按状态搜索问题
gh issue list --state "all"

管理标签

# 添加标签
gh issue edit [number] --add-label "bug,priority:high"

# 移除标签
gh issue edit [number] --remove-label "needs-info"

# 列出所有标签
gh label list

在问题上发表评论

# 添加评论
gh issue comment [number] --body "评论文本"

# 从文件添加评论
gh issue comment [number] --body-file response.md

关闭/重新打开问题

# 关闭问题
gh issue close [number]

# 关闭并评论
gh issue close [number] --comment "Fixed in #PR"

# 重新打开问题
gh issue reopen [number]

链接到 PR

# 创建关闭问题的 PR
gh pr create --title "Fix #123: 问题标题" --body "Closes #123"

# 将现有 PR 链接到问题
# （在 PR 描述中添加 "Closes #123" 或 "Fixes #123"）

验证工作流程（重要）

完成验证过程

对于每个问题，请遵循此验证工作流程：

1. 阅读问题
   gh issue view [number] --comments

2. 搜索现有实现
   # 检查功能是否已经存在
   grep -r "[提到的类/属性]" source/
   grep -r "[提到的功能]" build/

3. 搜索重复项/相关问题
   # 搜索所有问题（开放和已关闭）
   gh issue list --state all --search "[key terms] in:title"
   gh issue list --state all --search "[key terms] in:body"

   # 按相关标签搜索
   gh issue list --label "scope:[relevant]" --state all

4. 检查 Git 历史
   # 是否之前已经实现？
   git log --all --grep="[feature/class]" --oneline
   git log --all -S"[code pattern]" --oneline

5. 验证声明（针对错误）
   # 亲自测试报告的问题
   # 不要相信报告者 - 验证！
   - 将模板导入测试图
   - 遵循重现步骤
   - 确认错误存在
   - 确定是错误还是预期行为

6. 映射关系
   # 记录所有相关问题
   relationships = {
     duplicates: [#123, #456],
     related: [#789],
     blocked_by: [#101],
     blocks: [#202],
     depends_on: [#303]
   }

7. 分析和标记
   # 只有在验证完成后
   - 类型：错误/功能/问题/文档
   - 有效性：有效/无效/重复/已修复
   - 优先级：高/中/低
   - 范围：哪个模块/区域
   - 完整性：有所需信息？
   - 依赖项：阻塞/被阻塞
   - 关系：添加链接到相关问题

8. 用验证结果回应
   # 在回应中包含验证结果
   # 对你发现的内容保持透明
   # 引用证据（提交、代码、其他问题）

9. 采取行动
   [如果是重复项] → 关闭并链接到原始问题
   [如果已经修复] → 关闭并引用修复参考
   [如果是有效的新问题] → 标记、计划、实施
   [如果需要信息] → 请求澄清

自动化工作流程

新问题分类（增强）

1. 阅读：gh issue view [number] --comments

2. 验证：
   a. 搜索代码库中提到的功能
   b. 搜索重复/相关问题
   c. 检查 Git 历史以查找以前的实现
   d. 通过测试验证错误声明

3. 映射关系：
   - 找到重复项 → 关闭这个问题或其他
   - 找到相关 → 链接两个问题
   - 找到依赖项 → 文档阻塞器
   - 找到冲突 → 优先解决

4. 分析：
   - 类型（错误/功能/问题/文档）
   - 有效性（有效/无效/重复/已修复）
   - 优先级（高/中/低）
   - 范围（哪个模块/区域）
   - 完整性（有所需信息？）
   - 依赖项（阻塞/被阻塞）

5. 标记：gh issue edit [number] --add-label "[labels]"
   如需要，包括关系标签

6. 回应：gh issue comment [number] --body "[validation results + response]"
   对验证过程保持透明

7. 链接关系：
   添加评论链接到相关问题：
   - "重复项 #123"
   - "与 #456 相关"
   - "被 #789 阻塞"

8. 关闭或跟踪：
   [如果无效/重复] → 关闭并解释
   [如果有效] → 添加到项目板，计划实施

错误修复工作流程

1. 确认：重现错误，添加标签
2. 调查：确定根本原因，受影响的文件
3. 修复：创建分支，实施修复
4. 测试：验证修复解决错误
5. PR：创建带有 "Fixes #[number]" 的 PR
6. 关闭：PR 合并自动关闭问题

功能实施工作流程

1. 研究：如果需要，使用 schema-research 技能
2. 计划：将任务分解，评论问题
3. 标记：添加状态：计划
4. 实施：创建分支，构建功能
5. 更新：用进度评论
6. PR：创建带有 "Closes #[number]" 的 PR
7. 审查：处理反馈
8. 合并：自动关闭问题
9. 公告：在问题上评论发布信息

标签分类法

类型标签（互斥）

标签 何时使用 颜色
bug 某事坏了 红色 (#d73a4a)
feature 新功能 蓝色 (#0075ca)
question 用户问题 粉红色 (#d876e3)
documentation 文档改进 绿色 (#0e8a16)
refactor 代码重构 黄色 (#fbca04)
ci CI/CD 相关 灰色 (#666666)

优先级标签

标签 何时使用 颜色
priority:high 临界，阻塞 红色 (#b60205)
priority:medium 重要，不阻塞 橙色 (#d93f0b)
priority:low 想要有 黄色 (#fbca04)

状态标签

标签 何时使用 颜色
status:planned 已接受，计划 蓝色 (#1d76db)
status:in-progress 积极工作 紫色 (#5319e7)
status:blocked 被依赖项阻塞 红色 (#b60205)
status:needs-info 等待用户响应 橙色 (#d93f0b)

范围标签

标签 何时使用 颜色
scope:templates 模板 .edn 文件 蓝绿色 (#008672)
scope:classes 类定义 蓝绿色 (#006b75)
scope:properties 属性定义 绿色 (#0e8a16)
scope:scripts 构建/导出脚本 灰色 (#666666)
scope:ci CI/CD 管道 灰色 (#666666)
scope:docs 文档 绿色 (#0e8a16)
scope:modular 模块化架构 紫色 (#5319e7)

特殊标签

标签 何时使用 颜色
good-first-issue 适合新手 绿色 (#7057ff)
help-wanted 需要社区帮助 蓝色 (#008672)
duplicate 重复另一个问题 灰色 (#cfd3d7)
wontfix 不会实施 白色 (#ffffff)
invalid 问题无效 灰色 (#e4e669)

响应策略

当问题缺少信息时

感谢你打开这个问题！为了帮助调查，请提供：

**对于错误报告：**
- [ ] Logseq 版本
- [ ] 模板版本
- [ ] 重现步骤
- [ ] 预期行为
- [ ] 实际行为
- [ ] 截图（如果适用）

**对于功能请求：**
- [ ] 用例描述
- [ ] 为什么当前功能不可行
- [ ] 提议的解决方案
- [ ] 期望结果的例子

我已经添加了 `status:needs-info` 标签。一旦你提供这些信息，我将进一步调查。

当建议实施时

这是一个很棒的功能想法！以下是我将如何实施它：

**实施计划：**

1. **研究**（schema-research 技能）
   - 获取 Schema.org 定义 [类]
   - 将属性映射到 Logseq 类型
   - 确定模块放置

2. **实施**（2-3 小时）
   - 将类添加到 `source/[module]/classes.edn`
   - 将属性添加到 `source/[module]/properties.edn`
   - 更新 `source/[module]/README.md`
   - 构建和测试

3. **文档**
   - 添加示例到文档
   - 更新主要 README

4. **发布**
   - 包含在下一个版本中
   - 添加到 CHANGELOG

**你想让我：**
- [ ] 继续实施（我将创建一个 PR）
- [ ] 等待你的反馈
- [ ] 提供更多关于方法的细节

告诉我！

当关闭为重复项时

感谢你报告这个！这似乎是 #[number] 的重复项。

**为什么是重复项：**
[它们如何相同]

**跟踪：**
我将关闭这个问题以支持 #[number]，但你的意见很有价值！请随时添加任何额外的上下文或用例到原始问题。

**另请参阅：**
- 原始问题：#[number]
- [相关讨论]

当实施完成时

✅ **在 #[PR number] 中实现**

**更改：**
- [更改摘要]
- [修改的文件]

**测试：**
✅ 构建通过
✅ 模板验证
✅ 在 Logseq 中测试

**发布：**
这将包含在下一个版本（v[X.Y.Z]）中

**文档：**
- [更新的文档链接]
- [示例链接]

感谢你的建议！作为已完成的问题关闭。

与其他技能的集成

schema-research 集成

用户打开问题："将 Recipe 类添加到模板"

工作流程：
1. github-issues 分析问题
2. 调用 schema-research 技能：
   "从 Schema.org 研究 Recipe 类"
3. 从 schema-research 获取实施计划
4. 在问题上发表计划作为评论
5. 等待用户确认
6. 创建分支并实施
7. 创建链接到问题 PR

module-health 集成

在大型功能之前：
1. github-issues 确定大型功能
2. 调用 module-health：
   "检查 [module] 是否可以容纳新类"
3. 获取健康分数和建议
4. 包含在实施计划中
5. 如果需要，可能建议模块拆分

commit-helper 集成

实施完成后：
1. github-issues 完成功能
2. 调用 commit-helper：
   "为实施 #[number] 建议提交消息"
3. 获取常规提交消息
4. 用于 PR 标题和提交

问题模板

项目应在 .github/ISSUE_TEMPLATE/ 中有这些问题模板：

bug_report.md

---
name: 错误报告
about: 报告模板中的错误
labels: bug, status:needs-triage
---

**描述**
清晰描述错误。

**重现**
1. 第一步
2. 第二步
3. ...

**预期行为**
应该发生什么。

**实际行为**
实际发生了什么。

**环境**
- Logseq 版本：
- 模板版本：
- 操作系统：

feature_request.md

---
name: 功能请求
about: 建议新的类、属性或功能
labels: feature, status:needs-triage
---

**用例**
为什么你需要这个功能？

**提议的解决方案**
你希望看到什么？

**Schema.org 参考**（如果适用）
链接到 Schema.org 类/属性

**考虑的其他解决方案**
你考虑的其他解决方案。

**附加上下文**
任何其他信息。

question.md

---
name: 问题
about: 询问模板问题
labels: question
---

**问题**
你的问题在这里。

**上下文**
你正在尝试做什么？

**你已经尝试过的**
你已经尝试了什么？

自动化想法

基于内容自动标记

// 为自动标记的伪代码
if (issue.title.includes("bug") || issue.body.includes("broken")) {
    labels.add("bug");
}
if (issue.body.includes("schema.org")) {
    labels.add("scope:classes");
}
if (issue.body.includes("export") || issue.body.includes("build")) {
    labels.add("scope:scripts");
}

自动关闭过时问题

# .github/workflows/stale.yml
- uses: actions/stale@v4
  with:
    days-before-stale: 60
    days-before-close: 14
    stale-issue-label: 'stale'
    stale-issue-message: >
      这个问题已经不活跃 60 天。
      如果仍然相关，请评论。否则，将在 14 天后关闭。

最佳实践

要做：

✅ 及时响应（24-48 小时内） ✅ 保持尊重和热情 ✅ 提供清晰、可操作的步骤 ✅ 链接到相关文档 ✅ 感谢用户的贡献 ✅ 随着状态变化更新标签 ✅ 解决问题时关闭问题 ✅ 提供发布信息时关闭问题

不要：

❌ 无解释地关闭问题 ❌ 忽略用户问题 ❌ 使用未经解释的术语 ❌ 未标记问题 ❌ 忘记将 PR 链接到问题 ❌ 无理由重新打开已关闭的问题

成功指标

  • 响应时间： 所有问题 < 48 小时
  • 解决时间： 错误 < 7 天，功能 < 30 天
  • 标签准确性： 100% 的问题正确标记
  • 用户满意度： 积极反馈，回归贡献者
  • 问题完成率： > 80% 的开放问题已解决