用途:在提交 bug、功能请求或杂项任务时,生成标题规范、正文完整、可被分诊与验收的 GitHub issue。
主要能力:提供 [Type] Component: 简要描述 的标题格式(如 [Bug] Auth: Login fails with valid credentials),要求具体、含组件、控制在 72 字符内;提供 Bug 报告模板(Summary、Steps to Reproduce、Expected Behavior、Actual Behavior、Environment)与 Feature 请求模板(Summary、Motivation、Proposed Solution、Acceptance Criteria 复选框);支持 GitHub 一等 issue 类型(Bug、Feature、Task,具体可用类型取决于仓库/组织配置)。
使用方式:正文非简单内容时,先用 Write 工具写入 /tmp/issue-body.md,再用 gh issue create --title "..." --body-file /tmp/issue-body.md 创建,避免 shell 转义破坏反引号与代码块;可加 --label、--assignee、--type "Bug"。搜索用 gh issue list --search "keyword" --state all,查看用 gh issue view N,编辑正文用 gh issue edit N --body-file,评论用 gh issue comment N --body-file。子 issue 通过 gh api repos/{owner}/{repo}/issues/{parent}/sub_issues -f sub_issue_id={new_id} 关联。
关联关系:硬依赖用原生 dependencies/blocked_by API,组合关系用 sub-issue API,软引用在正文写 Related to #789,合并自动关闭用 Fixes #N / Closes #N。资料指出不应再在正文写 Blocks #123 或 Blocked by #456,因其已不被解析。
适用场景:提交新 bug、功能或杂项 issue,设计功能请求,组装 issue 标题与模板。限制:可用 issue 类型依赖仓库配置;正文含反引号、多行或 shell 元字符时必须用 --body-file;资料未提供收费、价格或平台支持范围等信息。