用途:根据当前会话的工作内容生成 PR_MESSAGE.md,汇总本次改动并配合 GitHub CLI 检测相关 issue,形成结构化的 PR 描述。
主要能力:分析会话上下文,通过 git diff 与 git status 了解改动范围;按算法搜索 GitHub issue 确定 issue 编号;判断提交类型;写入 PR_MESSAGE.md;将其加入 .gitignore;执行 commitlint 与 markdownlint 校验。
必要用法:需先确认 gh CLI 已安装并完成认证,命令为 gh --version 2>/dev/null && gh auth status 2>/dev/null。若未安装,从 https://cli.github.com 安装,gh 无法通过 npm 安装,安装后运行 gh auth login。issue 编号必须通过 GitHub 搜索确定,不能从分支名、spec 目录名或 worktree 目录名中的数字提取。搜索命令示例:gh issue list --search "$KEYWORDS" --state all --json number,title --limit 5。结果为 1 且标题含多数关键词则采用,0 条或 2 条以上或结果不明确时询问用户;用户表示无关联 issue 时省略 Closes 页脚。校验命令:cat PR_MESSAGE.md | npx commitlint;npx markdownlint --disable MD041 -- PR_MESSAGE.md。
限制:需已认证的 gh CLI;无校验工具与 npx 时须硬性失败,不可跳过校验;不得修改 .markdownlint.json;文件须以单个换行结尾;摘要不得与提交主题重复;不设 ## Commit Message 小节。其他未提供信息暂未说明。