用途:在用户要求创建 Pull Request、发起拉取请求或撰写 PR 描述时,按项目既定风格生成 PR 标题与正文。
主要能力与用法: 先收集上下文:运行 git log --oneline <base>..<HEAD> 列出本 PR 的提交,对每个提交运行 git show <hash> 了解改了什么及原因,确认 base 分支(不清楚时询问用户),若用户提到 Jira 工单或设计文档 URL 则一并查找。
标题格式为 [base-branch] type: short description,其中 base-branch 是方括号内的目标分支,如 [dev];type 遵循 conventional commits,取 feat、fix、refactor、chore、docs;描述小写、祈使语气、60 字符以内;若有 Jira 工单则写成 [dev] (CTCS-1234) feat: add AU retry logic。
正文分三部分。第一部分为 ## Background,用一到两句说明为何存在该 PR、要解决的上下文或问题,不要逐行描述代码,用平实英文,不用项目符号和破折号。第二部分为每个有意义的提交各写一段,以短提交哈希作为超链接开头,如 [abc1234](完整提交 GitHub URL),随后用平实句子说明该提交做什么、为什么;纯 chore 提交(如依赖更新、gitignore)除非需要解释否则跳过;每段 1 至 3 句;提交 URL 格式为 https://github.com/<org>/<repo>/commit/<full-hash>。第三部分为 ### Reference,列出设计文档、Jira 工单、相关 PR 等链接,每行一个 markdown 链接;没有引用时省略该节。
定稿前检查风格:不得出现破折号(—),改用逗号、句号或改写;不得出现 This PR introduces、This commit implements、In this PR we 一类措辞,句子直接以主语开头;顶部没有摘要项目符号;除非用户要求,不加 Test plan 部分;语言直接简洁,能删则删。规则总结中标题格式为 [base-branch] (ticket) type: description,正文以 ## Background 开头,提交格式为 short-hash: 一句话说明原因,引用用 ### Reference 加 markdown 链接,不用破折号,不用项目符号,Background 与提交段落均为散文,不做 AI 填充,长度要短,若需超过 3 个提交段落说明该 PR 可能过大。
限制:该技能只负责撰写 PR 标题和描述文本,不负责实际创建 PR 或执行 git 提交;不提供自动获取 base 分支或 Jira 信息的能力,需用户提供。具体可用命令、平台支持与收费情况资料中暂未提供。