用途:把当前对话内容整理成一条结构清晰的 GitHub Issue,并通过 gh CLI 创建到指定仓库中。
主要能力:先确认所在目录是否为带 GitHub remote 的 git 仓库,命令为 gh repo view --json nameWithOwner -q '.nameWithOwner';若失败则询问用户目标仓库。随后综合对话内容生成 Issue 正文,使用 gh issue create --title "<concise title>" --body "$(cat <<'ISSUE_EOF' ... ISSUE_EOF)" 创建,并回报 Issue URL。
正文结构:第一部分 What & Why,用 2 至 4 条要点说明需要做什么、为何重要;第二部分 Context & Discussion 为主体,包含背景、当前行为、期望行为、约束与决策、技术细节(代码路径、配置、schema、接口形态、错误信息)、相关工作链接,并用标题、要点、表格、折叠块和带语言标签的代码块组织,保留讨论实质但重新逻辑化;第三部分 Implementation Plan 按步骤编号,指出关键文件、待定问题(以 [ ] 前缀标注)和步骤依赖;若尚无一致计划则写 ## Implementation Plan\n\n_TBD -- no plan agreed on yet._。
标签与分配:对话若暗示 bug、feature、enhancement、tech-debt 等类别,可加 --label;除非用户明确要求,否则不分配负责人。
风格要求:标题使用祈使语气且少于 70 字符;避免冗余措辞;优先使用标题与列表;不丢失未来实现者需要的细节;未决定事项明确标注 TBD 或开放复选框。
限制:资料未说明其依赖的具体模型、是否收费、支持平台或安装方式,这些信息暂未提供。