← 全部 Skills · 自动化 · PR Description Writer

PR Description Writer — 成品输出
适用平台Claude Code Codex Cursor Muse Dot Grok Bot Cue OpenClaw Hermes
需要:变更摘要:pr.txt(Title 行写这次 PR 是做什么的,每处改动一行 Change 行,每个原因一行 Why 行,每项检查一行 Test 行——跑了什么,然后 | Result: pass、fail 或 not run——每项风险一行 Risk 行——可能出什么问题,然后 | Level: low、medium 或 high——以及可选的 Note 行)。

相似技能

查看全部技能 →

你将获得

  • 一份结构化 PR 描述:Summary、Why、带已记录结果的 Testing、带 door verdict 与 blast radius 的 Risk
  • 一份 Readiness 结论——Ready to paste,或 Not ready 并点名缺口与错误
  • 每项测试都带已记录的结果——没有结果的测试列为 Not recorded,绝不默认通过
  • 每项风险都带已声明的等级——没有等级的风险列为 Not stated,绝不代为定级
  • 所有缺口、输入错误与警告都在报告中点名

适合人群

  • 开 PR 时先把事实摆在评审面前
  • 让没测或没记录的检查在合并前就可见,而不是藏起来
  • 在合并前标出 one-way-door 改动——迁移、删除、breaking change

不适合

  • 批准改动——描述只是描述改动,评审仍要读 diff
  • 判定改动有多危险——door verdict 只数不可逆词,不衡量风险
  • 在没有变更摘要的情况下写 PR——报告会列出缺口,而不是编一份描述

示例输出

此 Skill 产出的示例。示例内容,仅供说明。

Pull request — sample

Changes: 3 | Why: 2 | Tests: 3 (3 passed, 0 failed, 0 not run, 0 not recorded) | Risks: 2 | Gaps: 0 | Errors: 0 | Warnings: 0

Ready to paste — every section is present and the input had no errors.

Summary: 1. Return the cached result when content is unchanged in the save path; 2. Add a GET /sessions/:id/result endpoint that serves the cached result; 3. Show a "Cached" badge on the session page when the result comes from cache.

Testing: Run the save twice with unchanged content — Pass; Open the cached result endpoint for a finished session — Pass; Load the session page for a cached result — Pass.

Door: Two-way door — no irreversible step mentioned; cheap to roll back. Blast radius: api · ui · code.

What this description is not: a description describes the change; it does not approve it — a reviewer still reads the diff.

关于此 Skill

你说
缓存保存的改动已就绪——写一份评审真正能用的 PR 描述。

如何安装

  1. 把安装提示词复制到你的 Agent: Read https://skillu.dev/install/agent.md, then install the PR Description Writer skill (pr-description-writer).
  2. 或在上线后从本页下载 Skill 包,把它的文件夹放入你的 Agent 的 skills 目录。
  3. 用斜杠命令调用它,例如 /pr-description-writer,然后用大白话描述你想要什么。

常见问题

Ready to paste 就是 PR 通过了吗?

不是。它只表示每个部分都齐了、输入没有错误——描述完整了,不代表改动通过了。评审仍要读 diff,Testing 表里一项失败的测试是一条发现,不是描述的拦路虎。

测试没有记录结果怎么办?

它会在 Testing 表里列为 Not recorded,警告中也会点名。报告绝不会默认某项测试通过了——藏起没跑过的测试的描述,比没有描述更糟。

获取 Premium 浏览更多 Skills