feat(meta): 建立 PR 收尾回報單一規範

references/guidelines.md

@@ -27,6 +27,8 @@
 5. 功能主幹 `{類型}/{功能}/main` 不在 origin 上時，自動從 `develop` 建立並推上去，收尾要回報建立了哪一條分支。
 6. 階梯最後一級不能省：`develop` 併進 `master` 才會生效，marketplace 與 `version-guard.sh` 都讀存取庫的**預設分支**。
 
+PR 開立、更新、留言修正的收尾回報格式只看 [`references/pr-report.md`](pr-report.md)。所有會產生 PR 的技能都引用那份文件，不在技能內各自抄欄位。
+
 ## Description 規則
 
 1. frontmatter 的 `description` 為一行英文，不超過 5 句或 5 個步驟——**兩個上限滿足任一個就算通過**，句數與步驟數都超過才要精簡。

references/pr-report.md

@@ -0,0 +1,36 @@
+# PR 收尾回報
+
+所有會建立或更新 PR 的技能都用本頁格式回報。不要在各技能複製欄位定義。
+
+## PR 資訊表格
+
+只要本輪建立 PR、找到既有 PR，或更新既有 PR，就在回報中列出同一張表。
+
+| {owner}/{repo} | PR 編號 | PR 連結 | PR 簡述 |
+| --- | --- | --- | --- |
+| `{owner}/{repo}` | `{number}` | `{url}` | `{title or one-line summary}` |
+
+同一輪有多支 PR 時，全部放在同一張表。沒有 PR 時不要印空表，改用一句話說明沒有建立或更新 PR。
+
+## 留言回覆
+
+依 PR 留言完成修正、判定不需修正，或判定無法修正後，必須回覆原留言。
+
+回覆一律走 `jsc-gitea/tools/gitea.sh comment-reply`。不要自行拼 API。
+
+`pr-comments` 第三欄會標出留言類型與 id。呼叫 `comment-reply` 時使用下列對應。
+
+| `pr-comments` 第三欄 | `comment-reply` 類型 |
+| --- | --- |
+| `留言#{id}` | `issue` |
+| `審查#{id}` | `review` |
+| `行內#{id}(...)` | `inline` |
+
+回覆內容固定包含兩項：
+
+| 項目 | 內容 |
+| --- | --- |
+| 處理結果 | 已修、不需修，或無法修 |
+| 依據 | commit、檔案，或不修理由 |
+
+完成條件：本輪處理過的每一則留言，都有對應的回覆連結或明確的回覆失敗原因。