From 08269866e4cf470485dc53f4495e2e74c833982c Mon Sep 17 00:00:00 2001
From: charliie-dev <charles@nics.nat.gov.tw>
Date: Thu, 9 Jul 2026 18:38:40 +0800
Subject: [PATCH 1/2] chore(github): add org default pr template with test
 runbook
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

merge -> In Deploy -> In QA 流程上線後,QA 驗收標準需要在 PR 階段就被
review (shift-left),而非 merge 後補寫。template 含變更摘要 + Closes、
測試 runbook (驗收標準 checklist + 操作流程)、佈署注意事項三區塊;
全 org 無任何自帶 template,org 預設一份即全面生效。
---
 .github/PULL_REQUEST_TEMPLATE.md | 38 ++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..a67425d
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,38 @@
+<!-- 標題請用 Conventional Commits 格式：<type>(<scope>): <subject>（全小寫、結尾不加句號） -->
+
+## 變更摘要
+
+<!-- 這個 PR 做了什麼、為什麼。 -->
+
+Closes #
+
+## 測試 Runbook
+
+<!--
+merge 進 dev 後，issue 會自動走 In Deploy → 佈署 → In QA，QA 工程師依本區塊在 dev env 驗收。
+runbook 跟著 code 一起被 review：reviewer 看不懂怎麼驗，就是 runbook 要改。
+純文件、CI、重構等無需上機驗收的變更，請填「N/A」並簡述原因。
+-->
+
+### 驗收標準
+
+<!-- 怎樣算通過。每條都要可判定（可觀察、可量測），例如：
+- [ ] Grafana 可依 project_id / run_id 撈出單次執行的完整 log 軌跡
+-->
+
+- [ ]
+
+### 操作流程
+
+<!-- QA 逐步照做的操作，包含入口（URL / 指令）、前置條件、測試資料。例如：
+1. 開 https://grafana.<dev-domain>/dashboards，進入「run 執行追蹤」
+2. 以測試 project_id=... 查詢，確認 ...
+-->
+
+1.
+
+## 佈署注意事項
+
+<!-- DevOps 佈署時需要知道的事：DB migration、新環境變數、需重建/重啟的服務、相依 repo 順序。無則填「無」。 -->
+
+無

From 64c5492b0c307e51b53805bcc83b22fdf95fefc5 Mon Sep 17 00:00:00 2001
From: charliie-dev <charles@nics.nat.gov.tw>
Date: Thu, 9 Jul 2026 18:42:13 +0800
Subject: [PATCH 2/2] chore(github): refine pr template wording per review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 全小寫/不加句號標明為團隊慣例,非 Conventional Commits 官方規格
- 範例 URL 佔位符改 {dev-domain} 加反引號,避免複製出註解後被當 HTML tag
- Closes # 加填寫提示註解 (保留裸 # 以利 GitHub autocomplete;缺漏由
  pr-issue-check gate 把關)
---
 .github/PULL_REQUEST_TEMPLATE.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index a67425d..ce60ee1 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,10 +1,12 @@
-<!-- 標題請用 Conventional Commits 格式：<type>(<scope>): <subject>（全小寫、結尾不加句號） -->
+<!-- 標題請用 Conventional Commits 格式：<type>(<scope>): <subject>
+     （團隊慣例：subject 全小寫、結尾不加句號） -->
 
 ## 變更摘要
 
 <!-- 這個 PR 做了什麼、為什麼。 -->
 
-Closes #
+Closes # <!-- 填 linked issue 編號（輸入 # 後可用自動補全）；pr-issue-check 會擋未連結 issue 的 PR -->
+
 
 ## 測試 Runbook
 
@@ -25,7 +27,7 @@ runbook 跟著 code 一起被 review：reviewer 看不懂怎麼驗，就是 runb
 ### 操作流程
 
 <!-- QA 逐步照做的操作，包含入口（URL / 指令）、前置條件、測試資料。例如：
-1. 開 https://grafana.<dev-domain>/dashboards，進入「run 執行追蹤」
+1. 開 `https://grafana.{dev-domain}/dashboards`，進入「run 執行追蹤」
 2. 以測試 project_id=... 查詢，確認 ...
 -->