用途:审查 PR 的标题与描述是否清晰简洁,让评审者快速理解改了什么、为什么改。重点在文字表达,格式检查(标题模式、模板必填段落)为次要。该技能只评估,产出发现与具体改写建议,不直接应用,由调用方决定是否采纳或作为反馈呈现。
主要能力:面向浏览 PR 的评审者或同事,标题与描述需能独立成立。原则包括:首句直接说明改动与目的;解释意图而非机械叙述 diff;省略 diff 已体现的常规改动;简洁优先,删除重复或复述标题的条目;对废弃、单位选择、回退行为、权衡等非显然决策说明原因;避免无上下文术语;用主动语态并点明主体;标题可独立用于提交日志或变更日志;删除“This PR…”“I added…”等无信息量的元叙述。
使用方式:获取标题与描述,例如 gh pr view <n> --json title,body,然后逐项检查标题能否独立表意、描述是否先讲主改动与目的、是否解释非显然决策的原因、是否有新手不懂的术语、能否更短、是否被动含糊、是否有元叙述。次要确认格式:标题符合 [type] Description 且约 63 字符内,并包含 .github/pull_request_template.md 要求的段落。完整标准见 creating-pull-requests 与 wiki/pull-requests.md。
常见问题:标题离开正文才懂;描述以背景或流程开头;条目复述 diff;非显然决策缺原因;内部术语未展开;被动或主体缺失;元叙述;条目过多或重复。
输出:针对标题和描述分别给出问题与具体改写建议。
限制:仅评估不修改;资料未提供自动应用、集成方式或收费信息。