Files
meta/references/pr-report.md

37 lines
1.3 KiB
Markdown

# 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、檔案,或不修理由 |
完成條件:本輪處理過的每一則留言,都有對應的回覆連結或明確的回覆失敗原因。