capture

用途

Capture 用于把一段自然语言描述快速转化为 GitHub Issue 草稿，适合在记录想法、报告 Bug 或提出功能请求时使用，减少手动创建 Issue 和填写标签的步骤。

主要能力

• 解析自由文本描述，自动判断类型：
  • 包含 error、crash、broken、fix、bug、fails、regression 等关键词时，判定为 Bug，使用 triage、bug 标签。
  • 包含 add、want、should、new、feature、enhance、improve 等关键词时，判定为功能需求，使用 triage、enhancement 标签。
  • 无法匹配时默认按功能需求处理，使用 triage、enhancement 标签。
• 通过 gh issue create 创建 GitHub Issue，自动生成简洁标题与完整正文，并附加相应标签。
• 创建完成后返回 Issue 编号与 URL。

使用方式

输入为一段自由文本，用于描述一个想法、Bug 或功能请求。技能会解析该描述并执行创建命令：

gh issue create \
  --title "<concise title from description>" \
  --body "<full description>" \
  --label "triage" --label "<bug or enhancement>"

兜底与边界情况

• 如果 gh 不可用或 GitHub 访问失败：
  1. 尝试使用 GitHub MCP 工具（若可用）。
  2. 若两者均不可用，则将内容追加到 ai-workspace/scratchpad.md，格式如下：

## Captured [date]
**Type**: [bug/feature]
**Description**: [text]
_Failed to create GitHub Issue — saved here as fallback._

并告知用户该记录已保存在本地。

• 未提供描述时，提示用户描述其想法或 Bug。
• 离线或无 GitHub 访问权限时，使用上述 scratchpad 兜底方案。

适用场景

适合需要快速把零散想法、缺陷报告或改进建议登记为 GitHub Issue 的开发协作流程，尤其是希望统一使用 triage 标签进行初步分类的团队。

限制

依赖 gh 命令行工具或 GitHub MCP 工具；两者均不可用时只能本地保存，无法自动创建 Issue。类型判断基于关键词匹配，可能无法覆盖所有表述。