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

PR Description Writer — 成品輸出
Runs inClaude 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 行)。

Similar Skills

View all skills →

你將獲得

  • 一份結構化 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

You say
快取儲存的改動已就緒——寫一份評審真正能用的 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