pull-request-msg-with-gh

Pull Request 消息生成器

生成一个 PR_MESSAGE.md 文件，总结当前会话中的工作。 需要使用 gh CLI 登录目标仓库。

前置条件检查

gh --version 2>/dev/null && gh auth status 2>/dev/null

如果未安装 gh，请停止并报告：

• 从 https://cli.github.com 安装
• 不能通过 npm 安装 gh
• 安装后，运行 gh auth login 进行身份验证

不得在没有可用且已通过身份验证的 gh CLI 时继续。

工作流

1. 分析会话上下文 — 回顾当前会话中所做的更改。使用 git diff 和 git status 检查已更改的文件，了解工作的完整范围；同时回顾对话历史。这两个来源都会为 PR 消息提供依据。
2. 检测议题编号 — 使用下方的议题检测算法。如果用户表示没有关联议题，则完全省略 Closes #<issue-number> 页脚。
3. 确定提交类型 — 根据更改的性质确定（类型列表见 references/pr-message-format.md）
4. 编写 PR_MESSAGE.md — 使用 references/pr-message-format.md 中的格式
5. 添加到 .gitignore — 如果尚未添加，则将 PR_MESSAGE.md 添加到其中
6. 验证 — 运行 commitlint 和 markdownlint 检查

议题编号检测

必须通过搜索 GitHub 来确定议题编号，不得从分支名称中提取数字。

算法

# Step 1: Get branch name
BRANCH=$(git branch --show-current)

# Step 2: Extract keywords (strip leading numbers and hyphens)
# Example: "125-greenops-equivalencies" → "greenops equivalencies"
KEYWORDS=$(echo "$BRANCH" | sed 's/^[0-9]*-//' | tr '-' ' ')

# Step 3: Search GitHub issues
gh issue list --search "$KEYWORDS" --state all \
  --json number,title --limit 5

评估规则

1. 恰好有 1 个结果，且标题包含最多关键词 → 使用该结果
2. 0 个结果 → 询问用户议题编号
3. 2 个或更多结果 → 展示选项并请用户选择
4. 匹配不明确 → 请用户确认

绝不可从以下内容提取议题编号

• 分支名称中的数字（例如，125- 不是议题 #125）
• 规格文件夹名称（例如，specs/125-xyz/）
• Worktree 文件夹名称

这些都是内部标识符，不是 GitHub 议题编号。

关键规则

1. 避免冗余 — 摘要必须补充提交主题之外的上下文
2. 不得添加 ## Commit Message 章节 — 第一行就是提交消息
3. 绝不修改 .markdownlint.json — 改用 CLI 标志
4. 末尾换行符 — 文件必须以单个换行符结尾
5. 存在歧义时询问 — 如果议题搜索返回 0 个、2 个或更多，或结果不明确，请询问用户

验证

如果当前上下文中提供了 commitlint 和 markdownlint 技能，请使用它们验证 PR_MESSAGE.md。否则，直接运行：

# Validate commit message format
cat PR_MESSAGE.md | npx commitlint

# Validate markdown (MD041 disabled — first line is commit subject,
# not heading)
npx markdownlint --disable MD041 -- PR_MESSAGE.md

如果技能和 npx 都不可用，则必须报错：

• 安装 commitlint：npm install -g @commitlint/cli @commitlint/config-conventional
• 安装 markdownlint：npm install -g markdownlint-cli

不得悄悄跳过验证。

修复所有问题并重新验证，然后再报告成功。