用途:在编写提交信息前,分析暂存区改动与开放 issue 的关联,推断应使用的 issue 关联关键词,避免遗漏或错误关闭 issue。
主要能力:通过 gh CLI 获取开放 issue 的编号、标题、正文和标签;用 git diff --cached 分析改动文件、函数名、错误信息和字符串;按文件路径、错误信息、组件/目录、关键词重叠等信号打分,报告得分不低于 2 的潜在匹配;区分关闭关键词(Fixes/Closes/Resolves)与引用关键词(Refs/Related to/See/Part of),并给出决策树。
使用方式:先运行 gh issue list --state open --json number,title,body,labels --limit 50 获取 issue,再用 git diff --cached --name-only、git diff --cached、git diff --cached --stat 查看改动,然后按启发式匹配。可用 gh issue view <number> --json title,body,labels,assignees 查看详情,用 gh issue list --search "keyword in:title,body" --state open 搜索。输出按高/中置信度列出建议关键词。
适用场景:提交前检查关联 issue、bug 修复、功能实现、部分进展的引用,以及多 issue 同时关联。
限制:Blocks/Blocked by 不是提交 trailer,GitHub 不解析,应通过 /git:issue-hierarchy --blocked-by N 记录;需验证 issue 状态,避免引用已关闭 issue;无匹配时可考虑先建 issue;跨仓库可用 owner/other-repo#42 形式。具体安装与配置资料暂未提供。