用途:为 GitHub PR 生成简洁的韩语标题和正文,让审查者理解该 PR 为何重要、合并后有什么变化。该技能专注于文案契约;若同时需要创建或更新实际 PR,则配合 draft-pr 完成仓库与发布操作。
主要能力:读取用户请求、仓库 PR 模板、待编辑的现有正文、关联 issue/Jira 上下文以及净 diff 或提交范围,保留有用的截图、链接、发布说明和人工审查上下文。支持写作-only 模式,也支持在明确要求时发布到 GitHub。
使用方式:将正文写入真实的临时 Markdown 文件,不要用进程替换传给 --body-file。示例: tmp_pr_body="$(mktemp -t pr-body.XXXXXX.md)" cat > "$tmp_pr_body" <<'EOF' ... EOF 用 wc -l "$tmp_pr_body" 检查长度,常规 PR 约 20 行以内,小型 PR 接近 10 行。写作-only 请求直接返回标题与正文;若用户要求修改 GitHub,则交给 draft-pr 流程并使用 --body-file。
正文结构:仓库无其他模板时使用背景、变更概要、结果三段,保留仓库必需模板段落并删除未用占位符。所有散文使用韩语敬语(-습니다, -합니다, -됩니다),允许紧凑名词短语要点。先讲动机和结果,再讲实现细节。不要添加通用验证/测试段或过时声明,CI 是常规测试状态来源。破坏性影响放在一条结果要点中,不重复创建 Breaking Changes 段落。只使用一层嵌套要点。
标题与链接:优先遵循仓库标题约定;提供 Jira 时在正文顶部放完整 URL 并在标题含 [PROJ-123],不要仅凭 key 编造 URL。只为目标 GitHub issue 添加 Closes #N。
发布命令:仅在明确要求 GitHub 变更且 draft-pr 预检已确定 PR/base/head 后使用: gh pr edit <number> --body-file "$tmp_pr_body" 仅当请求包含标题变更时才加 --title "<title>"。GitHub Enterprise 设置 GH_HOST: GH_HOST=github.example.com gh pr edit <number> --body-file "$tmp_pr_body" 发布成功后删除临时文件。除用户要求或明显占位符外,不要覆盖既有标题。
输出契约:写作-only 返回拟定的标题和渲染后正文,并列出妨碍精确链接的缺失 Jira/issue 事实;已发布更新先给 PR URL 并说明改了标题、正文还是两者。
限制与注意事项:--body-file <(cat <<EOF ...) 可能产生空或截断正文,必须先写真实文件。GH_HOST=... gh ... 对 GitHub Enterprise 比 --hostname 更可移植。变更概要说明做了什么,结果说明审查者或用户得到什么,不要重复。不要使用 emoji、em dash、间隔号、项目符号字形或 GitHub 会渲染为删除线的波浪范围。移除代理品牌、会话名、本地路径、未解释的内部缩写和仅对话引用。后续事项、复盘细节和长链接集合放在独立 issue 或文档中。纯 PR 작성 请求只产出文案,仅当用户明确要求创建、打开、发布或更新远程 PR 时才用 draft-pr。部分命令与平台细节以公开资料为准,暂未提供官方文本。