feat(cli): 設定規格登錄 PR 盯場輪詢間隔 #22

2026-08-27T03:21:23Z

jiantw83 commented

2026-08-27 03:21:23 +00:00

摘要

需求描述：落實「SDLC 執行流程」規則群裡「等待合併改用 pr-watch.sh 輪詢、預設 60 秒、不自動退場」這一條在 jsc-cli 的部分。新腳本帶進一個環境變數 JSC_PR_WATCH_INTERVAL，設定規格表是 jsc 環境變數的清單正本，要把它登錄進去。決策紀錄在 wiki 存取庫 knowledges/QUESTION 的 QUESTION_FB8DF0B5，2026-08-27 那一節。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/config-spec.tsv`	設定規格表是 `jsc-cli` 部署與體檢讀的清單正本。`JSC_PR_WATCH_INTERVAL` 沒登錄，體檢就看不到它，使用者也無從得知有這個旋鈕可以調
`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`	讀表的行為跟著變，版本要往上走；三份同步升到 0.1.7

設計重點

只加一列，不動表的結構。欄位順序與既有各列相同：型別 env、全域、非必填、預設 60、檢查方式 set、缺少時 ask。
非必填加預設值，是因為缺少它不該擋住任何流程——pr-watch.sh 自己就以 60 秒為預設，這一列只是把預設寫成可查的事實。
說明點名實作位置在 jsc-gitea/tools/pr-watch.sh。行為的正本在腳本裡，表只負責讓人找得到它。
排在 JSC_VERSION_TTL 之後，與其他控制輪詢與快取的旋鈕放在一起。

測試結果

tools/config-spec.tsv 以定位字元分欄，新列的欄數與既有各列一致，git diff 顯示只新增一列、沒有動到其他行。
ste100-lint.sh .：全庫零命中。
三份 manifest 以 JSON 解析器讀過，格式正確且版本一致為 0.1.7。
未測：jsc-cli:deploy 與環境體檢實際讀這一列的行為，需要已安裝的 CLI 與可連線的 marketplace，本次在沒有 Gitea 存取的環境進行。

前置 Push Request

plugins/gitea#22 plugins/gitea#22（本 PR 用到的 pr-get、pr-edit 在那支）

## 摘要 - 需求描述：落實「SDLC 執行流程」規則群裡「等待合併改用 `pr-watch.sh` 輪詢、預設 60 秒、不自動退場」這一條在 `jsc-cli` 的部分。新腳本帶進一個環境變數 `JSC_PR_WATCH_INTERVAL`，設定規格表是 jsc 環境變數的清單正本，要把它登錄進去。決策紀錄在 wiki 存取庫 `knowledges/QUESTION` 的 `QUESTION_FB8DF0B5`，2026-08-27 那一節。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/config-spec.tsv` | 設定規格表是 `jsc-cli` 部署與體檢讀的清單正本。`JSC_PR_WATCH_INTERVAL` 沒登錄，體檢就看不到它，使用者也無從得知有這個旋鈕可以調 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 讀表的行為跟著變，版本要往上走；三份同步升到 0.1.7 | ## 設計重點 - 只加一列，不動表的結構。欄位順序與既有各列相同：型別 `env`、全域、非必填、預設 `60`、檢查方式 `set`、缺少時 `ask`。 - 非必填加預設值，是因為缺少它不該擋住任何流程——`pr-watch.sh` 自己就以 60 秒為預設，這一列只是把預設寫成可查的事實。 - 說明點名實作位置在 `jsc-gitea/tools/pr-watch.sh`。行為的正本在腳本裡，表只負責讓人找得到它。 - 排在 `JSC_VERSION_TTL` 之後，與其他控制輪詢與快取的旋鈕放在一起。 ## 測試結果 - `tools/config-spec.tsv` 以定位字元分欄，新列的欄數與既有各列一致，`git diff` 顯示只新增一列、沒有動到其他行。 - `ste100-lint.sh .`：全庫零命中。 - 三份 manifest 以 JSON 解析器讀過，格式正確且版本一致為 0.1.7。 - 未測：`jsc-cli:deploy` 與環境體檢實際讀這一列的行為，需要已安裝的 CLI 與可連線的 marketplace，本次在沒有 Gitea 存取的環境進行。 ## 前置 Push Request - plugins/gitea#22 https://gitea.jsc.idv.tw/plugins/gitea/pulls/22（本 PR 用到的 `pr-get`、`pr-edit` 在那支）

jiantw83 added 2 commits 2026-08-27 03:21:24 +00:00

feat(config-spec): 登錄 JSC_PR_WATCH_INTERVAL 設定項 ffff2152c2

What：`tools/config-spec.tsv` 新增一列 `JSC_PR_WATCH_INTERVAL`：型別 `env`、全域、非必填、預設 `60`、檢查方式 `set`、缺少時 `ask`，說明寫明它是 `pr-watch.sh` 輪詢 PR 狀態的間隔秒數，實作在 `jsc-gitea/tools/pr-watch.sh`。

Why：設定規格表是 jsc 環境變數的清單正本，`jsc-cli` 的部署與體檢都讀它。新變數沒登錄進來，體檢就看不到它，使用者也無從得知有這個旋鈕可以調。

How：只加一列，排在同為 `jsc-hooks` 系列旋鈕的 `JSC_VERSION_TTL` 之後，欄位順序與既有各列相同；說明點名實作位置，讀表的人才知道去哪裡查行為。

Who：`jsc-cli:deploy` 與環境體檢，以及要調整盯 PR 頻率的使用者。

chore(manifest): 三份 manifest 版本升到 0.1.7 bbd48b5d95

What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.6 改為 0.1.7。

Why：設定規格表新增一個環境變數，讀表的部署與體檢行為跟著變，版本要往上走，各 CLI 才知道要更新。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-cli` 外掛的套件描述檔。

jiantw83 added a new dependency 2026-08-27 03:21:32 +00:00

plugins/gitea#22 - feat(gitea): PR 盯場輪詢與 PR 讀取編修子指令

admin merged commit 96cd7bd14d into feat/sdlc-flow-rules/main

2026-08-27 03:26:27 +00:00

admin deleted branch feat/sdlc-flow-rules/config-spec-pr-watch

2026-08-27 03:26:27 +00:00

jiantw83 referenced this pull request

2026-08-27 03:38:56 +00:00

feat(cli): 設定規格登錄 PR 盯場輪詢間隔 #23

Sign in to join this conversation.