用途:帮助用户撰写、起草、改写、审阅、改进或评分 PR 描述与 PR 标题,也可用于生成 PR 摘要、动机说明与评审要点。
主要能力:以 assets/pr-description-template.md 作为输出骨架;起草时可加载 references/pr-writing-calibration.md 做事实校准,仅在交付前评分或用户要求审阅时加载 references/react-pr-findings.md 与 references/pr-description-rubric.md。默认返回可直接粘贴的标题与正文;若用户要求审计或评分,则附上逐条评审并给出修订版。
使用方式:先读 AGENTS.md 与 CONTRIBUTING.md,找到仓库 PR 模板(.github/pull_request_template.md 或 .github/PULL_REQUEST_TEMPLATE/),确定目标分支并解析 <base>,然后运行: git log --no-merges <base>..HEAD git diff <base>...HEAD 必要时补充语义证据: sem diff --from <base> --to HEAD --format json --no-cosmetics sem impact --entity-id <entityId> --tests --format json Sem 不能替代上述 git 命令,也不构成测试或验证证据。
写作要求:用平实技术英语,直接命名函数、类型、标志、文件或参数;每句只承担一个职责;先以现在时描述变更前的行为,再解释机制与正确性契约,最后给出可复现的验证证据。标题按仓库约定书写,作为可能的 squash-commit 主题。
限制:不得编造测试结果、基准、issue、设计决策或基线;性能声明必须给出指标、负载、环境、样本量与来源;不得把脚手架或实验说成生产完成;不得覆盖仓库模板、贡献规则或标题约定;不得用合并提交信息作为 PR 叙述证据。资料未提供具体仓库模板内容与评分细则细节。