 jiantw83
|
8738f54b9d
|
Merge pull request 'feat(gitea): 新增 PR 盯場輪詢腳本與 pr-get、pr-edit 兩個子指令' (#23) from feat/sdlc-flow-rules/main into develop
|
2026-08-27 03:39:36 +00:00 |
|
 admin
|
6a8fd95a2c
|
Merge pull request 'feat(gitea): PR 盯場輪詢與 PR 讀取編修子指令' (#22) from feat/sdlc-flow-rules/pr-watch-and-edit into feat/sdlc-flow-rules/main
Reviewed-on: #22
|
2026-08-27 03:26:03 +00:00 |
|
|
jiantw83
|
5892feea53
|
chore(manifest): 三份 manifest 版本升到 0.1.5
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.4 改為 0.1.5。
Why：本次新增 `pr-get`、`pr-edit` 與 `pr-watch.sh`，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。
How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。
Who：`jsc-gitea` 外掛的套件描述檔。
|
2026-08-27 11:20:27 +08:00 |
|
|
jiantw83
|
73cca6e6ea
|
docs(gitea): README 與 AGENTS 補上盯 PR 與 PR 校準的用法
What：README 的指令清單補上 `pr-get`、`pr-edit` 與 `pr-watch.sh` 三項與各自的退出碼，環境變數表補 `JSC_HOME` 與 `JSC_PR_WATCH_INTERVAL`；AGENTS.md 新增一條規則，盯 PR 等合併一律用 `tools/pr-watch.sh`，不要自己寫輪詢迴圈。
Why：新指令沒寫進 README，呼叫端就只能翻腳本原始碼。`pr-watch.sh` 的退出碼 `10` 更要講清楚：它不是錯誤，是「有新留言，換你處理」的交棒訊號，看成錯誤就會把留言吞掉。
How：README 依既有版面把三項排進指令區塊，另補一段說明退出碼 `10` 的設計意圖。AGENTS.md 把新規則插進第 5 條，原第 5 條順延為第 6 條。
Who：讀 `jsc-gitea` 說明的人，以及依 AGENTS.md 行事的代理。
|
2026-08-27 11:20:27 +08:00 |
|
|
jiantw83
|
5471b97635
|
feat(pr-watch): 新增盯 PR 到合併的輪詢腳本
What：新增 `tools/pr-watch.sh`，盯一支 PR 直到它合併或關閉。退出碼 `0` 是已合併或已關閉、`10` 是有新留言要呼叫端接手、`2` 是參數錯誤或第一輪就連不上 Gitea、`3` 是查不到該 PR。輪詢間隔預設 60 秒，`JSC_PR_WATCH_INTERVAL` 可覆寫。
Why：等 PR 合併原本靠各技能自己寫輪詢迴圈，間隔與退場條件每支都不一樣，還常常自動逾時退場，PR 明明還開著就被當成收尾。改用一支共用腳本之後，等待行為只有一種，而且盯到 PR 收尾為止。
How：資料一律經同目錄的 `gitea.sh`（`pr-status`、`pr-comments`），不自行拼 API。已回報過的留言把最後一筆時間戳寫進狀態檔，預設 `$JSC_HOME/pr-watch/{owner}-{repo}-{編號}.seen`，同一則不重複回報；狀態檔還不存在時把既有留言整批回報一次，寧可重複也不漏掉開始盯之前的審查意見。PR 收尾那一輪若還有沒回報的留言，照樣印出來再退出，退出碼仍是 `0`。`pr-status` 對不存在的 PR 會印「? none none」並正常結束，所以 state 只認 `open` 與 `closed`、merged 只認 `true` 與 `false`，對不上就回 `3`，PR 編號打錯不會變成永遠輪詢一支不存在的 PR。
Who：`jsc-sdlc:implement` 開完工作包 PR 之後的等待合併，以及任何要盯 PR 的技能。
|
2026-08-27 11:20:27 +08:00 |
|
|
jiantw83
|
c3c810c97b
|
feat(gitea): 新增 pr-get 與 pr-edit 兩個 PR 子指令
What：`tools/gitea.sh` 新增 `pr-get` 與 `pr-edit`。`pr-get` 印出一支 PR 的標題、base 分支與描述，前三行固定 `title`、`base`、`body` 三個標記，第 4 行起是描述原文；`pr-edit` 從檔案讀描述，一次更新標題與描述。
Why：分支已經有 PR 時，每次認可之後都要比對標題、描述與前置 PR 依賴三項，有差才更新。原本只有 `pr-create` 與 `pr-status`，讀不到既有 PR 的標題與描述，比不了就只能重開一支 PR 或整支蓋掉，兩種都會把審查中的討論打斷。
How：`pr-get` 把唯一會多行的描述放在輸出最後一段，呼叫端用 `head -n1`、`sed -n 2p`、`tail -n +4` 就取得到三個欄位，全程不必解析 JSON。`pr-edit` 的描述走檔案而不走參數，多行內容與全形標點才裝得下；描述檔不存在回 `2`，API 呼叫失敗回 `4`，成功印 `OK {owner}/{repo}#{編號}`。
Who：`jsc-git:pr` 的既有 PR 校準步驟，以及任何要先比對 PR 現況再決定改不改的呼叫端。
|
2026-08-27 11:20:27 +08:00 |
|