用途:把对话中讨论的问题、背景与方案整理成结构清晰的 GitHub Issue,并通过 gh CLI 直接创建。
主要能力:先确认当前目录是否为带 GitHub 远程的 git 仓库,命令为 gh repo view --json nameWithOwner -q '.nameWithOwner';失败时询问用户目标仓库。随后按固定结构生成 Issue 正文:What & Why(2-4 条要点说明要做什么、为何重要)、Context & Discussion(背景、当前行为、期望行为、约束与决策、技术细节、相关工作,可用标题、列表、表格、代码块、折叠块组织)、Implementation Plan(编号步骤、涉及文件、待定项以 [ ] 标注;未达成方案时写 TBD)。
使用方式:用 gh issue create --title "<concise title>" --body "$(cat <<'ISSUE_EOF' ... ISSUE_EOF)" 创建,完成后回报 Issue URL。可选按对话内容添加 --label(如 bug、feature、enhancement、tech-debt);除非用户明确要求,否则不分配负责人。
风格要求:标题用祈使句且不超过 70 字符;避免空话;优先结构化表达;保留实现者需要的细节;未决定事项明确标注 TBD 或开放复选框。
限制:依赖已安装并认证的 gh CLI 与 GitHub 远程仓库;仓库无法确定时需用户指定;不自动分配负责人;资料未提供具体安装命令、收费、平台支持范围与效果数据。