该技能用于在用户要求创建 PR 或生成 PR 描述时,自动分析当前分支与 main 的差异并撰写描述,最后通过 GitHub CLI 创建拉取请求。
主要能力:检查当前分支与领先提交(git branch --show-current、git log origin/main..HEAD --oneline),确认是否具备创建 PR 的条件;收集上下文(提交信息、diff 摘要与代码改动),并将改动归类为 fix、feature、performance、refactor、docs、test、chore;按固定结构生成描述,包含 Summary、Context、Changes、Key Implementation Details、Use Cases、Testing、Links 等部分,并给出 Feature、Bug Fix、Performance、Refactor 等示例模板。
使用方式:先写描述到 .forge/FORGE_PR_DESCRIPTION.md,再执行 gh pr create --title "[Change Type]: [One-line summary]" --body-file .forge/FORGE_PR_DESCRIPTION.md;创建后删除临时文件,并向用户返回 PR URL、改动类型与简要摘要。
限制与注意:需存在领先于 main 的提交且不在 main/master 上;差异过大时只抽样关键文件;应避免空描述、占位文本、逐文件罗列等反模式;描述需诚实说明已知问题。具体依赖与配置要求资料未提供。