From fcecc558b22f9c2d86ba5f9799d6186a451b4c87 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 11:43:58 +0800 Subject: [PATCH 01/27] =?UTF-8?q?fix(code-action-docker):=20=E8=A8=8A?= =?UTF-8?q?=E6=81=AF=E6=A0=BC=E5=BC=8F=E5=B0=8D=E9=BD=8A=20doc-funcs=20?= =?UTF-8?q?=E8=A6=8F=E7=AF=84=EF=BC=88[=E9=9A=8E=E6=AE=B5][=E7=AD=89?= =?UTF-8?q?=E7=B4=9A][=E6=99=82=E9=96=93]:=20=E8=A8=8A=E6=81=AF=EF=BC=8C?= =?UTF-8?q?=E9=9A=8E=E6=AE=B5=E9=81=B8=E5=A1=AB=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- skills/code-action-docker/SKILL.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index e158dd3..b14c82a 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,6 +1,6 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 +description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 argument-hint: "[--action-dir ] [--node-version ]" --- @@ -13,7 +13,7 @@ argument-hint: "[--action-dir ] [--node-version ]" | 1. 詢問 action 名稱 | 向使用者詢問 action 名稱 → 寫入 `action.yml` 的 `name` | | 2. 詢問輸入與輸出參數 | 逐一收齊 `inputs`／`outputs`（名稱、description、required、default）→ description 盡量繁體中文、無亂碼 | | 3. 詢問流程目標 | 詢問此 action 要達成什麼 → 整理並**濃縮成一句話**，經使用者確認後寫入 `action.yml` 的 `description`（盡量繁體中文、無亂碼） | -| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | +| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[階段][等級][時間]: 訊息`（doc-funcs 規範）；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | | 5. 檢查 doc-funcs | 有 doc-funcs 技能 → 完整執行 `/jsc:doc-funcs`；沒有 → 回報後結束 | --- @@ -91,15 +91,15 @@ argument-hint: "[--action-dir ] [--node-version ]" ### 4.2 盡量詳細輸出訊息，格式統一 - 執行過程**盡量詳細輸出**：開始／結束、讀到的輸入、每個關鍵步驟、外部指令與結果、寫出的輸出、警告與錯誤。 -- 每一則訊息格式固定為： +- 每一則訊息格式固定為（與 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範一致）： ``` - [yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息 + [階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息 ``` - - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 - - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`）；**沒有階段時整個 `[階段]` 區塊移除**，即 `[yyyy/MM/dd HH:mm:ss][等級]: 訊息`。 + - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`），選填；**沒有階段時整個 `[階段]` 區塊移除**，即 `[等級][yyyy/MM/dd HH:mm:ss]: 訊息`。 - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 + - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 - **一行一則訊息**：每則訊息獨立一行輸出，不得多則併成一坨。 - 在 `src/logger.js` 實作共用 logger（產生時間戳、組合前綴、`INF`/`WRN`/`ERR`/`TRC`/`DBG` 各一個方法、可帶階段名稱），主程式一律經由它輸出；`ERR` 走 `console.error`，其餘走 `console.log`。 - 錯誤處理：可預期錯誤輸出 `ERR` 訊息並 `process.exit(1)`；未捕捉例外亦須被攔截（`process.on('uncaughtException'/'unhandledRejection')`）以 `ERR` 格式輸出後非零結束。 @@ -136,9 +136,9 @@ runs: set -e # action 啟動訊息：名稱／用途／更新時間（此檔由 code-action-docker 產生） -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: Action：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 用途：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 更新時間：<產生當下 Asia/Taipei 時間>" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: Action：" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 用途：" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 更新時間：<產生當下 Asia/Taipei 時間>" # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code） exec node /action/src/index.js "$@" @@ -197,7 +197,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] 實作完成後，檢查目前環境是否有 **doc-funcs** 技能（可用 skill 清單中是否存在 `doc-funcs`，含 `/jsc:doc-funcs` 等帶前綴形式）： -- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。既有訊息一律維持本 skill 4.2 的 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息` 格式，不得被改寫成其他欄位順序。 +- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。本 skill 4.2 的訊息格式即 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範，兩者一致，doc-funcs 流程覆蓋指令檔時直接沿用。 - **沒有** → 回報「未偵測到 doc-funcs 技能，略過文件化」後**結束**，不自行模擬 doc-funcs 流程。 --- -- 2.53.0 From c16762ced340cb03d171c489c6ce9c782393e228 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 11:43:58 +0800 Subject: [PATCH 02/27] =?UTF-8?q?docs(README):=20=E5=90=8C=E6=AD=A5=20code?= =?UTF-8?q?-action-docker=20=E8=A8=8A=E6=81=AF=E6=A0=BC=E5=BC=8F=E7=82=BA?= =?UTF-8?q?=20doc-funcs=20=E8=A6=8F=E7=AF=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2864a39..d94a184 100644 --- a/README.md +++ b/README.md @@ -235,7 +235,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（Asia/Taipei；階段選填、無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 -- 2.53.0 From 223dc0c53202824ecea730f423710c81495bf070 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:28:47 +0800 Subject: [PATCH 03/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-action-docker=20=E8=A8=8A=E6=81=AF=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F=E7=82=BA=20doc-funcs=20=E8=A6=8F=E7=AF=84"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit c16762ced340cb03d171c489c6ce9c782393e228. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d94a184..2864a39 100644 --- a/README.md +++ b/README.md @@ -235,7 +235,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（Asia/Taipei；階段選填、無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 -- 2.53.0 From c9b2e12711e78f4a1cef304013d496d4d5c08aff Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:28:47 +0800 Subject: [PATCH 04/27] =?UTF-8?q?Revert=20"fix(code-action-docker):=20?= =?UTF-8?q?=E8=A8=8A=E6=81=AF=E6=A0=BC=E5=BC=8F=E5=B0=8D=E9=BD=8A=20doc-fu?= =?UTF-8?q?ncs=20=E8=A6=8F=E7=AF=84=EF=BC=88[=E9=9A=8E=E6=AE=B5][=E7=AD=89?= =?UTF-8?q?=E7=B4=9A][=E6=99=82=E9=96=93]:=20=E8=A8=8A=E6=81=AF=EF=BC=8C?= =?UTF-8?q?=E9=9A=8E=E6=AE=B5=E9=81=B8=E5=A1=AB=EF=BC=89"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit fcecc558b22f9c2d86ba5f9799d6186a451b4c87. --- skills/code-action-docker/SKILL.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index b14c82a..e158dd3 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,6 +1,6 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 +description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 argument-hint: "[--action-dir ] [--node-version ]" --- @@ -13,7 +13,7 @@ argument-hint: "[--action-dir ] [--node-version ]" | 1. 詢問 action 名稱 | 向使用者詢問 action 名稱 → 寫入 `action.yml` 的 `name` | | 2. 詢問輸入與輸出參數 | 逐一收齊 `inputs`／`outputs`（名稱、description、required、default）→ description 盡量繁體中文、無亂碼 | | 3. 詢問流程目標 | 詢問此 action 要達成什麼 → 整理並**濃縮成一句話**，經使用者確認後寫入 `action.yml` 的 `description`（盡量繁體中文、無亂碼） | -| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[階段][等級][時間]: 訊息`（doc-funcs 規範）；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | +| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | | 5. 檢查 doc-funcs | 有 doc-funcs 技能 → 完整執行 `/jsc:doc-funcs`；沒有 → 回報後結束 | --- @@ -91,15 +91,15 @@ argument-hint: "[--action-dir ] [--node-version ]" ### 4.2 盡量詳細輸出訊息，格式統一 - 執行過程**盡量詳細輸出**：開始／結束、讀到的輸入、每個關鍵步驟、外部指令與結果、寫出的輸出、警告與錯誤。 -- 每一則訊息格式固定為（與 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範一致）： +- 每一則訊息格式固定為： ``` - [階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息 + [yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息 ``` - - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`），選填；**沒有階段時整個 `[階段]` 區塊移除**，即 `[等級][yyyy/MM/dd HH:mm:ss]: 訊息`。 - - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 + - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`）；**沒有階段時整個 `[階段]` 區塊移除**，即 `[yyyy/MM/dd HH:mm:ss][等級]: 訊息`。 + - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 - **一行一則訊息**：每則訊息獨立一行輸出，不得多則併成一坨。 - 在 `src/logger.js` 實作共用 logger（產生時間戳、組合前綴、`INF`/`WRN`/`ERR`/`TRC`/`DBG` 各一個方法、可帶階段名稱），主程式一律經由它輸出；`ERR` 走 `console.error`，其餘走 `console.log`。 - 錯誤處理：可預期錯誤輸出 `ERR` 訊息並 `process.exit(1)`；未捕捉例外亦須被攔截（`process.on('uncaughtException'/'unhandledRejection')`）以 `ERR` 格式輸出後非零結束。 @@ -136,9 +136,9 @@ runs: set -e # action 啟動訊息：名稱／用途／更新時間（此檔由 code-action-docker 產生） -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: Action：" -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 用途：" -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 更新時間：<產生當下 Asia/Taipei 時間>" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: Action：" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 用途：" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 更新時間：<產生當下 Asia/Taipei 時間>" # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code） exec node /action/src/index.js "$@" @@ -197,7 +197,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] 實作完成後，檢查目前環境是否有 **doc-funcs** 技能（可用 skill 清單中是否存在 `doc-funcs`，含 `/jsc:doc-funcs` 等帶前綴形式）： -- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。本 skill 4.2 的訊息格式即 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範，兩者一致，doc-funcs 流程覆蓋指令檔時直接沿用。 +- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。既有訊息一律維持本 skill 4.2 的 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息` 格式，不得被改寫成其他欄位順序。 - **沒有** → 回報「未偵測到 doc-funcs 技能，略過文件化」後**結束**，不自行模擬 doc-funcs 流程。 --- -- 2.53.0 From 379750aa9b7bbf450918e85e6a6354db220eb356 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 05/27] =?UTF-8?q?Reapply=20"fix(code-action-docker):=20?= =?UTF-8?q?=E8=A8=8A=E6=81=AF=E6=A0=BC=E5=BC=8F=E5=B0=8D=E9=BD=8A=20doc-fu?= =?UTF-8?q?ncs=20=E8=A6=8F=E7=AF=84=EF=BC=88[=E9=9A=8E=E6=AE=B5][=E7=AD=89?= =?UTF-8?q?=E7=B4=9A][=E6=99=82=E9=96=93]:=20=E8=A8=8A=E6=81=AF=EF=BC=8C?= =?UTF-8?q?=E9=9A=8E=E6=AE=B5=E9=81=B8=E5=A1=AB=EF=BC=89"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit c9b2e12711e78f4a1cef304013d496d4d5c08aff. --- skills/code-action-docker/SKILL.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index e158dd3..b14c82a 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,6 +1,6 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 +description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 argument-hint: "[--action-dir ] [--node-version ]" --- @@ -13,7 +13,7 @@ argument-hint: "[--action-dir ] [--node-version ]" | 1. 詢問 action 名稱 | 向使用者詢問 action 名稱 → 寫入 `action.yml` 的 `name` | | 2. 詢問輸入與輸出參數 | 逐一收齊 `inputs`／`outputs`（名稱、description、required、default）→ description 盡量繁體中文、無亂碼 | | 3. 詢問流程目標 | 詢問此 action 要達成什麼 → 整理並**濃縮成一句話**，經使用者確認後寫入 `action.yml` 的 `description`（盡量繁體中文、無亂碼） | -| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | +| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[階段][等級][時間]: 訊息`（doc-funcs 規範）；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | | 5. 檢查 doc-funcs | 有 doc-funcs 技能 → 完整執行 `/jsc:doc-funcs`；沒有 → 回報後結束 | --- @@ -91,15 +91,15 @@ argument-hint: "[--action-dir ] [--node-version ]" ### 4.2 盡量詳細輸出訊息，格式統一 - 執行過程**盡量詳細輸出**：開始／結束、讀到的輸入、每個關鍵步驟、外部指令與結果、寫出的輸出、警告與錯誤。 -- 每一則訊息格式固定為： +- 每一則訊息格式固定為（與 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範一致）： ``` - [yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息 + [階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息 ``` - - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 - - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`）；**沒有階段時整個 `[階段]` 區塊移除**，即 `[yyyy/MM/dd HH:mm:ss][等級]: 訊息`。 + - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`），選填；**沒有階段時整個 `[階段]` 區塊移除**，即 `[等級][yyyy/MM/dd HH:mm:ss]: 訊息`。 - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 + - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 - **一行一則訊息**：每則訊息獨立一行輸出，不得多則併成一坨。 - 在 `src/logger.js` 實作共用 logger（產生時間戳、組合前綴、`INF`/`WRN`/`ERR`/`TRC`/`DBG` 各一個方法、可帶階段名稱），主程式一律經由它輸出；`ERR` 走 `console.error`，其餘走 `console.log`。 - 錯誤處理：可預期錯誤輸出 `ERR` 訊息並 `process.exit(1)`；未捕捉例外亦須被攔截（`process.on('uncaughtException'/'unhandledRejection')`）以 `ERR` 格式輸出後非零結束。 @@ -136,9 +136,9 @@ runs: set -e # action 啟動訊息：名稱／用途／更新時間（此檔由 code-action-docker 產生） -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: Action：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 用途：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 更新時間：<產生當下 Asia/Taipei 時間>" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: Action：" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 用途：" +echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 更新時間：<產生當下 Asia/Taipei 時間>" # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code） exec node /action/src/index.js "$@" @@ -197,7 +197,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] 實作完成後，檢查目前環境是否有 **doc-funcs** 技能（可用 skill 清單中是否存在 `doc-funcs`，含 `/jsc:doc-funcs` 等帶前綴形式）： -- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。既有訊息一律維持本 skill 4.2 的 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息` 格式，不得被改寫成其他欄位順序。 +- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。本 skill 4.2 的訊息格式即 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範，兩者一致，doc-funcs 流程覆蓋指令檔時直接沿用。 - **沒有** → 回報「未偵測到 doc-funcs 技能，略過文件化」後**結束**，不自行模擬 doc-funcs 流程。 --- -- 2.53.0 From b26470981550969baea505be379f98d8ed4ea9e3 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 06/27] =?UTF-8?q?Reapply=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-action-docker=20=E8=A8=8A=E6=81=AF=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F=E7=82=BA=20doc-funcs=20=E8=A6=8F=E7=AF=84"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 223dc0c53202824ecea730f423710c81495bf070. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2864a39..d94a184 100644 --- a/README.md +++ b/README.md @@ -235,7 +235,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（Asia/Taipei；階段選填、無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 -- 2.53.0 From 2d73b3121ef314b40b3ed45e9c2d6862909ea1ca Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 07/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-action-docker=20=E8=A8=8A=E6=81=AF=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F=E7=82=BA=20doc-funcs=20=E8=A6=8F=E7=AF=84"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit c16762ced340cb03d171c489c6ce9c782393e228. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d94a184..2864a39 100644 --- a/README.md +++ b/README.md @@ -235,7 +235,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（Asia/Taipei；階段選填、無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 -- 2.53.0 From 32e78325273c704a848e0c3f742f62ae5fc52b53 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 08/27] =?UTF-8?q?Revert=20"fix(code-action-docker):=20?= =?UTF-8?q?=E8=A8=8A=E6=81=AF=E6=A0=BC=E5=BC=8F=E5=B0=8D=E9=BD=8A=20doc-fu?= =?UTF-8?q?ncs=20=E8=A6=8F=E7=AF=84=EF=BC=88[=E9=9A=8E=E6=AE=B5][=E7=AD=89?= =?UTF-8?q?=E7=B4=9A][=E6=99=82=E9=96=93]:=20=E8=A8=8A=E6=81=AF=EF=BC=8C?= =?UTF-8?q?=E9=9A=8E=E6=AE=B5=E9=81=B8=E5=A1=AB=EF=BC=89"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit fcecc558b22f9c2d86ba5f9799d6186a451b4c87. --- skills/code-action-docker/SKILL.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index b14c82a..e158dd3 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,6 +1,6 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 doc-funcs 規範的 `[階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 +description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 argument-hint: "[--action-dir ] [--node-version ]" --- @@ -13,7 +13,7 @@ argument-hint: "[--action-dir ] [--node-version ]" | 1. 詢問 action 名稱 | 向使用者詢問 action 名稱 → 寫入 `action.yml` 的 `name` | | 2. 詢問輸入與輸出參數 | 逐一收齊 `inputs`／`outputs`（名稱、description、required、default）→ description 盡量繁體中文、無亂碼 | | 3. 詢問流程目標 | 詢問此 action 要達成什麼 → 整理並**濃縮成一句話**，經使用者確認後寫入 `action.yml` 的 `description`（盡量繁體中文、無亂碼） | -| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[階段][等級][時間]: 訊息`（doc-funcs 規範）；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | +| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | | 5. 檢查 doc-funcs | 有 doc-funcs 技能 → 完整執行 `/jsc:doc-funcs`；沒有 → 回報後結束 | --- @@ -91,15 +91,15 @@ argument-hint: "[--action-dir ] [--node-version ]" ### 4.2 盡量詳細輸出訊息，格式統一 - 執行過程**盡量詳細輸出**：開始／結束、讀到的輸入、每個關鍵步驟、外部指令與結果、寫出的輸出、警告與錯誤。 -- 每一則訊息格式固定為（與 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範一致）： +- 每一則訊息格式固定為： ``` - [階段][等級][yyyy/MM/dd HH:mm:ss]: 訊息 + [yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息 ``` - - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`），選填；**沒有階段時整個 `[階段]` 區塊移除**，即 `[等級][yyyy/MM/dd HH:mm:ss]: 訊息`。 - - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 + - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`）；**沒有階段時整個 `[階段]` 區塊移除**，即 `[yyyy/MM/dd HH:mm:ss][等級]: 訊息`。 + - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 - **一行一則訊息**：每則訊息獨立一行輸出，不得多則併成一坨。 - 在 `src/logger.js` 實作共用 logger（產生時間戳、組合前綴、`INF`/`WRN`/`ERR`/`TRC`/`DBG` 各一個方法、可帶階段名稱），主程式一律經由它輸出；`ERR` 走 `console.error`，其餘走 `console.log`。 - 錯誤處理：可預期錯誤輸出 `ERR` 訊息並 `process.exit(1)`；未捕捉例外亦須被攔截（`process.on('uncaughtException'/'unhandledRejection')`）以 `ERR` 格式輸出後非零結束。 @@ -136,9 +136,9 @@ runs: set -e # action 啟動訊息：名稱／用途／更新時間（此檔由 code-action-docker 產生） -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: Action：" -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 用途：" -echo "[啟動][INF][<產生當下 Asia/Taipei 時間>]: 更新時間：<產生當下 Asia/Taipei 時間>" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: Action：" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 用途：" +echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 更新時間：<產生當下 Asia/Taipei 時間>" # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code） exec node /action/src/index.js "$@" @@ -197,7 +197,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] 實作完成後，檢查目前環境是否有 **doc-funcs** 技能（可用 skill 清單中是否存在 `doc-funcs`，含 `/jsc:doc-funcs` 等帶前綴形式）： -- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。本 skill 4.2 的訊息格式即 doc-funcs 第 6 步的 `[{階段}?][{等級}][{時間}]: {訊息}` 規範，兩者一致，doc-funcs 流程覆蓋指令檔時直接沿用。 +- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。既有訊息一律維持本 skill 4.2 的 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息` 格式，不得被改寫成其他欄位順序。 - **沒有** → 回報「未偵測到 doc-funcs 技能，略過文件化」後**結束**，不自行模擬 doc-funcs 流程。 --- -- 2.53.0 From fc72f931a1a85782880a3abb194ca2eedc61ab7e Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 09/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-issues=20=E6=AF=8D=E8=AD=B0=E9=A1=8C=20TODO=20?= =?UTF-8?q?=E5=8B=BE=E9=81=B8=E8=AA=AA=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit bff191e3d370b9860204a1b305b685b2cc5f381c. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2864a39..c9554b4 100644 --- a/README.md +++ b/README.md @@ -205,7 +205,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-issues` -處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言；議題**有母議題**時，實作完成後把母議題 checklist 中**引用本議題的 TODO 項目一併勾選**並留言告知（無法明確對應的項目不硬勾）。議題若**屬於專案看板**且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度**同步移動議題欄位**（彙整需求「分析中」→ TODO 確定「待處理」→ 開始實作「進行中」→ 實作完成且驗證通過「待測試」；「已完成」僅在使用者確認時；不屬於專案、無可對應欄位或 API 不支援則回報並略過）。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。 +處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言。議題若**屬於專案看板**且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度**同步移動議題欄位**（彙整需求「分析中」→ TODO 確定「待處理」→ 開始實作「進行中」→ 實作完成且驗證通過「待測試」；「已完成」僅在使用者確認時；不屬於專案、無可對應欄位或 API 不支援則回報並略過）。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。 參數：`[--tool ] [--repo ] [--issues <編號,以逗號分隔>] [--host ] [--yes]`（帶 `--tool`／`--repo`／`--issues` 時跳過對應詢問；`--yes` 略過一般確認）。 -- 2.53.0 From 68a3410f1eaf1d617c63d2b10809d97ff4323b18 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 10/27] =?UTF-8?q?Revert=20"feat(code-issues):=20=E5=AF=A6?= =?UTF-8?q?=E4=BD=9C=E5=AE=8C=E6=88=90=E5=BE=8C=E5=90=8C=E6=AD=A5=E8=AD=B0?= =?UTF-8?q?=E9=A1=8C=20TODO=20=E5=8B=BE=E9=81=B8=E7=8B=80=E6=85=8B?= =?UTF-8?q?=EF=BC=8C=E6=9C=89=E6=AF=8D=E8=AD=B0=E9=A1=8C=E6=99=82=E4=B8=80?= =?UTF-8?q?=E4=BD=B5=E5=8B=BE=E9=81=B8=E6=AF=8D=E8=AD=B0=E9=A1=8C=E5=B0=8D?= =?UTF-8?q?=E6=87=89=E9=A0=85=E7=9B=AE=E4=B8=A6=E7=95=99=E8=A8=80=E5=91=8A?= =?UTF-8?q?=E7=9F=A5"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 0e97646535ff76e36c533f30bbd987a7d906ae46. --- skills/code-issues/SKILL.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/skills/code-issues/SKILL.md b/skills/code-issues/SKILL.md index 981ecf7..548adbe 100644 --- a/skills/code-issues/SKILL.md +++ b/skills/code-issues/SKILL.md @@ -1,6 +1,6 @@ --- name: code-issues -description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就到議題勾選該 TODO 的 checkbox 並把進度留言到議題；議題若有母議題，實作完成後母議題 checklist 中引用本議題的 TODO 項目也要一併勾選並留言告知。議題若屬於專案看板且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度同步把議題移到對應欄位（彙整需求時「分析中」、TODO 確定「待處理」、開始實作「進行中」、實作完成且驗證通過「待測試」，「已完成」僅在使用者確認時）。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言、調整議題看板欄位進度，或提到 code-issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 doc-issues-analyze）、只同步議題狀態不實作（用 doc-issues-sync）、或與 Gitea 無關的本機 TODO 管理。 +description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就把進度留言到議題。議題若屬於專案看板且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度同步把議題移到對應欄位（彙整需求時「分析中」、TODO 確定「待處理」、開始實作「進行中」、實作完成且驗證通過「待測試」，「已完成」僅在使用者確認時）。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言、調整議題看板欄位進度，或提到 code-issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 doc-issues-analyze）、只同步議題狀態不實作（用 doc-issues-sync）、或與 Gitea 無關的本機 TODO 管理。 argument-hint: "[--tool ] [--repo ] [--issues <編號,以逗號分隔>] [--host ] [--yes]" --- @@ -14,7 +14,7 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 | B. 確認專案 | 詢問議題所在專案（owner/repo），可用目前 repo 的 origin 當預設選項 | 已知專案（`--repo`、對話已提供、或使用者確認採用 origin）| | C. 選擇議題 | 詢問要處理的議題編號，**一個或多個** | 已提供（`--issues` 或對話中已列出）| | D. 彙整 TODO | 讀議題描述＋留言 → 彙整需求 → TODO 依**影響範圍小→大**排序 → 不足以達成需求的缺漏 TODO **附加到議題描述** | — | -| E. 逐項實作 | 依排序實作每項 TODO → 每完成一項：勾選議題描述 checkbox ＋ **留言進度到議題** → 全部完成後**同步母議題 TODO 狀態**（若有母議題） | — | +| E. 逐項實作 | 依排序實作每項 TODO → 每完成一項：勾選議題描述 checkbox ＋ **留言進度到議題** | — | 議題若**屬於專案看板**且看板有「分析中／待處理／進行中／待測試／已完成」欄位可調整，階段 D／E 需依處理進度**同步調整議題所在欄位**（見「議題進度欄位調整」）。 @@ -99,7 +99,6 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 - `api`：`GET {base}/issues/{index}` 與 `GET {base}/issues/{index}/comments` - 留言中若有需求補充、變更或取消，必須納入需求彙整，並以最新留言為準。 - 一併確認**議題是否屬於專案看板（project）**與看板有哪些欄位（column）：`tea` 不支援 project 操作，一律改走 API（需 `GITEA_TOKEN`）；project／column API 隨 Gitea 版本差異大，先探測可用性（如 `GET {base}/projects`、議題回應中的 project 資訊），**不可用時記錄並略過欄位調整**，不影響其餘流程。 -- 一併確認**議題是否有母議題**：檢查議題描述／留言中的「屬於 #n」「parent: #n」等引用、timeline 的 cross-reference（`GET {base}/issues/{index}/timeline`）、或依賴關係 API；找到候選母議題時讀取其描述，確認其 checklist 是否有引用本議題（如 `- [ ] #<本議題編號>`）或語意對應本議題的 TODO 項目，記錄母議題編號與對應項目。無法確定時可詢問使用者；找不到就記錄「無母議題」，不臆測。 ### 議題進度欄位調整（議題屬於專案看板時） @@ -153,13 +152,12 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 1. **實作**：在本機 repo 依 TODO 內容實作，只修改該 TODO 必要範圍；發現需要擴大範圍或牽動其他 TODO 時，先停止並詢問使用者。開始實作該議題第一項 TODO 前，若議題屬於專案看板，依「議題進度欄位調整」把議題移到「進行中」。 2. **驗證**：執行適合專案的建置／測試／驗證；失敗時修正到通過，無法通過則記錄原因並在留言中標註「待人工處理」。 -3. **更新議題 TODO 狀態**：實作完成（驗證通過）後，把議題描述中該 TODO 的 checkbox 由 `- [ ]` 勾成 `- [x]`（同 D4 的更新方式）；未通過驗證的 TODO 不得勾選。若母議題的 checklist 有**對應到本項 TODO** 的項目，一併勾選。 +3. **更新議題描述**：把該 TODO 的 checkbox 由 `- [ ]` 勾成 `- [x]`（同 D4 的更新方式）。 4. **留言進度到議題**（每完成一項就留言，不可累積到最後一次補）： - `tea`：`tea comment --repo / <內容>` - `api`：`POST {base}/issues/{index}/comments`，body 以 UTF-8 JSON 檔帶入 - 留言內容以表格呈現：本項 TODO、影響範圍、主要變更（檔案／模組）、驗證方式與結果、整體進度（`已完成 n/總數 m`）；有助理解時附 Mermaid 圖。 5. 全部 TODO 完成後，對每個議題留下**總結留言**：TODO 完成統計表、變更檔案清單、驗證總結、待人工處理項目（若有）；若議題屬於專案看板且全部 TODO 實作完成並驗證通過，把議題移到「待測試」（有待人工處理項目時停留在「進行中」）。 -6. **同步母議題 TODO 狀態**（D1 有記錄母議題時）：本議題全部 TODO 實作完成且驗證通過後，更新母議題描述，把其 checklist 中**引用本議題的項目**（如 `- [ ] #<本議題編號>`）勾成 `- [x]`（同 D4 的更新方式，保留母議題其餘內容不動），並在母議題留言告知「子議題 #<編號> 已實作完成」與總結留言連結。母議題 checklist 以其他文字描述本議題時做就近語意對應；**無法明確對應的項目不硬勾**，回報並略過。本議題尚有待人工處理項目時不得勾選母議題對應項目。 > 本 skill 範圍到「實作＋留言」為止；是否 commit、push、開 PR 或關閉議題**不在本 skill 自動範圍**，由使用者另行指示（可搭配 `code-review-resolve` 的分類提交與 PR 流程）。 @@ -175,7 +173,6 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 - **階段 D**：每個議題的需求彙整重點、TODO 列表（含影響範圍排序）、新增了幾項 TODO 並是否已附加到議題描述。 - **階段 E**：每項 TODO 的完成狀態與留言連結（或編號）、驗證結果、待人工處理項目；提醒後續可自行決定 commit／PR／關閉議題。 - **欄位調整**：議題是否屬於專案看板、各議題的欄位移動紀錄（`#n：<原欄位> → <新欄位>`），或略過欄位調整的原因（不屬於專案／無可對應欄位／API 不支援）。 -- **母議題同步**：各議題是否有母議題、母議題 checklist 勾選了哪些項目與留言連結，或略過同步的原因（無母議題／無法明確對應／尚有待人工處理項目）。 --- -- 2.53.0 From 7f4eaeb258a8caa73d9aa94b7500037eefc56342 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 11/27] =?UTF-8?q?Revert=20"chore(plugin=20=E7=89=88?= =?UTF-8?q?=E6=9C=AC):=20=E4=B8=89=E5=AE=B6=20manifest=20=E5=8D=87?= =?UTF-8?q?=E7=89=88=200.0.4"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit b935be26d9a6fb00020554af4beabfa06f287486. --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index d940f1d..39f2e1a 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.4", + "version": "0.0.3", "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 1de2ca1..3a60f73 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.4", + "version": "0.0.3", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 9407187..7b72e26 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.4", + "version": "0.0.3", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0 From c98b06bca76d6b6b8120402c299f976c621041ae Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 12/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-issues=20=E8=AD=B0=E9=A1=8C=E7=9C=8B=E6=9D=BF?= =?UTF-8?q?=E6=AC=84=E4=BD=8D=E9=80=B2=E5=BA=A6=E8=AA=AA=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 5e47ea938ff61ad13d6660ee2be51a84165f896b. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c9554b4..116ebf5 100644 --- a/README.md +++ b/README.md @@ -205,7 +205,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-issues` -處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言。議題若**屬於專案看板**且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度**同步移動議題欄位**（彙整需求「分析中」→ TODO 確定「待處理」→ 開始實作「進行中」→ 實作完成且驗證通過「待測試」；「已完成」僅在使用者確認時；不屬於專案、無可對應欄位或 API 不支援則回報並略過）。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。 +處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。 參數：`[--tool ] [--repo ] [--issues <編號,以逗號分隔>] [--host ] [--yes]`（帶 `--tool`／`--repo`／`--issues` 時跳過對應詢問；`--yes` 略過一般確認）。 -- 2.53.0 From c757bdc67474f2784a4aec505c04179716472fa7 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 13/27] =?UTF-8?q?Revert=20"feat(code-issues):=20=E8=AD=B0?= =?UTF-8?q?=E9=A1=8C=E5=B1=AC=E6=96=BC=E5=B0=88=E6=A1=88=E7=9C=8B=E6=9D=BF?= =?UTF-8?q?=E6=99=82=E4=BE=9D=E8=99=95=E7=90=86=E9=80=B2=E5=BA=A6=E8=AA=BF?= =?UTF-8?q?=E6=95=B4=E6=AC=84=E4=BD=8D=EF=BC=88=E5=88=86=E6=9E=90=E4=B8=AD?= =?UTF-8?q?=E2=86=92=E5=BE=85=E8=99=95=E7=90=86=E2=86=92=E9=80=B2=E8=A1=8C?= =?UTF-8?q?=E4=B8=AD=E2=86=92=E5=BE=85=E6=B8=AC=E8=A9=A6=E2=86=92=E5=B7=B2?= =?UTF-8?q?=E5=AE=8C=E6=88=90=EF=BC=89"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 5633993d7f10d3aa2e080919926396fe8b5fd59e. --- skills/code-issues/SKILL.md | 27 +++------------------------ 1 file changed, 3 insertions(+), 24 deletions(-) diff --git a/skills/code-issues/SKILL.md b/skills/code-issues/SKILL.md index 548adbe..c2320f3 100644 --- a/skills/code-issues/SKILL.md +++ b/skills/code-issues/SKILL.md @@ -1,6 +1,6 @@ --- name: code-issues -description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就把進度留言到議題。議題若屬於專案看板且有「分析中／待處理／進行中／待測試／已完成」欄位可調整，依處理進度同步把議題移到對應欄位（彙整需求時「分析中」、TODO 確定「待處理」、開始實作「進行中」、實作完成且驗證通過「待測試」，「已完成」僅在使用者確認時）。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言、調整議題看板欄位進度，或提到 code-issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 doc-issues-analyze）、只同步議題狀態不實作（用 doc-issues-sync）、或與 Gitea 無關的本機 TODO 管理。 +description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就把進度留言到議題。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言，或提到 code-issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 doc-issues-analyze）、只同步議題狀態不實作（用 doc-issues-sync）、或與 Gitea 無關的本機 TODO 管理。 argument-hint: "[--tool ] [--repo ] [--issues <編號,以逗號分隔>] [--host ] [--yes]" --- @@ -16,8 +16,6 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 | D. 彙整 TODO | 讀議題描述＋留言 → 彙整需求 → TODO 依**影響範圍小→大**排序 → 不足以達成需求的缺漏 TODO **附加到議題描述** | — | | E. 逐項實作 | 依排序實作每項 TODO → 每完成一項：勾選議題描述 checkbox ＋ **留言進度到議題** | — | -議題若**屬於專案看板**且看板有「分析中／待處理／進行中／待測試／已完成」欄位可調整，階段 D／E 需依處理進度**同步調整議題所在欄位**（見「議題進度欄位調整」）。 - --- ## 絕對準則（不可違反） @@ -98,24 +96,6 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 - `tea`：`tea issues --repo / --comments` - `api`：`GET {base}/issues/{index}` 與 `GET {base}/issues/{index}/comments` - 留言中若有需求補充、變更或取消，必須納入需求彙整，並以最新留言為準。 -- 一併確認**議題是否屬於專案看板（project）**與看板有哪些欄位（column）：`tea` 不支援 project 操作，一律改走 API（需 `GITEA_TOKEN`）；project／column API 隨 Gitea 版本差異大，先探測可用性（如 `GET {base}/projects`、議題回應中的 project 資訊），**不可用時記錄並略過欄位調整**，不影響其餘流程。 - -### 議題進度欄位調整（議題屬於專案看板時） - -議題屬於專案看板、且看板有「**分析中／待處理／進行中／待測試／已完成**」欄位可調整時，依處理進度把議題移到對應欄位；每次移動在輸出中回報「議題 #n：<原欄位> → <新欄位>」。 - -| 時機 | 目標欄位 | -| --- | --- | -| 階段 D 開始彙整需求時 | 分析中 | -| 階段 D 完成（TODO 列表確定）、尚未開始實作 | 待處理 | -| 階段 E 開始實作第一項 TODO | 進行中 | -| 階段 E 全部 TODO 實作完成且驗證通過 | 待測試 | -| 議題需求全數達成且使用者確認無需再測試（或明確指示） | 已完成 | - -- **就近對應**：欄位名稱不完全相同時做語意對應（如「To Do」→ 待處理、「In Progress」→ 進行中、「Done」→ 已完成）；**無法明確對應的欄位不硬移**，回報並略過。 -- **保守推進**：預設最多推進到「待測試」（本 skill 不負責測試與關閉議題）；只有使用者明確指示或議題描述明定無需測試時才移到「已完成」。 -- **只依實際狀態移動**：欄位只反映真實進度，不得先移欄位再補工作；若實作中途停止（待人工處理），欄位停留在「進行中」並於留言註明原因。 -- 議題不屬於任何專案、看板缺少可對應欄位、或 API 不支援移動時 → 回報並略過欄位調整，其餘流程照常。 ### D2. 彙整需求並盤點既有 TODO @@ -150,14 +130,14 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 依 D3 排序（多議題時先完成一個議題的所有 TODO，再進入下一個議題；有跨議題依賴時先處理被依賴者）逐項執行： -1. **實作**：在本機 repo 依 TODO 內容實作，只修改該 TODO 必要範圍；發現需要擴大範圍或牽動其他 TODO 時，先停止並詢問使用者。開始實作該議題第一項 TODO 前，若議題屬於專案看板，依「議題進度欄位調整」把議題移到「進行中」。 +1. **實作**：在本機 repo 依 TODO 內容實作，只修改該 TODO 必要範圍；發現需要擴大範圍或牽動其他 TODO 時，先停止並詢問使用者。 2. **驗證**：執行適合專案的建置／測試／驗證；失敗時修正到通過，無法通過則記錄原因並在留言中標註「待人工處理」。 3. **更新議題描述**：把該 TODO 的 checkbox 由 `- [ ]` 勾成 `- [x]`（同 D4 的更新方式）。 4. **留言進度到議題**（每完成一項就留言，不可累積到最後一次補）： - `tea`：`tea comment --repo / <內容>` - `api`：`POST {base}/issues/{index}/comments`，body 以 UTF-8 JSON 檔帶入 - 留言內容以表格呈現：本項 TODO、影響範圍、主要變更（檔案／模組）、驗證方式與結果、整體進度（`已完成 n/總數 m`）；有助理解時附 Mermaid 圖。 -5. 全部 TODO 完成後，對每個議題留下**總結留言**：TODO 完成統計表、變更檔案清單、驗證總結、待人工處理項目（若有）；若議題屬於專案看板且全部 TODO 實作完成並驗證通過，把議題移到「待測試」（有待人工處理項目時停留在「進行中」）。 +5. 全部 TODO 完成後，對每個議題留下**總結留言**：TODO 完成統計表、變更檔案清單、驗證總結、待人工處理項目（若有）。 > 本 skill 範圍到「實作＋留言」為止；是否 commit、push、開 PR 或關閉議題**不在本 skill 自動範圍**，由使用者另行指示（可搭配 `code-review-resolve` 的分類提交與 PR 流程）。 @@ -172,7 +152,6 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 - **階段 C**：處理的議題編號清單（含標題），是否因已提供而跳過詢問。 - **階段 D**：每個議題的需求彙整重點、TODO 列表（含影響範圍排序）、新增了幾項 TODO 並是否已附加到議題描述。 - **階段 E**：每項 TODO 的完成狀態與留言連結（或編號）、驗證結果、待人工處理項目；提醒後續可自行決定 commit／PR／關閉議題。 -- **欄位調整**：議題是否屬於專案看板、各議題的欄位移動紀錄（`#n：<原欄位> → <新欄位>`），或略過欄位調整的原因（不屬於專案／無可對應欄位／API 不支援）。 --- -- 2.53.0 From c8ecc10dcc9c3ea6503741d89944dd15ffcb170e Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 14/27] =?UTF-8?q?Revert=20"chore(plugin=20=E7=89=88?= =?UTF-8?q?=E6=9C=AC):=20=E4=B8=89=E5=AE=B6=20manifest=20=E5=8D=87?= =?UTF-8?q?=E7=89=88=200.0.3"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit a0b1a37ff918f1d52107656a3be87f3985ec572f. --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 39f2e1a..6bf93cc 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.3", + "version": "0.0.2", "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 3a60f73..05a4486 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.3", + "version": "0.0.2", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 7b72e26..c7c4ae4 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.3", + "version": "0.0.2", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0 From fcc8a96670cce85f692e66210f4819093c00e5b8 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 15/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-action-docker=20=E5=8F=83=E6=95=B8=E4=BE=86?= =?UTF-8?q?=E6=BA=90=E5=84=AA=E5=85=88=E5=BA=8F=E8=AA=AA=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit e76775e703aae85b97e6ee927de73f80aef0d250. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 116ebf5..7b5287d 100644 --- a/README.md +++ b/README.md @@ -235,7 +235,7 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——開發中需要新參數時**依序找 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}`，都沒有才詢問使用者是否加入 `inputs`**；盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 -- 2.53.0 From 5bcd3a877d457f29544cf9cad5a72273a8f3e8be Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 16/27] =?UTF-8?q?Revert=20"feat(code-action-docker):=20?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E9=96=8B=E7=99=BC=E4=B8=AD=E5=8F=83=E6=95=B8?= =?UTF-8?q?=E4=BE=86=E6=BA=90=E5=84=AA=E5=85=88=E5=BA=8F=E8=A6=8F=E5=89=87?= =?UTF-8?q?=EF=BC=88gitea=20=E2=86=92=20secrets=20=E2=86=92=20vars=20?= =?UTF-8?q?=E2=86=92=20=E8=A9=A2=E5=95=8F=E5=8A=A0=E5=85=A5=20inputs?= =?UTF-8?q?=EF=BC=89"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 5930254a5e3f9077a8b7b6d61a40552ef17f500d. --- skills/code-action-docker/SKILL.md | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index e158dd3..9ae4145 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,6 +1,6 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——開發中需要新參數時依 `${{ gitea.* }}` → `${{ secrets.* }}` → `${{ vars.* }}` 順序尋找、都沒有才詢問使用者是否加入 inputs；盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 +description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 argument-hint: "[--action-dir ] [--node-version ]" --- @@ -71,17 +71,6 @@ argument-hint: "[--action-dir ] [--node-version ]" 依階段 1～3 收齊的需求實作 action，遵守以下標準： -### 4.0 開發中需要參數時的來源優先序 - -實作過程中發現需要某個參數（例如 repo 資訊、token、環境設定）而階段 2 的 `inputs` 沒有時，**依下列順序尋找來源，前者可用就不往後找**： - -1. **`${{ gitea.* }}` context**：runner 內建 context（如 `gitea.repository`、`gitea.ref`、`gitea.actor`、`gitea.token`）；docker action 執行期對應 runner 注入的 `GITHUB_*`／`GITEA_*` 環境變數（如 `GITHUB_REPOSITORY`、`GITHUB_REF`），主程式直接讀 `process.env` 即可。 -2. **`${{ secrets.* }}`**：repo／org 的 secrets（機敏值：token、密碼、金鑰）。 -3. **`${{ vars.* }}`**：repo／org 的 variables（非機敏設定值）。 -4. **以上都沒有** → 以 `AskUserQuestion` 詢問使用者**是否要把該參數加入 `inputs`**（加入則回到階段 2 規格補齊名稱／description／required／default，並同步 `action.yml`）；**不得臆測預設值或硬編碼**。 - -注意：`secrets.*`／`vars.*` 無法在 `action.yml` 的 `inputs.default` 直接引用，須由呼叫端 workflow 以 `with:` 或 `env:` 傳入（如 `with: token: ${{ secrets.MY_TOKEN }}`）；採用這類來源時，在 README 使用範例中示範呼叫端如何帶入，機敏值一律不落地、不輸出明文（log 需遮蔽）。 - ### 4.1 盡量以 Node.js 開發，程式檔一律放 `src/` - 主程式與所有模組**盡量以 Node.js 撰寫**；只有目標必須依賴外部工具時，才以 `child_process`（`execFileSync`／`spawnSync`）在 Node 內呼叫，不另寫 shell／python 主程式。 -- 2.53.0 From 38203f17f786f3fc64cff0811a96fb384d50364b Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 17/27] =?UTF-8?q?Revert=20"chore(plugin=20=E7=89=88?= =?UTF-8?q?=E6=9C=AC):=20=E4=B8=89=E5=AE=B6=20manifest=20=E5=8D=87?= =?UTF-8?q?=E7=89=88=200.0.2"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 6b92ca9a301e3b5506160419c66dd5598e959471. --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 6bf93cc..1377b96 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.2", + "version": "0.0.1", "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 05a4486..a049919 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.2", + "version": "0.0.1", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index c7c4ae4..4fca834 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.2", + "version": "0.0.1", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0 From 186d69dfe6778597ab02fa19d34744439eebbe4a Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 18/27] =?UTF-8?q?Revert=20"docs(README):=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=20code-action-docker=20=E7=AB=A0=E7=AF=80=E7=82=BA?= =?UTF-8?q?=E5=95=8F=E7=AD=94=E5=BC=8F=E4=BA=94=E9=9A=8E=E6=AE=B5=E6=B5=81?= =?UTF-8?q?=E7=A8=8B=E8=AA=AA=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit a3a1346ae98bdc6d7d4bd4a8adf42c843c044a1d. --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 7b5287d..eef42ec 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ code/ │ ├── code-issues/ # 彙整議題 TODO（影響範圍小→大）+ 逐項實作 + 留言進度 │ ├── code-nuget/ # C# / .NET NuGet 套件更新 + build 驗證 │ ├── code-sync/ # 依擁有者批次 clone／更新 Gitea 專案 -│ ├── code-action-docker/ # 問答式打造 docker action（Node 主程式）+ 串接 doc-funcs +│ ├── code-action-docker/ # action 容器化（Node 主程式）+ 串接 doc-funcs │ ├── code-action-composite/ # composite action 標準化 + 串接 doc-funcs │ ├── code-image/ # Dockerfile 整理成六步流程 + 串接 doc-funcs │ └── hello/ # 範例 skill：驗證安裝、新增 skill 的範本 @@ -235,13 +235,13 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -以**互動問答從零打造** Gitea／GitHub「Docker 容器 action」（Node 主程式），再串接文件化流程。五階段：(1) **詢問 action 名稱**（用於 `action.yml` 的 `name`）；(2) **詢問輸入與輸出參數**及其 description（盡量繁體中文、無亂碼；輸入含 required／default，實作對應 `INPUT_*` 環境變數與 `$GITHUB_OUTPUT`）；(3) **詢問執行此流程的目標**，追問到可實作為止，整理**濃縮成一句話**（用於 `action.yml` 的 `description`，盡量繁體中文、無亂碼）；(4) **依標準實作目標**——盡量以 **Node.js** 開發、程式檔**一律放 `src/`**（入口 `src/index.js`、共用 `src/logger.js`），**盡量詳細輸出訊息**且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（Asia/Taipei；無階段則移除該 `[]`；等級 `INF`/`WRN`/`ERR`/`TRC`/`DBG`；一行一則），並產生 `action.yml`、啟動前先輸出名稱／用途／更新時間的 `entrypoint.sh`、**使用最新 node 版本**的多階段建置 `Dockerfile`（預設 build 基底 `node:latest`、runtime `node:slim`）；(5) **檢查是否有 doc-funcs 技能**：有則對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README），沒有則回報後結束。 +把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把所有 `.js` 集中到 **`src/`**、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 node 版本**的 `Dockerfile`，**每步內容依主程式（`src/`）實作量身決定**（先盤點相依／是否需 build／OS 層相依／入口檔再填對應步驟，用不到的不硬塞），預設 build 基底 `node:latest`、runtime `node:slim`、**多階段建置縮小映像**，`ENTRYPOINT` 指向 `entrypoint.sh`；(E) 對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README）。 -參數：`[--action-dir ] [--node-version ]`（根目錄預設目前工作目錄；node 版本預設最新；名稱／輸入輸出／目標以問答取得，呼叫時已口述者不再重問）。 +參數：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷；`--yes` 略過一般確認，但主程式改寫與 doc-funcs 的實作詢問仍會中斷）。 - **Claude Code / Antigravity**：`/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22` - **Codex**：`$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 -- **OpenCode**：描述需求（如「幫我從零建一個 docker action：先問我名稱、輸入輸出參數與目標，用 node 實作放在 src/，訊息格式統一為 [時間][階段][等級]，最後跑 doc-funcs 補文件並重建 README」）自動觸發 +- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 ### `code-action-composite` -- 2.53.0 From 099f17e06752e6f3f3e419c1e5e3a7cdd71a2e13 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 12:33:52 +0800 Subject: [PATCH 19/27] =?UTF-8?q?Revert=20"feat(code-action-docker):=20?= =?UTF-8?q?=E9=87=8D=E5=BB=BA=E7=82=BA=E5=95=8F=E7=AD=94=E5=BC=8F=E4=BA=94?= =?UTF-8?q?=E9=9A=8E=E6=AE=B5=E6=B5=81=E7=A8=8B=EF=BC=8C=E8=A9=A2=E5=95=8F?= =?UTF-8?q?=E5=90=8D=E7=A8=B1=EF=BC=8F=E8=BC=B8=E5=85=A5=E8=BC=B8=E5=87=BA?= =?UTF-8?q?=EF=BC=8F=E7=9B=AE=E6=A8=99=E5=BE=8C=E4=BB=A5=20Node=20?= =?UTF-8?q?=E5=AF=A6=E4=BD=9C=E4=B8=A6=E7=B5=B1=E4=B8=80=E8=A8=8A=E6=81=AF?= =?UTF-8?q?=E6=A0=BC=E5=BC=8F=EF=BC=8C=E4=B8=B2=E6=8E=A5=20doc-funcs"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 3a9819f6d8f7783075a05013e0be41f8d3eb2111. --- skills/code-action-docker/SKILL.md | 232 ++++++++++++++++------------- 1 file changed, 130 insertions(+), 102 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index 9ae4145..ff8978c 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,144 +1,168 @@ --- name: code-action-docker -description: 以互動問答從零打造 Gitea／GitHub「Docker 容器 action」：(1) 詢問 action 名稱（用於 action.yml 的 name）；(2) 詢問輸入與輸出參數及其 description（盡量繁體中文、無亂碼）；(3) 詢問執行此流程的目標，整理濃縮成一句話（用於 action.yml 的 description，盡量繁體中文、無亂碼）；(4) 依標準實作目標——盡量以 Node.js 開發、程式檔一律放 `src/`、盡量詳細輸出訊息且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`（無階段則移除該 `[]`，等級為 INF/WRN/ERR/TRC/DBG），並產生 action.yml／entrypoint.sh／最新 node 版本的 Dockerfile；(5) 檢查是否有 doc-funcs 技能，有則完整執行 `/jsc:doc-funcs`，否則結束。當使用者說建立／產生一個 docker action、從零做一個容器 action、幫我問完需求後生出 action、把需求做成 node docker action，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、非 action 專案。 -argument-hint: "[--action-dir ] [--node-version ]" +description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化，並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且所有 `.js` 檔一律集中到 `src/` 資料夾；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 node 版本的 `Dockerfile`；(4) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、容器化 action、action 主程式 node 化、把 js 收進 src、產 entrypoint.sh／Dockerfile 給 action，或提到 code-action-docker 時觸發。不適用於：非 action 專案、純前端打包、或不需容器化的一般 repo。 +argument-hint: "[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]" --- -# code-action-docker — 問答式打造 Docker 容器 action（Node 主程式）＋文件化 +# code-action-docker — action 容器化（Node 主程式）＋文件化 -五階段 skill：先以問答收齊需求——**action 名稱**（階段 1）、**輸入與輸出參數**（階段 2）、**流程目標並濃縮成一句話**（階段 3）——再依標準**實作目標**（階段 4：Node.js、程式檔一律放 `src/`、統一訊息格式，並產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile`），最後**檢查是否有 doc-funcs 技能**（階段 5）：有則完整執行 `/jsc:doc-funcs`，否則結束。 +五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將所有 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。 | 階段 | 動作 | | --- | --- | -| 1. 詢問 action 名稱 | 向使用者詢問 action 名稱 → 寫入 `action.yml` 的 `name` | -| 2. 詢問輸入與輸出參數 | 逐一收齊 `inputs`／`outputs`（名稱、description、required、default）→ description 盡量繁體中文、無亂碼 | -| 3. 詢問流程目標 | 詢問此 action 要達成什麼 → 整理並**濃縮成一句話**，經使用者確認後寫入 `action.yml` 的 `description`（盡量繁體中文、無亂碼） | -| 4. 實作目標 | 盡量以 **Node.js** 開發、程式檔**一律放 `src/`**；訊息詳細且格式統一為 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息`；產生 `action.yml`／`entrypoint.sh`／最新 node 版本的 `Dockerfile` | -| 5. 檢查 doc-funcs | 有 doc-funcs 技能 → 完整執行 `/jsc:doc-funcs`；沒有 → 回報後結束 | +| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description` → 判斷目前主程式與語言 | +| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 所有 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` | +| C. entrypoint.sh | 產生 `entrypoint.sh`：先輸出 action **名稱／用途／更新時間**，再 `exec` node 主程式 | +| D. Dockerfile | 依六步流程（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生使用**最新 node 版本**的 `Dockerfile`，多階段建置縮小映像、`ENTRYPOINT` 指向 `entrypoint.sh` | +| E. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） | --- ## 輸出規範（務必遵守） -- **語言**：所有面向使用者的輸出（問題、計畫、進度、總結）一律使用**繁體中文（台灣用語）**；僅識別字、檔名、git／docker 指令、API 路徑、程式碼等技術標識保留原文，**不可**使用簡體字。 -- **編碼無亂碼**：凡輸出含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。產生的 `action.yml`、`src/*.js`、`entrypoint.sh`、`Dockerfile`、`README.md` 同樣需 UTF-8（不含 BOM）；`action.yml` 內的中文 `name`／`description`／參數說明必須能被 YAML 正確解析與顯示。 -- **問答原則**：階段 1～3 是**必要輸入**，缺一不可；使用者已在呼叫時提供的答案不再重複詢問，未提供的必須以 `AskUserQuestion`（或明確反問）取得，**不得臆測代答**。階段 4 起除必要決策外直接執行到完成。 -- **不破壞既有工作**：若 action 根目錄已存在 `action.yml`／`src/`／`entrypoint.sh`／`Dockerfile`，覆寫前先回報並確認；工作區有未提交變更時提醒使用者先 commit／備份；**絕不** `reset --hard`／`checkout -f`／`clean`，也不刪除使用者既有原始碼。 -- **不擴及無關檔案**：本 skill 只產生／修改 action 根目錄內的 `action.yml`、`src/`、`entrypoint.sh`、`Dockerfile`、`package.json`，以及階段 5 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。 +- **語言**：所有面向使用者的輸出（計畫、進度、總結、反問）一律使用**繁體中文（台灣用語）**；僅識別字、檔名、git／docker 指令、API 路徑、程式碼等技術標識保留原文，**不可**使用簡體字。 +- **編碼無亂碼**：凡輸出含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。產生／覆寫的 `entrypoint.sh`、`Dockerfile`、`action.yml`、`README.md` 同樣需 UTF-8（不含 BOM）。 +- **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策，否則各階段只需輸出簡短計畫／進度後直接執行到完成。**一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。 +- **不破壞既有工作**：移動 `.js`、改寫主程式、覆寫 `entrypoint.sh`／`Dockerfile`／`action.yml` 前，若工作區有未提交變更，先提醒使用者建議先 commit／備份；**絕不** `reset --hard`／`checkout -f`／`clean`，也不刪除使用者既有原始碼。移動檔案優先用 `git mv` 以保留歷史。 +- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。 +- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、`.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。 --- ## 參數 -格式：`[--action-dir ] [--node-version ]` +格式：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]` -- `--action-dir `：action 專案根目錄。**省略時預設目前工作目錄**。 -- `--node-version `：`Dockerfile` 的 node base image tag（如 `22`、`22-alpine`、`lts`）。**省略時預設使用最新 node 版本**（`node:latest`，見階段 4）。 - -階段 1～3 的答案（名稱、輸入輸出參數、目標）不設 CLI 參數；使用者若已在呼叫訊息中口述，直接採用、不再重問。 +- `--action-dir `：action 專案根目錄。**省略時預設目前工作目錄**（須含 `action.yml`／`action.yaml`，否則依 A1 詢問）。 +- `--node-version `：`Dockerfile` 的 node base image tag（如 `22`、`22-alpine`、`lts`）。**省略時預設使用最新 node 版本**（`node:latest`，見階段 D）。 +- `--main <主程式檔>`：指定主程式入口檔（相對 action 根目錄）。省略時依 A3 自動判斷。 +- `--yes`：盡量不中斷。即使帶此參數，「主程式非 Node 需改寫」與 doc-funcs 的「如何實作」仍會詢問。 --- -## 階段 1：詢問 action 名稱 +## 階段 A：前置設定與偵測 -向使用者詢問 **action 名稱**，用於 `action.yml` 的 `name`： +### A1. 決定 action 根目錄 -- 使用者已在呼叫時提供 → 直接採用並回報。 -- 未提供 → 以 `AskUserQuestion`（自由輸入為主，可依目錄名／repo 名給 2～3 個建議選項）詢問，**不得自行編造**。 -- 名稱不得為空；可為繁體中文或英文，原樣寫入 `name`，不擅自翻譯或改寫。 +- 帶 `--action-dir` → 採用（展開 `~`）。 +- 省略 → 用目前工作目錄。 +- 根目錄須存在 `action.yml` 或 `action.yaml`（action manifest）。**找不到** action manifest → 回報「此目錄不是 action 專案（缺 action.yml／action.yaml）」並詢問正確路徑，**不臆測**、不在非 action 專案上動工。 -## 階段 2：詢問輸入與輸出參數 +### A2. 讀取 action 名稱與用途 -向使用者收齊 action 的**輸入（`inputs`）與輸出（`outputs`）參數**，逐項確認： +從 action manifest 讀取： -- **每個輸入**：參數名稱（建議 kebab-case）、`description`（**盡量繁體中文、無亂碼**）、是否必填（`required`）、預設值（`default`，選填）。 -- **每個輸出**：參數名稱、`description`（**盡量繁體中文、無亂碼**）。 -- 使用者明確表示「無輸入」或「無輸出」→ 對應區塊留空（省略該區塊），不硬造參數。 -- description 缺漏時**反問補齊**，不編造；使用者堅持留空則標示「（未提供）」。 -- 收齊後輸出整理表（名稱／必填／預設值／說明）讓使用者確認，再進入階段 3。 +- `name`：action 名稱（供 `entrypoint.sh` 輸出與 README 使用）。 +- `description`：action 用途。 +- `runs`：目前的執行設定（`using`、`main`、`image`、`entrypoint` 等）。 -實作對應（供階段 4 使用）：輸入在容器內以 `INPUT_<大寫參數名>` 環境變數取得（`-` 轉 `_`）；輸出以附加 `name=value` 到 `$GITHUB_OUTPUT` 檔案寫出。 +若 `name`／`description` 缺漏，回報並請使用者補；無法取得時於後續輸出以「（未提供）」保守標示，**不編造**。 -## 階段 3：詢問執行此流程的目標 +### A3. 判斷目前主程式與語言 -向使用者詢問**此 action 要達成什麼目標**（要處理什麼、產出什麼、成功／失敗準則）： +依序判斷主程式入口（取第一個成立者）： -- 追問到「可實作」為止：不清楚的環節（資料來源、外部指令、失敗時的行為）必須問清，**不得臆測**。 -- 將目標**整理並濃縮成一句話**（盡量繁體中文、無亂碼），向使用者確認後寫入 `action.yml` 的 `description`。 -- 完整目標描述（含細節與邊界）保留於回報與階段 4 的實作依據，不因濃縮而遺失。 +1. 帶 `--main <主程式檔>` → 直接採用。 +2. `action.yml` 為 JS action（`runs.using: node*`）→ 取 `runs.main`。 +3. `action.yml` 為 docker action（`runs.using: docker`）→ 看 `runs.entrypoint`／`Dockerfile` 的 `ENTRYPOINT`／`CMD` 推主程式。 +4. 以上皆無 → 依專案檔與副檔名分布推斷（`package.json` 的 `main`／`bin`、`index.js`、`*.sh`、`*.py` 等）。 -## 階段 4：實作目標（Node.js、src/、統一訊息格式） +判定**主程式是否為 Node**：入口為 `.js`／`.mjs`／`.cjs` 且由 `node` 執行即視為 Node；入口為 shell／python／其他則視為非 Node。輸出偵測結果（action 名稱、用途、主程式檔、判定語言、是否為 Node），再進入階段 B。 -依階段 1～3 收齊的需求實作 action，遵守以下標準： +--- -### 4.1 盡量以 Node.js 開發，程式檔一律放 `src/` +## 階段 B：主程式 Node 化，並將所有 `.js` 收進 `src/` -- 主程式與所有模組**盡量以 Node.js 撰寫**；只有目標必須依賴外部工具時，才以 `child_process`（`execFileSync`／`spawnSync`）在 Node 內呼叫，不另寫 shell／python 主程式。 -- 所有 `.js`／`.mjs`／`.cjs`**一律放在 `src/` 資料夾內**，主程式入口統一為 `src/index.js`；需要相依套件時於 `src/` 建立 `package.json`（`main` 指向入口檔），不擅自新增與目標無關的相依。 -- 輸入用 `process.env.INPUT_*` 讀取（必填缺漏 → 輸出 `ERR` 訊息並以非零 exit code 結束）；輸出寫入 `process.env.GITHUB_OUTPUT`。 +### B1. 主程式 Node 化 -### 4.2 盡量詳細輸出訊息，格式統一 +- **已是 Node** → 確認入口檔，不改寫邏輯，直接進 B2。 +- **非 Node（shell／python／其他）** → 這是**破壞性高風險決策**：先以 `AskUserQuestion` 向使用者確認是否改寫為 Node，選項至少含「改寫為 Node」「維持原樣只做容器化（略過改寫）」「其他」。經確認後才改寫： + - 逐段把原主程式邏輯**保守翻譯**為 Node（建議 `index.js`）；保留對外行為、輸入（環境變數／`INPUT_*`／args）與輸出（stdout／exit code／檔案副作用）契約。 + - 外部指令呼叫以 `child_process`（`execFileSync`／`spawnSync`）對應；檔案操作以 `fs`；環境變數以 `process.env`。 + - 任何無法可靠等價翻譯處，**不臆測**：以 `// 需人工確認：...` 標註並回報。 + - 改寫完成後，原非 Node 主程式於 B2 一併處理（移除或保留由使用者裁示；預設保留並在 README／回報標註已由 Node 取代）。 -- 執行過程**盡量詳細輸出**：開始／結束、讀到的輸入、每個關鍵步驟、外部指令與結果、寫出的輸出、警告與錯誤。 -- 每一則訊息格式固定為： +### B2. 所有 `.js` 集中到 `src/` - ``` - [yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息 - ``` +- 在 action 根目錄建立 `src/`（若不存在）。 +- 將專案內所有 `.js`／`.mjs`／`.cjs`（排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）**移入 `src/`**，優先 `git mv` 保留歷史。主程式入口統一為 `src/index.js`（或 `src/
.js`）。 +- **移動後必須更新所有引用**，確保不破壞： + - 模組間的 `require`／`import` 相對路徑。 + - `package.json` 的 `main`／`bin`／`scripts`／`exports`（指向 `src/...`）。 + - `action.yml`／`Dockerfile`／`entrypoint.sh` 內對主程式路徑的引用。 +- 若 `src/` 下無 `package.json` 而專案需要相依，於 `src/` 建立或移入 `package.json`，`main` 指向入口檔；不擅自新增與功能無關的相依。 - - **時間**：台灣時區（Asia/Taipei），固定 `yyyy/MM/dd HH:mm:ss`。 - - **階段**：該訊息所屬的流程階段名稱（如 `讀取輸入`、`執行`、`寫出結果`）；**沒有階段時整個 `[階段]` 區塊移除**，即 `[yyyy/MM/dd HH:mm:ss][等級]: 訊息`。 - - **等級**：必為 `INF`／`WRN`／`ERR`／`TRC`／`DBG` 其中之一（一般資訊 INF、警告 WRN、錯誤 ERR、細部追蹤 TRC、除錯 DBG）。 -- **一行一則訊息**：每則訊息獨立一行輸出，不得多則併成一坨。 -- 在 `src/logger.js` 實作共用 logger（產生時間戳、組合前綴、`INF`/`WRN`/`ERR`/`TRC`/`DBG` 各一個方法、可帶階段名稱），主程式一律經由它輸出；`ERR` 走 `console.error`，其餘走 `console.log`。 -- 錯誤處理：可預期錯誤輸出 `ERR` 訊息並 `process.exit(1)`；未捕捉例外亦須被攔截（`process.on('uncaughtException'/'unhandledRejection')`）以 `ERR` 格式輸出後非零結束。 +### B3. action.yml 對齊 docker -### 4.3 產生 action.yml - -以階段 1～2 的答案組出 `action.yml`（中文內容 UTF-8、無亂碼）： +將 manifest 的 `runs` 對齊為 docker 容器 action（保留既有 `inputs`／`outputs`／`name`／`description`）： ```yaml -name: <階段 1 的 action 名稱> -description: <階段 3 濃縮的一句話> -inputs: - <參數名>: - description: <階段 2 的說明（盡量繁體中文）> - required: true|false - default: <預設值（若有）> -outputs: - <參數名>: - description: <階段 2 的說明（盡量繁體中文）> runs: using: docker image: Dockerfile entrypoint: entrypoint.sh ``` -無輸入／輸出時省略對應區塊。 +若原本是 JS action（`using: node*`），改為上述 docker 設定；若已是 docker action，確認 `image` 指向 `Dockerfile`、`entrypoint` 指向 `entrypoint.sh`。 -### 4.4 產生 entrypoint.sh +--- -在 action 根目錄產生 `entrypoint.sh`：啟動 node 主程式前，先輸出 action **名稱／用途／更新時間**，且每則輸出同樣遵守 4.2 訊息格式（階段用 `啟動`）： +## 階段 C：產生 entrypoint.sh（先輸出名稱／用途／更新時間，再啟動 node 主程式） + +在 action 根目錄產生（或覆寫）`entrypoint.sh`：**啟動 node 主程式前，先輸出 action 名稱、用途、更新時間**。 + +- **更新時間**為產生此檔當下的時間戳，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。 +- 名稱／用途取自階段 A2 的 `action.yml`。 +- 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。 + +範例（實際路徑依階段 B 入口而定）： ```sh #!/bin/sh set -e -# action 啟動訊息：名稱／用途／更新時間（此檔由 code-action-docker 產生） -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: Action：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 用途：" -echo "[<產生當下 Asia/Taipei 時間>][啟動][INF]: 更新時間：<產生當下 Asia/Taipei 時間>" +# action 啟動橫幅：輸出名稱／用途／更新時間（此檔由 code-action-docker 產生） +echo "================================================" +echo "Action : " +echo "用途 : " +echo "更新時間: 2026/06/30 18:30:05" +echo "================================================" # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code） exec node /action/src/index.js "$@" ``` -- 「更新時間」為產生此檔當下的時間戳（`TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'`），**寫成檔內固定字串**；名稱／用途取自階段 1／3。 - 賦予可執行權限：`chmod +x entrypoint.sh`（並於 git 標記為可執行）。 +- 此檔開頭的「用途／更新時間」與每行註解，最終會在階段 E 由 `/jsc:doc-funcs` 的指令檔流程統一補齊／覆寫為標準格式（用途與更新日期同一註解區塊、逐行註解）；本階段先確保**執行期輸出**正確即可。 -### 4.5 產生 Dockerfile（使用最新 node 版本） +--- -在 action 根目錄產生 `Dockerfile`，**base image 使用最新 node 版本**，採**多階段建置**縮小最終映像，內容依 `src/` 實作量身決定（有相依才裝、需要 OS 工具才 `apt-get install`，用不到的不硬塞）： +## 階段 D：產生 Dockerfile（使用最新 node 版本，六步流程依主程式實作量身產生） + +在 action 根目錄產生（或覆寫）`Dockerfile`，**base image 使用最新 node 版本**，採**多階段建置**以縮小最終映像檔。六步流程是**骨架**，但**每一步的實際內容必須依階段 B 的主程式（`src/`）實作決定**——不要套用與主程式無關的固定樣板，也不要硬塞主程式用不到的安裝或建置指令。 + +### D0. 先盤點主程式實作需求 + +產生 Dockerfile 前，先檢視 `src/` 主程式與 `package.json`，判斷各步該放什麼： + +- **相依套件**：`src/package.json` 的 `dependencies`／`devDependencies`、是否有 lockfile（`package-lock.json`／`npm-shrinkwrap.json`）。決定第 2 步用 `npm ci` 還是 `npm install`、是否需要 dev 相依來 build。 +- **是否需要 build／transpile**：有無 `scripts.build`、是否為 TypeScript／打包（產物落在 `dist/`／`build/` 等）。決定第 4 步是否要跑建置、第 5 步 runtime 該帶入哪個產物目錄。 +- **OS 層相依**：主程式是否以 `child_process` 呼叫外部執行檔（如 `git`、`bash`、`openssl`、`python3`、`ffmpeg`、`imagemagick`），或使用需編譯的原生模組（node-gyp／native addon）。決定第 2 步是否要 `apt-get install` 對應套件，以及第 5 步 runtime 基底是否需保留這些執行檔。 +- **執行期需求**：主程式讀取的環境變數、需存取的檔案路徑、是否寫入暫存目錄。決定 `WORKDIR`、需 `COPY` 的檔案範圍與必要的 `ENV`。 +- **入口檔**：階段 B 決定的主程式入口（如 `src/index.js`），決定第 6 步與 `entrypoint.sh` 內 `node` 路徑。 + +### D1～D6：依盤點結果填入六步 + +1. **參數處理**：以 `ARG` 注入 node 版本（預設最新）與主程式需要的 build-time 參數；可調參數集中在檔案開頭。 +2. **安裝套件**：依 D0 的相依結果安裝——有 lockfile 用 `npm ci`、否則 `npm install`；不需 build 時加 `--omit=dev`，需 build 時先裝完整相依（含 dev）供第 4 步使用。**只在主程式真的會用到時**才 `apt-get install` OS 套件，並於同一 `RUN` 清掉 apt 快取。先 `COPY` 相依描述（`package*.json`）再安裝，以利 layer 快取。 +3. **複製檔案**：`COPY` 主程式實際需要的檔案（`src/`、`entrypoint.sh`，及主程式會讀取的資源）；不需要的檔案不必帶入。 +4. **執行程序**：賦予 `entrypoint.sh` 執行權限；**僅當 D0 判定需要 build／transpile 時**才執行（如 `npm run build`），否則此步只做權限設定，不要硬加建置指令。 +5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像。 +6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。 + +base image 版本：預設 build 基底 `node:latest`、runtime 基底 `node:slim`（皆為最新版，slim 用於縮小）；帶 `--node-version `（如 `22`、`lts`）時改用 `node:` 與 `node:-slim`。若需確認當前最新穩定版號，可查詢 Docker Hub（`https://hub.docker.com/_/node`）後於 `FROM` 註記實際版本，但**預設行為是使用最新版**。 + +下列為**最簡基準骨架**（純 JS、無 build、無 OS 相依的情況）；實際內容須依 D0 盤點調整，第 4 步建置、第 2／5 步 OS 套件等視主程式需要增刪： ```Dockerfile # syntax=docker/dockerfile:1 @@ -147,47 +171,50 @@ exec node /action/src/index.js "$@" ARG NODE_VERSION=latest ARG NODE_RUNTIME=slim -# ---- build 階段：安裝相依 ---- +# ---- build 階段：安裝相依、準備產物 ---- FROM node:${NODE_VERSION} AS build WORKDIR /action -# 2. 安裝套件：先帶相依描述以利 layer 快取（有 lockfile 用 npm ci） +# 2. 安裝套件：先帶相依描述以利 layer 快取，再裝 src/ 相依 +# （需 build 時改裝完整相依；需 OS 套件時於此 apt-get install 並清快取） COPY src/package*.json /action/src/ RUN if [ -f /action/src/package.json ]; then \ cd /action/src && (npm ci --omit=dev || npm install --omit=dev); \ fi -# 3. 複製檔案：帶入主程式與入口 -COPY src/ /action/src/ -COPY entrypoint.sh /action/entrypoint.sh +# 3. 複製檔案：複製主程式實際需要的檔案 +COPY . /action -# 4. 執行程序：賦予 entrypoint 執行權限 +# 4. 執行程序：賦予 entrypoint 執行權限（D0 判定需要 build 時於此 npm run build） RUN chmod +x /action/entrypoint.sh -# 5. 縮小映像檔：runtime 改用 slim 基底，只帶必要產物 +# 5. 縮小映像檔：多階段建置，runtime 改用 slim 基底、只帶必要產物 +# （有 build 產物時改帶 dist/ 與 production node_modules；runtime 需要的 OS 執行檔於此安裝） FROM node:${NODE_RUNTIME} AS runtime WORKDIR /action COPY --from=build /action /action -# 6. 設定入口：以 entrypoint.sh 啟動 node 主程式 +# 6. 設定入口：以 entrypoint.sh 啟動（其內 node 指向 D0 的入口檔） ENTRYPOINT ["/action/entrypoint.sh"] ``` -- **版號對齊**：預設 build 基底 `node:latest`、runtime 基底 `node:slim`（**沒有 `node:latest-slim` 這個 tag**，故以獨立 `NODE_RUNTIME` 參數帶入）；帶 `--node-version 22` 時設 `NODE_VERSION=22`、`NODE_RUNTIME=22-slim`。 -- 主程式以 `child_process` 呼叫外部執行檔（如 `git`、`openssl`）時，於 runtime 階段補 `apt-get install` 對應套件並清快取。 -- **自我檢查**：`entrypoint.sh` 的 `node /action/src/index.js` 路徑須與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致。 +- **依主程式實作**：上面只是基準骨架。若主程式是 TypeScript／需打包，第 4 步要加 `npm run build`、第 5 步只帶 `dist/` 與 production 相依；若主程式會 spawn 外部執行檔或用原生模組，第 2／5 步要補對應 OS 套件；用不到的步驟內容不要硬塞。 +- **版號對齊**：runtime 的 slim 基底版號需與 build 基底一致。預設 `node:latest` ↔ `node:slim`；帶 `--node-version 22` 時設 `NODE_VERSION=22`、`NODE_RUNTIME=22-slim`。注意**沒有 `node:latest-slim` 這個 tag**，最新版 slim 一律用 `node:slim`，故以獨立的 `NODE_RUNTIME` 參數帶入、不要用 `${NODE_VERSION}-slim` 組裝。 +- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式。 +- 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 doc-funcs 指令檔流程統一補齊。 -### 4.6 驗證 +--- -- `node --check src/*.js` 驗證語法；有 `package.json` 時執行 `npm install`（或 `npm ci`）確認相依可解析。 -- 環境有 docker 時執行 `docker build .` 驗證映像可建置；無法執行時明確說明原因並標註風險。 +## 階段 E：完整執行 /jsc:doc-funcs 處理流程 -## 階段 5：檢查是否有 doc-funcs 技能 +容器化與 Node 化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： -實作完成後，檢查目前環境是否有 **doc-funcs** 技能（可用 skill 清單中是否存在 `doc-funcs`，含 `/jsc:doc-funcs` 等帶前綴形式）： +- 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 +- doc-funcs 會涵蓋本次新增／變更的指令檔：`entrypoint.sh`（補齊「用途＋更新日期同一註解區塊」與逐行註解）、`Dockerfile`（逐行註解）；以及 `src/` 內 Node 主程式與各 function 的文件註解。 +- doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 +- 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 -- **有** → 以階段 4 的 action 根目錄為目標，**完整執行 `/jsc:doc-funcs` 流程**（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 詢問使用者如何實作 → 寫回 → 保守優化 → 重建 README → 清理草稿 → 驗證）。doc-funcs 會涵蓋本次產出：`src/` 內各 function 的 JSDoc、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README；其「如何實作」詢問由使用者於該流程內裁示。既有訊息一律維持本 skill 4.2 的 `[yyyy/MM/dd HH:mm:ss][階段][等級]: 訊息` 格式，不得被改寫成其他欄位順序。 -- **沒有** → 回報「未偵測到 doc-funcs 技能，略過文件化」後**結束**，不自行模擬 doc-funcs 流程。 +> 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的 action 根目錄為目標專案。 --- @@ -195,19 +222,20 @@ ENTRYPOINT ["/action/entrypoint.sh"] 各階段執行後輸出： -- **階段 1～3**：action 名稱、輸入／輸出參數整理表、濃縮後的一句話 description。 -- **階段 4**：產出檔案清單（`action.yml`、`src/index.js`、`src/logger.js`、`src/package.json`（若有）、`entrypoint.sh`、`Dockerfile`）與各自相對路徑、採用的 node 版本、驗證結果（語法檢查／npm／docker build）。 -- **階段 5**：是否偵測到 doc-funcs；有則附 doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。 -- 提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。 +- **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node。 +- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）。 +- **階段 C／D**：`entrypoint.sh` 的輸出內容（名稱／用途／更新時間）與啟動的 node 主程式、`Dockerfile` 採用的 node 版本與 `ENTRYPOINT`。 +- **階段 E**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。 +- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。 --- ## 呼叫方式 -格式：`[--action-dir ] [--node-version ]` — 全部可省略（根目錄預設目前工作目錄；node 版本預設最新）。 +格式：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]` — 全部可省略（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷）。 | 助理 | 呼叫 | | --- | --- | | Claude Code / Antigravity | `/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22` | | Codex | `$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 | -| OpenCode | 描述需求（如「幫我從零建一個 docker action：先問我名稱、輸入輸出參數與目標，用 node 實作放在 src/，訊息格式統一，最後跑 doc-funcs 補文件」）自動觸發 | +| OpenCode | 描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 | -- 2.53.0 From 0b464c5cdf5510818e2876c04424c930eeff8486 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 16:03:40 +0800 Subject: [PATCH 20/27] =?UTF-8?q?feat(code-action-composite):=20=E5=8F=83?= =?UTF-8?q?=E6=95=B8=E4=BE=86=E6=BA=90=E5=84=AA=E5=85=88=E5=BA=8F=E7=B0=A1?= =?UTF-8?q?=E5=8C=96=E7=82=BA=20context=E2=86=92inputs=E3=80=81=E6=96=B0?= =?UTF-8?q?=E5=A2=9E=20A1a=20=E5=95=8F=E7=AD=94=E5=BC=8F=E5=BE=9E=E9=9B=B6?= =?UTF-8?q?=E5=BB=BA=E7=AB=8B=E5=88=86=E6=94=AF=E3=80=81=E8=A3=9C=20INPUT?= =?UTF-8?q?=5F*=EF=BC=8Foutputs=20=E6=98=A0=E5=B0=84=E6=A8=A3=E6=9D=BF?= =?UTF-8?q?=E3=80=81=E7=B5=B1=E4=B8=80=E6=99=82=E9=96=93=E6=88=B3=E4=B8=A6?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=20--yes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- skills/code-action-composite/SKILL.md | 78 +++++++++++++++++++++------ 1 file changed, 61 insertions(+), 17 deletions(-) diff --git a/skills/code-action-composite/SKILL.md b/skills/code-action-composite/SKILL.md index d2ef249..2f2a0bc 100644 --- a/skills/code-action-composite/SKILL.md +++ b/skills/code-action-composite/SKILL.md @@ -1,16 +1,16 @@ --- name: code-action-composite -description: 將 Gitea／GitHub「composite action」專案標準化並串接文件化流程：(1) 確認 action 為 composite（`runs.using: composite`），非 composite 則保守確認後對齊；(2) 在 `runs.steps` 最前面注入啟動橫幅 step，輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`），並於 `action.yml` 開頭補用途／更新時間註解區塊；(3) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說整理 composite action、把 action 標準化為 composite、讓 composite action 啟動時印名稱／用途／更新時間、對 composite action 補文件，或提到 code-action-composite 時觸發。不適用於：Docker 容器 action（用 code-action-docker）、非 action 專案、或不需文件化的一般 repo。 -argument-hint: "[--action-dir ] [--manifest ] [--yes]" +description: 將 Gitea／GitHub「composite action」專案標準化（目錄沒有 action manifest 時可問答式從零建立）並串接文件化流程：(1) 確認 action 為 composite（`runs.using: composite`），非 composite 則保守確認後對齊；(2) 在 `runs.steps` 最前面注入啟動橫幅 step，輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`），並於 `action.yml` 開頭補用途／更新時間註解區塊；(3) 開發中需要新參數時優先取用 `${{ gitea.* }}`／`${{ github.* }}` context，無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 composite action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(4) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說整理 composite action、從零建立／產生一個 composite action、把 action 標準化為 composite、讓 composite action 啟動時印名稱／用途／更新時間、處理 composite action 參數來源、對 composite action 補文件，或提到 code-action-composite 時觸發。不適用於：Docker 容器 action（用 code-action-docker）、或不需 action 化／文件化的一般 repo。 +argument-hint: "[--action-dir ] [--manifest ]" --- # code-action-composite — composite action 標準化＋文件化 -四階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷是否為 composite），再**確認／對齊為 composite action**，接著在 `runs.steps` 最前面**注入會輸出 action 名稱／用途／更新時間的啟動橫幅 step**，最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。 +四階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷是否為 composite），再**確認／對齊為 composite action**，接著在 `runs.steps` 最前面**注入會輸出 action 名稱／用途／更新時間的啟動橫幅 step**，最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 composite `action.yml`，再進入後續階段。 | 階段 | 動作 | | --- | --- | -| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs` → 判斷是否為 composite | +| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs` → 判斷是否為 composite（無 manifest 可走 A1a 從零建立） | | B. 對齊為 composite | 已是 composite 則保留既有 `steps`；非 composite 則**保守確認後對齊**（高風險，先確認），整理被引用的腳本路徑 | | C. 注入啟動橫幅 step | 在 `runs.steps` 最前面插入一個 shell step，輸出 action **名稱／用途／更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊 | | D. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） | @@ -23,18 +23,35 @@ argument-hint: "[--action-dir ] [--manifest }}` 取用；未經同意**不得**擅自更動 `inputs`／`outputs` 契約。 + +**secrets／vars 一律視為不可用，不列入優先序**：`${{ secrets.* }}`／`${{ vars.* }}` context 在 composite action 的 `action.yml` 內於 GitHub 為**官方明文不可用**（composite action 取不到 `secrets`／`vars` context，`inputs` 的 `default` 也不能引用）；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證。為求兩邊相容，本 skill 一律視為不可用——參數值本質上屬 secrets／vars 者，直接依第 2 項宣告為 `input`，回報時附上呼叫端 workflow 的傳入寫法： + +```yaml +- uses: /@ + with: + token: ${{ secrets.MY_TOKEN }} # secrets 由呼叫端 workflow 傳入 + registry: ${{ vars.MY_REGISTRY }} # vars 亦同 +``` + +--- + ## 參數 -格式：`[--action-dir ] [--manifest ] [--yes]` +格式：`[--action-dir ] [--manifest ]` - `--action-dir `：action 專案根目錄。**省略時預設目前工作目錄**（須含 `action.yml`／`action.yaml`，否則依 A1 詢問）。 - `--manifest `：指定 action manifest 檔（相對 action 根目錄）。省略時依 A1 自動尋找 `action.yml`／`action.yaml`。 -- `--yes`：盡量不中斷。即使帶此參數，「非 composite 需對齊」與 doc-funcs 的「如何實作」仍會詢問。 --- @@ -44,7 +61,17 @@ argument-hint: "[--action-dir ] [--manifest ] [--manifest ] [--manifest 若偵測為 **Docker 容器 action**，且使用者本意是容器化而非 composite，提醒可改用 `/jsc:code-action-docker`，再依使用者裁示決定是否續行。 +> 若偵測為 **Docker 容器 action**，此處**僅輸出偵測結果**並提醒可改用 `/jsc:code-action-docker`，**不詢問**；是否對齊／維持原樣／改用 code-action-docker 的決策，統一由階段 B2 的一次 `AskUserQuestion` 收斂。 --- @@ -75,26 +102,41 @@ argument-hint: "[--action-dir ] [--manifest .js`）→ 轉為一個 `run` step，於 step 內以 `node .js` 執行（`shell: bash`），保留 `inputs`／`outputs` 與環境變數（`INPUT_*`）契約。 + - 原 JS action（`runs.using: node*`，`runs.main: .js`）→ 轉為一個 `run` step，於 step 內以 `node .js` 執行（`shell: bash`）。composite step **不會自動注入 `INPUT_*` 環境變數、也不會自動轉接 outputs**，必須手動補齊兩段映射（見下方範例）： + - **inputs 映射**：step 加 `env:`，逐一宣告 `INPUT_<大寫名稱>: ${{ inputs. }}`——主程式的 `getInput()`／`process.env.INPUT_*` 才拿得到值。 + - **outputs 轉接**：step 設 `id`，action 層 `outputs` 逐一宣告 `value: ${{ steps..outputs. }}`（主程式寫入 `$GITHUB_OUTPUT` 的值由此轉出）。 + - **硬條件**：無法完成上述兩項映射（inputs／outputs 無法逐一對應）時**不對齊**，以 `# 需人工確認` 標註並回報。 - 原 Docker action（`runs.using: docker`）→ Docker 行為通常無法可靠等價地塞進 composite；**不臆測改寫**，以回報＋`# 需人工確認` 標註，並建議改用 `/jsc:code-action-docker`。 - 任何無法可靠等價對齊處，**不臆測**：以 `# 需人工確認：...` 標註並回報，保留原檔行為。 +- 對齊過程需要新的參數值（如 token、repo 資訊、外部設定）時，依「參數來源優先序」處理，不逕自新增 `inputs`。 -對齊後的 `runs` 形如： +對齊後（含 inputs 映射與 outputs 轉接）形如： ```yaml +inputs: + foo: + description: <沿用原 input 宣告> +outputs: + bar: + description: <沿用原 output 宣告> + value: ${{ steps.main.outputs.bar }} # outputs 轉接：由 step outputs 轉出 + runs: using: composite steps: # （階段 C 會在此處最前面插入啟動橫幅 step） - name: <原執行入口轉成的 step> + id: main shell: bash + env: + INPUT_FOO: ${{ inputs.foo }} # inputs 映射：composite 不會自動注入 INPUT_* run: node ./index.js ``` @@ -104,7 +146,7 @@ runs: 在 `runs.steps` **最前面**插入（或更新）一個輸出橫幅的 step，讓 composite action 一啟動就**輸出 action 名稱、用途、更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊。 -- **更新時間**為產生此檔當下的時間戳，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。 +- **更新時間**語意為「本檔最後由本 skill 產生／更新的時間」，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。本階段先寫入暫定時間戳，**階段 D 完成後會統一同步各處時間戳**（見階段 D）。 - 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。 - 橫幅 step 須有可辨識的 `name`（如 `顯示 action 資訊`）與 `shell: bash`；其後緊接既有／對齊後的 steps，**不更動既有 steps**。 - 若已存在本 skill 先前插入的橫幅 step（依 `name` 辨識），則**更新**其內容與更新時間，不重複插入。 @@ -142,10 +184,12 @@ runs: 標準化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： +- **前置檢查**：先確認 doc-funcs skill 可用（`/jsc:doc-funcs`）；不可用則回報並**略過本階段**，於總結標註「未文件化」。 - 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 - doc-funcs 會把 `action.yml`／`action.yaml` 視為 CI／部署設定檔處理：補齊「用途＋更新日期同一註解區塊」與逐行註解；`steps` 內引用的腳本（`*.sh`／`*.ps1` 等）逐行註解；專案內各 function 補文件註解。 - doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 - 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 +- **統一時間戳**：doc-funcs 全部完成後，以完成當下的 Asia/Taipei 時間（`yyyy/MM/dd HH:mm:ss`）回頭同步橫幅 step 內文、`action.yml` 開頭註解區塊與 README 的更新時間，**確保各處時間戳一致**。 > 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的 action 根目錄為目標專案。 @@ -155,8 +199,8 @@ runs: 各階段執行後輸出： -- **階段 A**：action 根目錄、manifest 路徑、action 名稱／用途、`runs.using`、是否為 composite、既有 step 數量。 -- **階段 B**：是否對齊為 composite（及對齊摘要與「需人工確認」清單），或維持原樣的理由。 +- **階段 A**：action 根目錄、manifest 路徑、action 名稱／用途、`runs.using`、是否為 composite、既有 step 數量；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。 +- **階段 B**：是否對齊為 composite（及對齊摘要與「需人工確認」清單），或維持原樣的理由；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。 - **階段 C**：橫幅 step 的輸出內容（名稱／用途／更新時間）與插入位置，並確認既有 steps、`inputs`／`outputs` 未被破壞。 - **階段 D**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。 - 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `action.yml` 可正常解析、composite action 能正確啟動並輸出橫幅。 @@ -165,7 +209,7 @@ runs: ## 呼叫方式 -格式：`[--action-dir ] [--manifest ] [--yes]` — 全部可省略（根目錄預設目前工作目錄；manifest 自動尋找）。 +格式：`[--action-dir ] [--manifest ]` — 全部可省略（根目錄預設目前工作目錄；manifest 自動尋找）。 | 助理 | 呼叫 | | --- | --- | -- 2.53.0 From 6e22907b0ea7a21d15c9124168ee28c24808193c Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 16:03:49 +0800 Subject: [PATCH 21/27] =?UTF-8?q?feat(code-action-docker):=20=E5=8F=83?= =?UTF-8?q?=E6=95=B8=E4=BE=86=E6=BA=90=E5=84=AA=E5=85=88=E5=BA=8F=E6=94=B9?= =?UTF-8?q?=E7=82=BA=E5=9F=B7=E8=A1=8C=E6=9C=9F=E7=92=B0=E5=A2=83=E8=AE=8A?= =?UTF-8?q?=E6=95=B8=E2=86=92inputs=E3=80=81=E6=96=B0=E5=A2=9E=20A1a=20?= =?UTF-8?q?=E5=95=8F=E7=AD=94=E5=BC=8F=E5=BE=9E=E9=9B=B6=E5=BB=BA=E7=AB=8B?= =?UTF-8?q?=E3=80=81=E7=A7=BB=E9=99=A4=E7=9B=B8=E5=B0=8D=E8=B7=AF=E5=BE=91?= =?UTF-8?q?=20entrypoint=E3=80=81=E7=9C=9F=E5=A4=9A=E9=9A=8E=E6=AE=B5?= =?UTF-8?q?=E5=BB=BA=E7=BD=AE=EF=BC=8B.dockerignore=E3=80=81=E9=A0=90?= =?UTF-8?q?=E8=A8=AD=E6=9C=80=E6=96=B0=20LTS=20node=E3=80=81=E9=99=90?= =?UTF-8?q?=E7=B8=AE=20src/=20=E6=90=AC=E7=A7=BB=E7=AF=84=E5=9C=8D?= =?UTF-8?q?=E4=B8=A6=E7=A7=BB=E9=99=A4=20--yes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- skills/code-action-docker/SKILL.md | 119 +++++++++++++++++++---------- 1 file changed, 78 insertions(+), 41 deletions(-) diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index ff8978c..c9a35a7 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -1,19 +1,19 @@ --- name: code-action-docker -description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化，並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且所有 `.js` 檔一律集中到 `src/` 資料夾；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 node 版本的 `Dockerfile`；(4) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、容器化 action、action 主程式 node 化、把 js 收進 src、產 entrypoint.sh／Dockerfile 給 action，或提到 code-action-docker 時觸發。不適用於：非 action 專案、純前端打包、或不需容器化的一般 repo。 -argument-hint: "[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]" +description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化（目錄沒有 action manifest 時可問答式從零建立），並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且主程式及其依賴鏈的 `.js` 檔集中到 `src/` 資料夾（工具設定檔與測試目錄不搬）；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 LTS node 版本的 `Dockerfile`；(4) 開發中需要新參數時優先取用 runner 注入的 `GITHUB_*`（Gitea 亦有 `GITEA_*`）執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊），無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 docker action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(5) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、從零建立／產生一個 docker action、容器化 action、action 主程式 node 化、把 js 收進 src、產 entrypoint.sh／Dockerfile 給 action、處理 docker action 參數來源，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、純前端打包、或不需容器化的一般 repo。 +argument-hint: "[--action-dir ] [--node-version ] [--main <主程式檔>]" --- # code-action-docker — action 容器化（Node 主程式）＋文件化 -五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將所有 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。 +五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將主程式依賴鏈的 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 LTS node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。產出的 docker action 需在**具 Docker 能力的 runner（docker 模式）**上執行。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 `action.yml` 與 Node 主程式骨架，再進入後續階段。 | 階段 | 動作 | | --- | --- | -| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description` → 判斷目前主程式與語言 | -| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 所有 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` | +| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description` → 判斷目前主程式與語言（無 manifest 可走 A1a 從零建立） | +| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 主程式依賴鏈的 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` | | C. entrypoint.sh | 產生 `entrypoint.sh`：先輸出 action **名稱／用途／更新時間**，再 `exec` node 主程式 | -| D. Dockerfile | 依六步流程（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生使用**最新 node 版本**的 `Dockerfile`，多階段建置縮小映像、`ENTRYPOINT` 指向 `entrypoint.sh` | +| D. Dockerfile | 依六步流程（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生使用**最新 LTS node 版本**的 `Dockerfile`，多階段建置縮小映像、`ENTRYPOINT` 指向 `entrypoint.sh` | | E. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） | --- @@ -24,19 +24,36 @@ argument-hint: "[--action-dir ] [--node-version ] [- - **編碼無亂碼**：凡輸出含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。產生／覆寫的 `entrypoint.sh`、`Dockerfile`、`action.yml`、`README.md` 同樣需 UTF-8（不含 BOM）。 - **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策，否則各階段只需輸出簡短計畫／進度後直接執行到完成。**一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。 - **不破壞既有工作**：移動 `.js`、改寫主程式、覆寫 `entrypoint.sh`／`Dockerfile`／`action.yml` 前，若工作區有未提交變更，先提醒使用者建議先 commit／備份；**絕不** `reset --hard`／`checkout -f`／`clean`，也不刪除使用者既有原始碼。移動檔案優先用 `git mv` 以保留歷史。 -- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。 -- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、`.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。 +- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依「參數來源優先序」經使用者同意後為之。 +- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`、`.dockerignore`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。 + +--- + +## 參數來源優先序（開發中需要新參數時） + +從零建立（A1a）、主程式 Node 化（階段 B）、產生 `entrypoint.sh`（階段 C）或產生 `Dockerfile`（階段 D）的過程中，若需要新的參數值，依下列順序處理，**前一項可取得就不往下**： + +1. **runner 注入的執行期環境變數（`gitea.*`／`github.*` context 的同源資訊）**：Docker 容器 action 的 `action.yml` 內 expression 幾乎只有 `inputs`／`env` context 可用，但 runner 會把 `gitea.*`／`github.*` 的同源資訊以**執行期環境變數注入容器**——Node 主程式以 `process.env.GITHUB_*` 讀取（如 `GITHUB_REPOSITORY`、`GITHUB_SERVER_URL`、`GITHUB_REF_NAME`、`GITHUB_EVENT_PATH`；Gitea 亦提供 `GITEA_*` 同義變數），`entrypoint.sh` 內以 `$GITHUB_*` 讀取。為同時相容 GitHub Actions，程式內建議讀 `GITHUB_*`。 +2. **環境變數無法取得 → 詢問使用者新增 `inputs`**：以 `AskUserQuestion` 詢問使用者是否新增對應 `input`（名稱／description／`required`／`default`），經同意後於 `inputs` 宣告，容器內以 `INPUT_<大寫名稱>` 環境變數取用（Node 主程式讀 `process.env.INPUT_`）；未經同意**不得**擅自更動 `inputs`／`outputs` 契約。 + +**secrets／vars 一律視為不可用，不列入優先序**：`${{ secrets.* }}`／`${{ vars.* }}` context 在 Docker 容器 action 的 `action.yml`（`runs.args`／`runs.env`）內於 GitHub 為不可用（官方文件僅記載 `inputs` context 可用；runner 也不會把呼叫端的 secrets 自動注入容器）；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證。為求兩邊相容，本 skill 一律視為不可用——參數值本質上屬 secrets／vars 者，直接依第 2 項宣告為 `input`，回報時附上呼叫端 workflow 的傳入寫法： + +```yaml +- uses: /@ + with: + token: ${{ secrets.MY_TOKEN }} # secrets 由呼叫端 workflow 傳入 + registry: ${{ vars.MY_REGISTRY }} # vars 亦同 +``` --- ## 參數 -格式：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]` +格式：`[--action-dir ] [--node-version ] [--main <主程式檔>]` - `--action-dir `：action 專案根目錄。**省略時預設目前工作目錄**（須含 `action.yml`／`action.yaml`，否則依 A1 詢問）。 -- `--node-version `：`Dockerfile` 的 node base image tag（如 `22`、`22-alpine`、`lts`）。**省略時預設使用最新 node 版本**（`node:latest`，見階段 D）。 +- `--node-version `：`Dockerfile` 的 node base image tag（如 `22`、`22-alpine`、`lts`）。**省略時預設使用當前最新 LTS major**（如 `node:22`，見階段 D）。tag 已是 `-alpine`／`-slim` 變體時，build 與 runtime **直接沿用同一 tag**、不再另組 `-slim`。 - `--main <主程式檔>`：指定主程式入口檔（相對 action 根目錄）。省略時依 A3 自動判斷。 -- `--yes`：盡量不中斷。即使帶此參數，「主程式非 Node 需改寫」與 doc-funcs 的「如何實作」仍會詢問。 --- @@ -46,7 +63,17 @@ argument-hint: "[--action-dir ] [--node-version ] [- - 帶 `--action-dir` → 採用（展開 `~`）。 - 省略 → 用目前工作目錄。 -- 根目錄須存在 `action.yml` 或 `action.yaml`（action manifest）。**找不到** action manifest → 回報「此目錄不是 action 專案（缺 action.yml／action.yaml）」並詢問正確路徑，**不臆測**、不在非 action 專案上動工。 +- 根目錄須存在 `action.yml` 或 `action.yaml`（action manifest）。**找不到** action manifest → **不臆測**、不逕自動工；以 `AskUserQuestion` 詢問使用者要「**從零建立**新的 Docker 容器 action」還是「提供正確的 action 路徑」：選「從零建立」→ 進入 A1a；選「提供路徑」→ 依新路徑重跑 A1。 + +### A1a. 從零建立 Docker 容器 action（問答式） + +依序以問答收集需求，再產生 manifest 與主程式骨架： + +1. **action 名稱**：用於 `action.yml` 的 `name`。 +2. **輸入與輸出參數**：逐一收集 `inputs`／`outputs` 的名稱與 `description`（description 盡量繁體中文、無亂碼）、`required`／`default`；沒有可留空。 +3. **執行目標**：詢問此 action 要達成什麼，整理濃縮成一句話作為 `action.yml` 的 `description`（盡量繁體中文、無亂碼）。 + +收集完成後，於 action 根目錄產生：`action.yml`（`runs.using: docker`、`image: Dockerfile`，含收集到的 `name`／`description`／`inputs`／`outputs`）與 `src/index.js` 主程式（依執行目標以 Node 實作，輸入以 `process.env.INPUT_` 讀取，開發中需要新參數時套用「參數來源優先序」）；完成後接續 A2 往後流程（A3 判定為 Node，階段 B 走「已是 Node」分支，階段 C／D 照常產生 `entrypoint.sh` 與 `Dockerfile`）。 ### A2. 讀取 action 名稱與用途 @@ -71,7 +98,7 @@ argument-hint: "[--action-dir ] [--node-version ] [- --- -## 階段 B：主程式 Node 化，並將所有 `.js` 收進 `src/` +## 階段 B：主程式 Node 化，並將主程式依賴鏈的 `.js` 收進 `src/` ### B1. 主程式 Node 化 @@ -82,10 +109,11 @@ argument-hint: "[--action-dir ] [--node-version ] [- - 任何無法可靠等價翻譯處，**不臆測**：以 `// 需人工確認：...` 標註並回報。 - 改寫完成後，原非 Node 主程式於 B2 一併處理（移除或保留由使用者裁示；預設保留並在 README／回報標註已由 Node 取代）。 -### B2. 所有 `.js` 集中到 `src/` +### B2. 主程式依賴鏈的 `.js` 集中到 `src/` - 在 action 根目錄建立 `src/`（若不存在）。 -- 將專案內所有 `.js`／`.mjs`／`.cjs`（排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）**移入 `src/`**，優先 `git mv` 保留歷史。主程式入口統一為 `src/index.js`（或 `src/
.js`）。 +- 將**主程式入口及其 `require`／`import` 依賴鏈**的 `.js`／`.mjs`／`.cjs`（排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）**移入 `src/`**，優先 `git mv` 保留歷史。主程式入口統一為 `src/index.js`（或 `src/
.js`）。 +- **明文排除、不搬**：外部工具依慣例路徑尋找的檔案——`*.config.js`（`eslint.config.js`／`jest.config.js`／`webpack.config.js` 等）、`.*rc.js`、husky／commitlint 等工具設定，以及 `test/`／`tests/`／`scripts/` 目錄；搬走會弄壞 lint／test／build 流程。 - **移動後必須更新所有引用**，確保不破壞： - 模組間的 `require`／`import` 相對路徑。 - `package.json` 的 `main`／`bin`／`scripts`／`exports`（指向 `src/...`）。 @@ -100,10 +128,13 @@ argument-hint: "[--action-dir ] [--node-version ] [- runs: using: docker image: Dockerfile - entrypoint: entrypoint.sh ``` -若原本是 JS action（`using: node*`），改為上述 docker 設定；若已是 docker action，確認 `image` 指向 `Dockerfile`、`entrypoint` 指向 `entrypoint.sh`。 +- **不設 `runs.entrypoint`**：執行入口由 `Dockerfile` 的 `ENTRYPOINT ["/action/entrypoint.sh"]`（絕對路徑）決定。`runs.entrypoint` 會**覆蓋** Dockerfile 的 `ENTRYPOINT`，且 runner 執行 docker action 時容器工作目錄是使用者 repo 的 workspace（不是 `/action`），相對路徑會找不到檔案。若原 manifest 已有 `entrypoint`，改為絕對路徑（`/action/entrypoint.sh`）或直接移除。 +- 若原本是 JS action（`using: node*`），改為上述 docker 設定；若已是 docker action，確認 `image` 指向 `Dockerfile`，並依上一點處理 `entrypoint`。 +- **docker 化代價揭示**（回報即可，不中斷詢問）：轉為 docker action 後**僅能在 Linux runner 執行**、每次 workflow 執行多一段 image build 時間、host 模式的 act_runner 無法執行（runner 需具 Docker 能力）。 + +改寫主程式或對齊 `action.yml` 過程需要新的參數值（如 token、repo 資訊、外部設定）時，依「參數來源優先序」處理，不逕自新增 `inputs`。 --- @@ -111,9 +142,10 @@ runs: 在 action 根目錄產生（或覆寫）`entrypoint.sh`：**啟動 node 主程式前，先輸出 action 名稱、用途、更新時間**。 -- **更新時間**為產生此檔當下的時間戳，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。 +- **更新時間**語意為「本檔最後由本 skill 產生／更新的時間」，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。 - 名稱／用途取自階段 A2 的 `action.yml`。 - 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。 +- **若階段 B 裁示「維持非 Node」**：橫幅照常輸出，最後改以 `exec <原直譯器> <主程式>` 啟動（如 `exec python3 /action/src/main.py "$@"`、`exec sh /action/src/main.sh "$@"`）。 範例（實際路徑依階段 B 入口而定）： @@ -137,9 +169,9 @@ exec node /action/src/index.js "$@" --- -## 階段 D：產生 Dockerfile（使用最新 node 版本，六步流程依主程式實作量身產生） +## 階段 D：產生 Dockerfile（使用最新 LTS node 版本，六步流程依主程式實作量身產生） -在 action 根目錄產生（或覆寫）`Dockerfile`，**base image 使用最新 node 版本**，採**多階段建置**以縮小最終映像檔。六步流程是**骨架**，但**每一步的實際內容必須依階段 B 的主程式（`src/`）實作決定**——不要套用與主程式無關的固定樣板，也不要硬塞主程式用不到的安裝或建置指令。 +在 action 根目錄產生（或覆寫）`Dockerfile`，**base image 使用最新 LTS node 版本（固定 major tag）**，採**多階段建置**以縮小最終映像檔。六步流程是**骨架**，但**每一步的實際內容必須依階段 B 的主程式（`src/`）實作決定**——不要套用與主程式無關的固定樣板，也不要硬塞主程式用不到的安裝或建置指令。 ### D0. 先盤點主程式實作需求 @@ -150,57 +182,60 @@ exec node /action/src/index.js "$@" - **OS 層相依**：主程式是否以 `child_process` 呼叫外部執行檔（如 `git`、`bash`、`openssl`、`python3`、`ffmpeg`、`imagemagick`），或使用需編譯的原生模組（node-gyp／native addon）。決定第 2 步是否要 `apt-get install` 對應套件，以及第 5 步 runtime 基底是否需保留這些執行檔。 - **執行期需求**：主程式讀取的環境變數、需存取的檔案路徑、是否寫入暫存目錄。決定 `WORKDIR`、需 `COPY` 的檔案範圍與必要的 `ENV`。 - **入口檔**：階段 B 決定的主程式入口（如 `src/index.js`），決定第 6 步與 `entrypoint.sh` 內 `node` 路徑。 +- **產生 `.dockerignore`**：於 action 根目錄產生（或補齊）`.dockerignore`，至少排除 `.git`、`.docs`、`node_modules`（宿主端，可能含平台不符的原生模組）與其他非執行必需檔案，避免帶進 build context。 ### D1～D6：依盤點結果填入六步 1. **參數處理**：以 `ARG` 注入 node 版本（預設最新）與主程式需要的 build-time 參數；可調參數集中在檔案開頭。 -2. **安裝套件**：依 D0 的相依結果安裝——有 lockfile 用 `npm ci`、否則 `npm install`；不需 build 時加 `--omit=dev`，需 build 時先裝完整相依（含 dev）供第 4 步使用。**只在主程式真的會用到時**才 `apt-get install` OS 套件，並於同一 `RUN` 清掉 apt 快取。先 `COPY` 相依描述（`package*.json`）再安裝，以利 layer 快取。 -3. **複製檔案**：`COPY` 主程式實際需要的檔案（`src/`、`entrypoint.sh`，及主程式會讀取的資源）；不需要的檔案不必帶入。 +2. **安裝套件**：依 D0 的相依結果安裝——有 lockfile 用 `npm ci`、否則 `npm install`，**二擇一寫死於 Dockerfile**（不得以 `npm ci || npm install` 之類 fallback 串接，避免靜默吞錯、破壞 lockfile 的可重現性）；不需 build 時加 `--omit=dev`，需 build 時先裝完整相依（含 dev）供第 4 步使用。**只在主程式真的會用到時**才 `apt-get install` OS 套件，並於同一 `RUN` 清掉 apt 快取。先 `COPY` 相依描述（`package*.json`）再安裝，以利 layer 快取。 +3. **複製檔案**：`COPY` 主程式實際需要的檔案（`src/`、`entrypoint.sh`，及主程式會讀取的資源），**明列路徑、不整包 `COPY .`**，並配合 `.dockerignore` 排除非必要檔案。 4. **執行程序**：賦予 `entrypoint.sh` 執行權限；**僅當 D0 判定需要 build／transpile 時**才執行（如 `npm run build`），否則此步只做權限設定，不要硬加建置指令。 -5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像。 +5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像；**`COPY --from=build` 必須逐項明列路徑，不得整包 `COPY --from=build /action /action`**（整包搬等於沒有縮小）。 6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。 -base image 版本：預設 build 基底 `node:latest`、runtime 基底 `node:slim`（皆為最新版，slim 用於縮小）；帶 `--node-version `（如 `22`、`lts`）時改用 `node:` 與 `node:-slim`。若需確認當前最新穩定版號，可查詢 Docker Hub（`https://hub.docker.com/_/node`）後於 `FROM` 註記實際版本，但**預設行為是使用最新版**。 +base image 版本：**預設使用產生當下的最新 LTS major 固定 tag**（如 build 基底 `node:22`、runtime 基底 `node:22-slim`）——docker action 每次執行都由 runner 現場 build，用 `latest` 會隨 base 無預警跳版而行為漂移、跨 runner 不一致、無法重現除錯；可查詢 Docker Hub（`https://hub.docker.com/_/node`）確認當前 LTS 版號。帶 `--node-version ` 時改用 `node:` 與 `node:-slim`；`latest` 僅在**使用者明確要求**時使用（此時 runtime 用 `node:slim`，因為沒有 `node:latest-slim` 這個 tag）。 下列為**最簡基準骨架**（純 JS、無 build、無 OS 相依的情況）；實際內容須依 D0 盤點調整，第 4 步建置、第 2／5 步 OS 套件等視主程式需要增刪： ```Dockerfile -# syntax=docker/dockerfile:1 - -# 1. 參數處理：node 版本以 ARG 注入（預設最新版；--node-version 可覆寫） -ARG NODE_VERSION=latest -ARG NODE_RUNTIME=slim +# 1. 參數處理：node 版本以 ARG 注入（預設當前最新 LTS major，範例為 22；--node-version 可覆寫） +ARG NODE_VERSION=22 +ARG NODE_RUNTIME=22-slim # ---- build 階段：安裝相依、準備產物 ---- FROM node:${NODE_VERSION} AS build WORKDIR /action # 2. 安裝套件：先帶相依描述以利 layer 快取，再裝 src/ 相依 -# （需 build 時改裝完整相依；需 OS 套件時於此 apt-get install 並清快取） +# （依 D0 盤點二擇一寫死：有 lockfile 用 npm ci、否則 npm install，不用 || 串接； +# 需 build 時改裝完整相依；需 OS 套件時於此 apt-get install 並清快取） COPY src/package*.json /action/src/ RUN if [ -f /action/src/package.json ]; then \ - cd /action/src && (npm ci --omit=dev || npm install --omit=dev); \ + cd /action/src && npm ci --omit=dev; \ fi -# 3. 複製檔案：複製主程式實際需要的檔案 -COPY . /action +# 3. 複製檔案：明列主程式實際需要的檔案（配合 .dockerignore，不整包 COPY .） +COPY src/ /action/src/ +COPY entrypoint.sh /action/entrypoint.sh # 4. 執行程序：賦予 entrypoint 執行權限（D0 判定需要 build 時於此 npm run build） RUN chmod +x /action/entrypoint.sh -# 5. 縮小映像檔：多階段建置，runtime 改用 slim 基底、只帶必要產物 +# 5. 縮小映像檔：多階段建置，runtime 改用 slim 基底，逐項明列只帶執行真正需要的產物 # （有 build 產物時改帶 dist/ 與 production node_modules；runtime 需要的 OS 執行檔於此安裝） FROM node:${NODE_RUNTIME} AS runtime WORKDIR /action -COPY --from=build /action /action +COPY --from=build /action/src /action/src +COPY --from=build /action/entrypoint.sh /action/entrypoint.sh # 6. 設定入口：以 entrypoint.sh 啟動（其內 node 指向 D0 的入口檔） ENTRYPOINT ["/action/entrypoint.sh"] ``` - **依主程式實作**：上面只是基準骨架。若主程式是 TypeScript／需打包，第 4 步要加 `npm run build`、第 5 步只帶 `dist/` 與 production 相依；若主程式會 spawn 外部執行檔或用原生模組，第 2／5 步要補對應 OS 套件；用不到的步驟內容不要硬塞。 -- **版號對齊**：runtime 的 slim 基底版號需與 build 基底一致。預設 `node:latest` ↔ `node:slim`；帶 `--node-version 22` 時設 `NODE_VERSION=22`、`NODE_RUNTIME=22-slim`。注意**沒有 `node:latest-slim` 這個 tag**，最新版 slim 一律用 `node:slim`，故以獨立的 `NODE_RUNTIME` 參數帶入、不要用 `${NODE_VERSION}-slim` 組裝。 -- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式。 +- **若階段 B 裁示「維持非 Node」**：base image 改用對應語言官方映像（如 `python:3-slim`），第 2 步改安裝該生態相依（如 `pip install -r requirements.txt`），其餘六步結構不變；`ENTRYPOINT` 仍指向 `entrypoint.sh`（其內 `exec` 原直譯器，見階段 C）。 +- **版號對齊**：runtime 基底版號需與 build 基底一致。預設 LTS 固定 tag（如 `NODE_VERSION=22`、`NODE_RUNTIME=22-slim`）；帶 `--node-version` 時同理對應。tag 已是 `-alpine`／`-slim` 變體（如 `22-alpine`）時，build 與 runtime **直接沿用同一 tag**、不再另組 `-slim`（沒有 `node:22-alpine-slim` 這種 tag）。使用者明確要求 `latest` 時 runtime 用 `node:slim`（**沒有 `node:latest-slim`**）。故一律以獨立的 `NODE_RUNTIME` 參數帶入、不要用 `${NODE_VERSION}-slim` 組裝。 +- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式；`action.yml` 的 `runs.entrypoint` 若存在，必須是**絕對路徑**且與 `Dockerfile` 落點一致（預設不設，讓 Dockerfile 的 `ENTRYPOINT` 生效）。 - 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 doc-funcs 指令檔流程統一補齊。 --- @@ -209,10 +244,12 @@ ENTRYPOINT ["/action/entrypoint.sh"] 容器化與 Node 化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： +- **前置檢查**：先確認 doc-funcs skill 可用（`/jsc:doc-funcs`）；不可用則回報並**略過本階段**，於總結標註「未文件化」。 - 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 - doc-funcs 會涵蓋本次新增／變更的指令檔：`entrypoint.sh`（補齊「用途＋更新日期同一註解區塊」與逐行註解）、`Dockerfile`（逐行註解）；以及 `src/` 內 Node 主程式與各 function 的文件註解。 - doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 - 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 +- **統一時間戳**：doc-funcs 全部完成後，以完成當下的 Asia/Taipei 時間（`yyyy/MM/dd HH:mm:ss`）回頭同步 `entrypoint.sh` 橫幅輸出與註解區塊、`Dockerfile` 註解區塊與 README 的更新時間，**確保各處時間戳一致**。 > 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的 action 根目錄為目標專案。 @@ -222,8 +259,8 @@ ENTRYPOINT ["/action/entrypoint.sh"] 各階段執行後輸出： -- **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node。 -- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）。 +- **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。 +- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。 - **階段 C／D**：`entrypoint.sh` 的輸出內容（名稱／用途／更新時間）與啟動的 node 主程式、`Dockerfile` 採用的 node 版本與 `ENTRYPOINT`。 - **階段 E**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。 - 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。 @@ -232,10 +269,10 @@ ENTRYPOINT ["/action/entrypoint.sh"] ## 呼叫方式 -格式：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]` — 全部可省略（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷）。 +格式：`[--action-dir ] [--node-version ] [--main <主程式檔>]` — 全部可省略（根目錄預設目前工作目錄；node 版本預設最新 LTS；主程式自動判斷）。 | 助理 | 呼叫 | | --- | --- | | Claude Code / Antigravity | `/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22` | | Codex | `$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 | -| OpenCode | 描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 | +| OpenCode | 描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 | -- 2.53.0 From fc39c1254d3961bce58b3bdefa0dc55246fe63e5 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 16 Jul 2026 16:03:57 +0800 Subject: [PATCH 22/27] =?UTF-8?q?docs(README):=20=E5=90=8C=E6=AD=A5=20code?= =?UTF-8?q?-action-composite=EF=BC=8Fcode-action-docker=20=E7=AB=A0?= =?UTF-8?q?=E7=AF=80=E7=9A=84=E5=8F=83=E6=95=B8=E5=84=AA=E5=85=88=E5=BA=8F?= =?UTF-8?q?=E3=80=81=E5=BE=9E=E9=9B=B6=E5=BB=BA=E7=AB=8B=E8=88=87=20Docker?= =?UTF-8?q?file=20=E8=A6=8F=E5=89=87=E8=AA=AA=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index eef42ec..43b58c7 100644 --- a/README.md +++ b/README.md @@ -235,19 +235,19 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re ### `code-action-docker` -把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把所有 `.js` 集中到 **`src/`**、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 node 版本**的 `Dockerfile`，**每步內容依主程式（`src/`）實作量身決定**（先盤點相依／是否需 build／OS 層相依／入口檔再填對應步驟，用不到的不硬塞），預設 build 基底 `node:latest`、runtime `node:slim`、**多階段建置縮小映像**，`ENTRYPOINT` 指向 `entrypoint.sh`；(E) 對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README）。 +把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把**主程式依賴鏈**的 `.js` 集中到 **`src/`**（工具設定檔與測試目錄不搬）、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`（`runs` 只設 `using: docker`＋`image: Dockerfile`，**不設相對路徑的 `entrypoint`**，入口由 Dockerfile 的絕對路徑 `ENTRYPOINT` 決定）；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 LTS node 版本（固定 major tag）**的 `Dockerfile`，**每步內容依主程式（`src/`）實作量身決定**（先盤點相依／是否需 build／OS 層相依／入口檔並產生 `.dockerignore`，再填對應步驟，用不到的不硬塞），預設 build 基底為當前 LTS（如 `node:22`）、runtime 對應 `-slim`（如 `node:22-slim`），**多階段建置逐項明列必要產物**（不整包 COPY）縮小映像，`ENTRYPOINT` 指向 `entrypoint.sh`（絕對路徑）；(E) 對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 runner 注入容器的 `GITHUB_*`／`GITEA_*` 執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊；docker action 的 `action.yml` 幾乎只有 `inputs`／`env` context 可用），無法取得才經使用者同意**新增 `inputs`**（容器內讀 `INPUT_*`）；`secrets`／`vars` context 在 docker action 內**一律視為不可用**（GitHub 官方文件僅記載 `inputs` context、runner 不注入 secrets；Gitea 行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 docker `action.yml` 與 `src/index.js` 骨架，再接後續階段）。skill 各檔的「更新時間」於最終階段（doc-funcs 完成後）**統一同步為同一時間戳**。 -參數：`[--action-dir ] [--node-version ] [--main <主程式檔>] [--yes]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷；`--yes` 略過一般確認，但主程式改寫與 doc-funcs 的實作詢問仍會中斷）。 +參數：`[--action-dir ] [--node-version ] [--main <主程式檔>]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷）。 - **Claude Code / Antigravity**：`/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22` - **Codex**：`$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 -- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 +- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 ### `code-action-composite` -把 Gitea／GitHub「composite action」專案標準化，再串接文件化流程。四階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs`、判斷是否為 composite；(B) **已是 composite 則保留既有 `steps`**，非 composite（JS／Docker）則**保守確認後對齊**為 composite（高風險先以 AskUserQuestion 確認，保留 `inputs`／`outputs` 契約；Docker 行為無法等價塞入時標「需人工確認」並建議改用 `code-action-docker`）；(C) 在 `runs.steps` **最前面注入啟動橫幅 step**，輸出 action **名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`，固定字串），並於 `action.yml` 開頭補用途／更新時間註解區塊（既有橫幅 step 則更新而非重插）；(D) 對整個專案**完整執行 `/jsc:doc-funcs`**（`action.yml` 與被引用腳本逐行註解、function 文件、重建 README）。 +把 Gitea／GitHub「composite action」專案標準化，再串接文件化流程。四階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs`、判斷是否為 composite；(B) **已是 composite 則保留既有 `steps`**，非 composite（JS／Docker）則**保守確認後對齊**為 composite（高風險先以 AskUserQuestion 確認；JS action 轉換須補 `INPUT_*` env 映射與 `outputs.value` 轉接以保留 `inputs`／`outputs` 契約；Docker 行為無法等價塞入時標「需人工確認」並建議改用 `code-action-docker`）；(C) 在 `runs.steps` **最前面注入啟動橫幅 step**，輸出 action **名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`，固定字串），並於 `action.yml` 開頭補用途／更新時間註解區塊（既有橫幅 step 則更新而非重插）；(D) 對整個專案**完整執行 `/jsc:doc-funcs`**（`action.yml` 與被引用腳本逐行註解、function 文件、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 `${{ gitea.* }}`／`${{ github.* }}` context（Gitea 中兩者互為別名，composite step 內可直接使用、`run` 腳本內可讀同源 `$GITHUB_*` 環境變數），無法取得才經使用者同意**新增 `inputs`**；`secrets`／`vars` context 在 composite action 內**一律視為不可用**（GitHub 官方明文限制；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 composite `action.yml` 並實作 steps，再接後續階段）。skill 各檔的「更新時間」於最終階段（doc-funcs 完成後）**統一同步為同一時間戳**。 -參數：`[--action-dir ] [--manifest ] [--yes]`（根目錄預設目前工作目錄；manifest 自動尋找 `action.yml`／`action.yaml`；`--yes` 略過一般確認，但「非 composite 需對齊」與 doc-funcs 的實作詢問仍會中斷）。 +參數：`[--action-dir ] [--manifest ]`（根目錄預設目前工作目錄；manifest 自動尋找 `action.yml`／`action.yaml`）。 - **Claude Code / Antigravity**：`/jsc:code-action-composite`，或 `/jsc:code-action-composite --action-dir ~/work/my-action` - **Codex**：`$code-action-composite`，或 `$code-action-composite --action-dir ~/work/my-action`，或用 `/skills` 選單 -- 2.53.0 From 7814e2edeae9b38ba87c6faefd42a9010939118d Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 08:58:04 +0800 Subject: [PATCH 23/27] =?UTF-8?q?refactor(skills=20=E5=85=B1=E7=94=A8?= =?UTF-8?q?=E8=A6=8F=E7=AF=84):=20=E6=8A=BD=E5=87=BA=E5=85=B1=E7=94=A8?= =?UTF-8?q?=E8=A6=8F=E7=AF=84=E8=87=B3=20generic=20spec-*=EF=BC=8C?= =?UTF-8?q?=E4=BB=A5=E5=BC=95=E7=94=A8=EF=BC=8B=E4=B8=80=E8=A1=8C=20fallba?= =?UTF-8?q?ck=20=E6=91=98=E8=A6=81=E5=8F=96=E4=BB=A3=E9=87=8D=E8=A4=87?= =?UTF-8?q?=E5=85=A7=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- skills/code-action-composite/SKILL.md | 49 +++++++++--------------- skills/code-action-docker/SKILL.md | 54 +++++++++++---------------- skills/code-image/SKILL.md | 43 +++++++++------------ skills/code-issues/SKILL.md | 35 +++++++---------- skills/code-nuget/SKILL.md | 10 ++++- skills/code-review-archive/SKILL.md | 11 +++--- skills/code-review-resolve/SKILL.md | 31 +++++++-------- skills/code-review/SKILL.md | 14 ++++--- skills/code-sync/SKILL.md | 35 +++++++---------- 9 files changed, 119 insertions(+), 163 deletions(-) diff --git a/skills/code-action-composite/SKILL.md b/skills/code-action-composite/SKILL.md index 2f2a0bc..3ad4995 100644 --- a/skills/code-action-composite/SKILL.md +++ b/skills/code-action-composite/SKILL.md @@ -17,32 +17,28 @@ argument-hint: "[--action-dir ] [--manifest }}` 取用；未經同意**不得**擅自更動 `inputs`／`outputs` 契約。 - -**secrets／vars 一律視為不可用，不列入優先序**：`${{ secrets.* }}`／`${{ vars.* }}` context 在 composite action 的 `action.yml` 內於 GitHub 為**官方明文不可用**（composite action 取不到 `secrets`／`vars` context，`inputs` 的 `default` 也不能引用）；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證。為求兩邊相容，本 skill 一律視為不可用——參數值本質上屬 secrets／vars 者，直接依第 2 項宣告為 `input`，回報時附上呼叫端 workflow 的傳入寫法： - -```yaml -- uses: /@ - with: - token: ${{ secrets.MY_TOKEN }} # secrets 由呼叫端 workflow 傳入 - registry: ${{ vars.MY_REGISTRY }} # vars 亦同 -``` +從零建立（A1a）、對齊 composite（階段 B）、注入橫幅 step（階段 C）或補強被引用腳本的過程中，若需要新的參數值，一律依 `/jsc:spec-action-params` 的優先序處理：composite 的 `runs.steps` 內優先取 `${{ gitea.* }}`／`${{ github.* }}` context（建議寫 `github.*` 以相容兩邊；`run` 腳本內可改讀 `$GITHUB_*` 環境變數），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。 --- @@ -146,7 +142,7 @@ runs: 在 `runs.steps` **最前面**插入（或更新）一個輸出橫幅的 step，讓 composite action 一啟動就**輸出 action 名稱、用途、更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊。 -- **更新時間**語意為「本檔最後由本 skill 產生／更新的時間」，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。本階段先寫入暫定時間戳，**階段 D 完成後會統一同步各處時間戳**（見階段 D）。 +- **更新時間**依 `/jsc:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 D 完成後會統一同步各處時間戳**（見階段 D）。 - 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。 - 橫幅 step 須有可辨識的 `name`（如 `顯示 action 資訊`）與 `shell: bash`；其後緊接既有／對齊後的 steps，**不更動既有 steps**。 - 若已存在本 skill 先前插入的橫幅 step（依 `name` 辨識），則**更新**其內容與更新時間，不重複插入。 @@ -182,16 +178,7 @@ runs: ## 階段 D：完整執行 /jsc:doc-funcs 處理流程 -標準化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： - -- **前置檢查**：先確認 doc-funcs skill 可用（`/jsc:doc-funcs`）；不可用則回報並**略過本階段**，於總結標註「未文件化」。 -- 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 -- doc-funcs 會把 `action.yml`／`action.yaml` 視為 CI／部署設定檔處理：補齊「用途＋更新日期同一註解區塊」與逐行註解；`steps` 內引用的腳本（`*.sh`／`*.ps1` 等）逐行註解；專案內各 function 補文件註解。 -- doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 -- 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 -- **統一時間戳**：doc-funcs 全部完成後，以完成當下的 Asia/Taipei 時間（`yyyy/MM/dd HH:mm:ss`）回頭同步橫幅 step 內文、`action.yml` 開頭註解區塊與 README 的更新時間，**確保各處時間戳一致**。 - -> 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的 action 根目錄為目標專案。 +標準化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README）。完成後依該 spec **統一時間戳**：回頭同步橫幅 step 內文、`action.yml` 開頭註解區塊與 README 的更新時間，確保各處一致。 --- diff --git a/skills/code-action-docker/SKILL.md b/skills/code-action-docker/SKILL.md index c9a35a7..ff79e8c 100644 --- a/skills/code-action-docker/SKILL.md +++ b/skills/code-action-docker/SKILL.md @@ -18,32 +18,29 @@ argument-hint: "[--action-dir ] [--node-version ] [- --- -## 輸出規範（務必遵守） +## 共用規範（generic plugin，必要前置） -- **語言**：所有面向使用者的輸出（計畫、進度、總結、反問）一律使用**繁體中文（台灣用語）**；僅識別字、檔名、git／docker 指令、API 路徑、程式碼等技術標識保留原文，**不可**使用簡體字。 -- **編碼無亂碼**：凡輸出含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。產生／覆寫的 `entrypoint.sh`、`Dockerfile`、`action.yml`、`README.md` 同樣需 UTF-8（不含 BOM）。 -- **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策，否則各階段只需輸出簡短計畫／進度後直接執行到完成。**一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。 -- **不破壞既有工作**：移動 `.js`、改寫主程式、覆寫 `entrypoint.sh`／`Dockerfile`／`action.yml` 前，若工作區有未提交變更，先提醒使用者建議先 commit／備份；**絕不** `reset --hard`／`checkout -f`／`clean`，也不刪除使用者既有原始碼。移動檔案優先用 `git mv` 以保留歷史。 -- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依「參數來源優先序」經使用者同意後為之。 -- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`、`.dockerignore`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。 +- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。 +- `/jsc:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。 +- `/jsc:spec-action-params`：action 參數來源優先序（環境變數 → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。 +- `/jsc:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。 +- `/jsc:spec-dockerfile`：Dockerfile 六步流程、多階段建置、固定版號、自我檢查。 +- `/jsc:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc:doc-funcs` 的標準流程。 + +本 skill 特有補充： + +- **一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。 +- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc:spec-action-params` 經使用者同意後為之。 +- **本 skill 只動**：action 專案根目錄內的主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`、`.dockerignore`，以及階段 E 由 doc-funcs 流程處理的目標。 --- ## 參數來源優先序（開發中需要新參數時） -從零建立（A1a）、主程式 Node 化（階段 B）、產生 `entrypoint.sh`（階段 C）或產生 `Dockerfile`（階段 D）的過程中，若需要新的參數值，依下列順序處理，**前一項可取得就不往下**： - -1. **runner 注入的執行期環境變數（`gitea.*`／`github.*` context 的同源資訊）**：Docker 容器 action 的 `action.yml` 內 expression 幾乎只有 `inputs`／`env` context 可用，但 runner 會把 `gitea.*`／`github.*` 的同源資訊以**執行期環境變數注入容器**——Node 主程式以 `process.env.GITHUB_*` 讀取（如 `GITHUB_REPOSITORY`、`GITHUB_SERVER_URL`、`GITHUB_REF_NAME`、`GITHUB_EVENT_PATH`；Gitea 亦提供 `GITEA_*` 同義變數），`entrypoint.sh` 內以 `$GITHUB_*` 讀取。為同時相容 GitHub Actions，程式內建議讀 `GITHUB_*`。 -2. **環境變數無法取得 → 詢問使用者新增 `inputs`**：以 `AskUserQuestion` 詢問使用者是否新增對應 `input`（名稱／description／`required`／`default`），經同意後於 `inputs` 宣告，容器內以 `INPUT_<大寫名稱>` 環境變數取用（Node 主程式讀 `process.env.INPUT_`）；未經同意**不得**擅自更動 `inputs`／`outputs` 契約。 - -**secrets／vars 一律視為不可用，不列入優先序**：`${{ secrets.* }}`／`${{ vars.* }}` context 在 Docker 容器 action 的 `action.yml`（`runs.args`／`runs.env`）內於 GitHub 為不可用（官方文件僅記載 `inputs` context 可用；runner 也不會把呼叫端的 secrets 自動注入容器）；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證。為求兩邊相容，本 skill 一律視為不可用——參數值本質上屬 secrets／vars 者，直接依第 2 項宣告為 `input`，回報時附上呼叫端 workflow 的傳入寫法： - -```yaml -- uses: /@ - with: - token: ${{ secrets.MY_TOKEN }} # secrets 由呼叫端 workflow 傳入 - registry: ${{ vars.MY_REGISTRY }} # vars 亦同 -``` +從零建立（A1a）、主程式 Node 化（階段 B）、產生 `entrypoint.sh`（階段 C）或產生 `Dockerfile`（階段 D）的過程中，若需要新的參數值，一律依 `/jsc:spec-action-params` 的優先序處理：Docker 容器 action 優先取 runner 注入的執行期環境變數（Node 主程式讀 `process.env.GITHUB_*`、`entrypoint.sh` 讀 `$GITHUB_*`；Gitea 亦提供 `GITEA_*` 同義變數，建議讀 `GITHUB_*` 以相容兩邊），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`（容器內以 `INPUT_<大寫名稱>` 取用）；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。 --- @@ -142,7 +139,7 @@ runs: 在 action 根目錄產生（或覆寫）`entrypoint.sh`：**啟動 node 主程式前，先輸出 action 名稱、用途、更新時間**。 -- **更新時間**語意為「本檔最後由本 skill 產生／更新的時間」，使用台灣時區（Asia/Taipei）並固定為 `yyyy/MM/dd HH:mm:ss`（可用 `TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'` 取得），**寫成檔內固定字串**（非執行期動態時間）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。 +- **更新時間**依 `/jsc:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。 - 名稱／用途取自階段 A2 的 `action.yml`。 - 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。 - **若階段 B 裁示「維持非 Node」**：橫幅照常輸出，最後改以 `exec <原直譯器> <主程式>` 啟動（如 `exec python3 /action/src/main.py "$@"`、`exec sh /action/src/main.sh "$@"`）。 @@ -193,7 +190,7 @@ exec node /action/src/index.js "$@" 5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像；**`COPY --from=build` 必須逐項明列路徑，不得整包 `COPY --from=build /action /action`**（整包搬等於沒有縮小）。 6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。 -base image 版本：**預設使用產生當下的最新 LTS major 固定 tag**（如 build 基底 `node:22`、runtime 基底 `node:22-slim`）——docker action 每次執行都由 runner 現場 build，用 `latest` 會隨 base 無預警跳版而行為漂移、跨 runner 不一致、無法重現除錯；可查詢 Docker Hub（`https://hub.docker.com/_/node`）確認當前 LTS 版號。帶 `--node-version ` 時改用 `node:` 與 `node:-slim`；`latest` 僅在**使用者明確要求**時使用（此時 runtime 用 `node:slim`，因為沒有 `node:latest-slim` 這個 tag）。 +base image 版本依 `/jsc:spec-dockerfile`（固定 major tag、不用 `latest`）：**預設使用產生當下的最新 LTS major 固定 tag**（如 build 基底 `node:22`、runtime 基底 `node:22-slim`），可查詢 Docker Hub（`https://hub.docker.com/_/node`）確認當前 LTS 版號；帶 `--node-version ` 時改用 `node:` 與 `node:-slim`。 下列為**最簡基準骨架**（純 JS、無 build、無 OS 相依的情況）；實際內容須依 D0 盤點調整，第 4 步建置、第 2／5 步 OS 套件等視主程式需要增刪： @@ -234,7 +231,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] - **依主程式實作**：上面只是基準骨架。若主程式是 TypeScript／需打包，第 4 步要加 `npm run build`、第 5 步只帶 `dist/` 與 production 相依；若主程式會 spawn 外部執行檔或用原生模組，第 2／5 步要補對應 OS 套件；用不到的步驟內容不要硬塞。 - **若階段 B 裁示「維持非 Node」**：base image 改用對應語言官方映像（如 `python:3-slim`），第 2 步改安裝該生態相依（如 `pip install -r requirements.txt`），其餘六步結構不變；`ENTRYPOINT` 仍指向 `entrypoint.sh`（其內 `exec` 原直譯器，見階段 C）。 -- **版號對齊**：runtime 基底版號需與 build 基底一致。預設 LTS 固定 tag（如 `NODE_VERSION=22`、`NODE_RUNTIME=22-slim`）；帶 `--node-version` 時同理對應。tag 已是 `-alpine`／`-slim` 變體（如 `22-alpine`）時，build 與 runtime **直接沿用同一 tag**、不再另組 `-slim`（沒有 `node:22-alpine-slim` 這種 tag）。使用者明確要求 `latest` 時 runtime 用 `node:slim`（**沒有 `node:latest-slim`**）。故一律以獨立的 `NODE_RUNTIME` 參數帶入、不要用 `${NODE_VERSION}-slim` 組裝。 +- **版號對齊**：依 `/jsc:spec-dockerfile`（runtime 與 build 版號一致、以獨立 runtime ARG 帶入不用 `${VERSION}-slim` 組裝、`-alpine`／`-slim` 變體沿用同一 tag、使用者要求 `latest` 時 runtime 用 `node:slim`）。 - **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式；`action.yml` 的 `runs.entrypoint` 若存在，必須是**絕對路徑**且與 `Dockerfile` 落點一致（預設不設，讓 Dockerfile 的 `ENTRYPOINT` 生效）。 - 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 doc-funcs 指令檔流程統一補齊。 @@ -242,16 +239,7 @@ ENTRYPOINT ["/action/entrypoint.sh"] ## 階段 E：完整執行 /jsc:doc-funcs 處理流程 -容器化與 Node 化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： - -- **前置檢查**：先確認 doc-funcs skill 可用（`/jsc:doc-funcs`）；不可用則回報並**略過本階段**，於總結標註「未文件化」。 -- 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 -- doc-funcs 會涵蓋本次新增／變更的指令檔：`entrypoint.sh`（補齊「用途＋更新日期同一註解區塊」與逐行註解）、`Dockerfile`（逐行註解）；以及 `src/` 內 Node 主程式與各 function 的文件註解。 -- doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 -- 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 -- **統一時間戳**：doc-funcs 全部完成後，以完成當下的 Asia/Taipei 時間（`yyyy/MM/dd HH:mm:ss`）回頭同步 `entrypoint.sh` 橫幅輸出與註解區塊、`Dockerfile` 註解區塊與 README 的更新時間，**確保各處時間戳一致**。 - -> 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的 action 根目錄為目標專案。 +容器化與 Node 化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次新增／變更的 `entrypoint.sh`、`Dockerfile` 與 `src/` 內 Node 主程式都會被涵蓋）。完成後依該 spec **統一時間戳**：回頭同步 `entrypoint.sh` 橫幅輸出與註解區塊、`Dockerfile` 註解區塊與 README 的更新時間，確保各處一致。 --- diff --git a/skills/code-image/SKILL.md b/skills/code-image/SKILL.md index 1c063e7..6da2da2 100644 --- a/skills/code-image/SKILL.md +++ b/skills/code-image/SKILL.md @@ -16,14 +16,21 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile ] [--dockerfile ` 帶入**執行所必需**的產物（執行檔／發佈輸出／必要相依／靜態資源），避免把 build 階段的快取、原始碼與 dev 工具帶進最終映像；同步搬移 runtime 階段需要的 `ENV`／`WORKDIR`／`EXPOSE`／`USER`。 -6. **設定入口**：`ENTRYPOINT`／`CMD` 置於最後，語意與原檔一致。 +在**保留建置行為**的前提下，把目標 `Dockerfile` 的指令重整／歸位為 `/jsc:spec-dockerfile` 定義的**固定六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口），並採**多階段建置**縮小最終映像；各步要點（ARG 集中檔首、相依描述先 `COPY`、同層清理快取、`COPY --from` 逐項明列、搬移 runtime 需要的 `ENV`／`WORKDIR`／`EXPOSE`／`USER`）依該 spec。 **重整原則（關鍵）** @@ -84,7 +84,7 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile ./ ENTRYPOINT [] ``` -- **自我檢查**：重整後確認 (1) `ARG` 在使用它的 `FROM` 之後有重新宣告（跨階段 `ARG` 規則）；(2) runtime 階段 `COPY --from` 帶齊執行所需全部產物；(3) `ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV` 與原檔語意一致；(4) 路徑（`WORKDIR`／`COPY` 落點）一致、容器能找到入口。 +- **自我檢查**：依 `/jsc:spec-dockerfile` 的自我檢查清單（跨階段 `ARG` 重新宣告、runtime 帶齊產物、對外契約一致、路徑一致）。 - 此檔的「用途／更新日期」開頭註解區塊與逐行註解，於階段 C 由 `/jsc:doc-funcs` 的指令檔流程統一補齊／覆寫為標準格式；本階段先確保**建置行為**正確、六步結構清楚即可。 - **建置驗證**：若環境可執行 `docker build`，重整後做一次建置驗證（或至少 `docker build --check`／語法檢查）確認可建置；無法執行時明確說明原因並標註風險（階段 C doc-funcs 第 11 步亦會做語法驗證）。 @@ -128,14 +128,7 @@ ENTRYPOINT [] ## 階段 C：完整執行 /jsc:doc-funcs 處理流程 -Dockerfile 六步整理完成後，對**整個專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README： - -- 以階段 A1 的專案根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。 -- doc-funcs 會把本次整理的 `Dockerfile` 視為部署設定檔處理：補齊「用途＋更新日期同一註解區塊」與逐行註解（每行有效指令上方或行尾說明其作用、為何需要、重要參數或副作用）；專案內各 function 補文件註解；其他指令檔（腳本／CI／`docker-compose*` 等）一併處理。 -- doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。 -- 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。 - -> 銜接方式：在本 skill 環境中以 `/jsc:doc-funcs`（或 Skill 工具）啟動 doc-funcs 流程；若該流程需參數，沿用本 skill 的專案根目錄為目標專案。 +Dockerfile 六步整理完成後，以階段 A1 的專案根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次整理的 `Dockerfile` 會被視為部署設定檔補齊標頭與逐行註解）。 --- diff --git a/skills/code-issues/SKILL.md b/skills/code-issues/SKILL.md index c2320f3..3836993 100644 --- a/skills/code-issues/SKILL.md +++ b/skills/code-issues/SKILL.md @@ -21,15 +21,20 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 ## 絕對準則（不可違反） - **不建立任何草稿檔**：不寫 `.docs/`、不寫暫存檔、不用本機檔案傳遞中間結果。需求彙整、TODO 排序、實作進度、驗證結果等所有中間成果，一律留在**對話內容**，並透過 `tea` 或 Gitea API **保存到議題描述或議題留言**。唯一例外是階段 E 在議題範圍內對**目標 repo 原始碼**的正常程式修改。 -- **盡量使用表格或圖形**：面向使用者的輸出與寫入議題的內容（需求彙整、TODO 列表、進度回報），優先以 **Markdown 表格**與 **Mermaid 圖**（` ```mermaid ` flowchart／stateDiagram，Gitea 可直接渲染）呈現，讓使用者一眼看懂意圖；圖表必須忠實反映議題內容，不得杜撰。 +- **盡量使用表格或圖形**：依 `/jsc:spec-output` — 面向使用者的輸出與寫入議題的內容（需求彙整、TODO 列表、進度回報），優先以 Markdown 表格與 Mermaid 圖呈現，忠實反映議題內容、不得杜撰。 -## 輸出規範（務必遵守） +## 共用規範（generic plugin，必要前置） -- **語言**：所有面向使用者的輸出與寫入議題的描述／留言，一律使用**繁體中文（台灣用語）**；僅程式碼識別字、檔名、指令、API 路徑等技術標識保留原文，**不可**使用簡體字。 -- **編碼無亂碼**：凡輸出或寫入含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。用 API 送出議題描述／留言時，以 UTF-8 JSON 檔帶入（如 `--data @body.json`），換行必須是實際換行，不可讓議題顯示字面 `\n`。 -- **Token 機密保護（極重要）**：gitea token 一律**從環境變數讀取**（`$GITEA_TOKEN`），**絕不**寫死、不 echo、不寫進議題或 log；顯示給使用者的指令／錯誤訊息一律**遮蔽 token**（以 `***` 取代）。檢查時只輸出「已設定／未設定」。 -- **不依賴 `jq`**（環境未必安裝）：解析 JSON 用 `tea` 的結構化輸出（`--output csv` / `--fields`），或把原始 JSON 直接交給助理解析，不要 pipe 到 `jq`。 -- **自動執行原則**：除非遇到不可忽略的必要決策（工具皆不可用、專案不明、議題編號缺失、TODO 與需求衝突需人工裁示、實作失敗需使用者決策），否則各階段輸出簡短計畫／進度後直接執行到完成；帶 `--yes` 時更不應為一般寫入／留言反覆詢問。階段 A／B／C 的詢問在「可跳過條件」成立時**必須跳過**，不要重複確認已知資訊。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、API body 以 UTF-8 JSON 檔帶入且換行為實際換行。 +- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、已知資訊跳過詢問。 +- `/jsc:spec-gitea`：tea／API 工具選擇與檢查、`GITEA_TOKEN` 機密保護（不 echo、遮蔽）、不依賴 `jq`、API 分頁完整讀取。 + +本 skill 特有補充： + +- **必要決策**（會中斷詢問）：工具皆不可用、專案不明、議題編號缺失、TODO 與需求衝突需人工裁示、實作失敗需使用者決策。 +- 階段 A／B／C 的詢問在「可跳過條件」成立時**必須跳過**，不要重複確認已知資訊。 --- @@ -49,21 +54,7 @@ argument-hint: "[--tool ] [--repo ] [--issues <編號,以 **若使用者已透過 `--tool` 或對話明確選定工具，跳過詢問**，只做該工具的可用性驗證。 -1. 檢查 `tea` 是否存在：`command -v tea`；存在則執行 `tea login list` 記錄可用 login 與 host（失敗記錄原因，不中止）。 -2. 檢查 `GITEA_TOKEN` 是否已設定，只輸出「已設定／未設定」，不得輸出 token 內容： - - ```bash - [ -n "${GITEA_TOKEN}" ] && echo "GITEA_TOKEN 已設定" || echo "GITEA_TOKEN 未設定" - ``` - -3. 以表格呈現檢查結果後詢問使用者要用哪一種： - - | 選項 | 可選條件 | 後續使用方式 | - | --- | --- | --- | - | `tea` | `tea` 可執行且目標 host 有對應 login | 命令一律帶 `--login --repo /` | - | `api` | `GITEA_TOKEN` 已設定 | Gitea REST API + `curl`，標頭 `Authorization: token $GITEA_TOKEN` | - -4. 兩種方式都不可用 → 回報缺少 `tea login` 或 `GITEA_TOKEN` 並停止；不要請使用者把 token 貼進對話。 +依 `/jsc:spec-gitea` 的工具選擇流程執行：檢查 `tea`（`command -v tea`、`tea login list`）與 `GITEA_TOKEN`（只輸出「已設定／未設定」）→ 以表格呈現檢查結果後詢問使用者要用 `tea` 或 `api` → 兩種方式都不可用則回報並停止（不要請使用者把 token 貼進對話）。 ## 階段 B：確認議題所在專案（已知則跳過） diff --git a/skills/code-nuget/SKILL.md b/skills/code-nuget/SKILL.md index b3fbd5c..fc576b1 100644 --- a/skills/code-nuget/SKILL.md +++ b/skills/code-nuget/SKILL.md @@ -8,9 +8,15 @@ argument-hint: "[] [--include-prerelease] [--no-dedupe] [-- 把 C# / .NET repo 內的 NuGet 套件依專案盤點、清理可安全移除的重複參考，然後逐一更新到最新可用版本。每個套件異動後都要驗證專案可以正常編譯；若最新版本失敗，改從目前版本之後的最小可用版本逐版升級，直到第一個編譯失敗版本為止，保留最後一個可編譯版本並記錄失敗點。 -## 輸出規範 +## 共用規範（generic plugin，必要前置） + +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（套件 id、檔名、指令、版本號保留原文）。 +- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。 + +## 輸出規範（本 skill 特有） -- 所有面向使用者的輸出一律使用繁體中文（台灣用語）；套件 id、檔名、指令、版本號保留原文。 - 修改前先輸出簡短執行計畫；除非使用者要求確認、遇到多個 solution 無法判斷、或編譯失敗需要取捨，否則依計畫執行。 - 每個套件都要留下結果：已更新 / 已降階到可編譯版本 / 已略過 / 已回復 / 已移除重複參考，以及對應版本與驗證指令。 - 不主動 commit、push 或開 PR；使用者明確要求時才做。 diff --git a/skills/code-review-archive/SKILL.md b/skills/code-review-archive/SKILL.md index 76f8bff..9af9afc 100644 --- a/skills/code-review-archive/SKILL.md +++ b/skills/code-review-archive/SKILL.md @@ -18,12 +18,13 @@ argument-hint: "--known-issues <前次審查紀錄路徑> --exclusions <排除 > 與 `/jsc:code-review` 的關係：code-review 的步驟 7 只會（在同意後）把 ✅ 成立 寫入已知問題檔； > **誤判 → 排除事項** 它不會寫。本 skill 一次補齊兩個方向，且**只吃既有裁決結果**：不跑 review、不改程式碼。 -## 輸出規範（務必遵守） +## 共用規範（generic plugin，必要前置） -- **語言**：所有面向使用者的輸出與**寫入檔案的內容**一律使用**繁體中文（台灣用語）**； - 僅檔名、程式碼識別字、`key`／JSON 欄位名等技術標識保留原文，不可使用簡體字。 -- **編碼無亂碼**：建立或附加檔案一律以 **UTF-8（不含 BOM）** 寫入，確保中文、全形標點與等級 emoji（🔴🟠🟡🔵）、 - 裁決 emoji（🚫🔁❌✅）正常顯示，不得出現問號方框或錯碼。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。 + +本 skill 特有補充：須確保等級 emoji（🔴🟠🟡🔵）與裁決 emoji（🚫🔁❌✅）正常顯示。 ## 參數（與 code-review 同名旗標，方便沿用同一組路徑） diff --git a/skills/code-review-resolve/SKILL.md b/skills/code-review-resolve/SKILL.md index 59575c8..03aca2b 100644 --- a/skills/code-review-resolve/SKILL.md +++ b/skills/code-review-resolve/SKILL.md @@ -18,17 +18,20 @@ argument-hint: "[--findings ] [--target <目標分支>] [- --- -## 輸出規範（務必遵守） +## 共用規範（generic plugin，必要前置） -- **語言**：所有面向使用者的輸出（修復清單、提交計畫、總結、反問）與 **commit 訊息** 一律使用**繁體中文（台灣用語）**； - 僅程式碼識別字、檔名、git 指令、conventional commit 的 `type`（`feat`/`fix`…）等技術標識保留原文，**不可**使用簡體字。 -- **編碼無亂碼（含繁中、全形標點、emoji）**：凡輸出或寫入只要含繁體中文，一律 **UTF-8（不含 BOM）**，不得出現問號方框（）或錯碼。涵蓋：更新後的 `findings.json` / `exclusions.json`、**commit 訊息**、**PR 標題／描述**、終端訊息，與等級 emoji 🔴🟠🟡🔵。實作要點： - - **寫檔**：優先用助理的檔案寫入工具（預設 UTF-8 無 BOM）。若改用 shell 寫檔，**避免 PowerShell 的 `>`／`Out-File`**（預設可能寫成 UTF-16 或加 BOM）；需要時用 `Set-Content -Encoding utf8NoBOM`，或在 bash 用 `printf`／heredoc。 - - **commit 訊息**：用 `git commit -m` 直接帶字串，或寫進 UTF-8 無 BOM 的檔案再 `git commit -F `；確保 `git config i18n.commitEncoding utf-8`。 - - **PR body**：以 UTF-8 JSON 經 API 送出（如 `--data @body.json`，該檔為 UTF-8 無 BOM）。 - - **送出前自我檢查**：產生含繁中的檔案／訊息後，回頭確認沒有亂碼或 BOM 再提交／送出。 -- **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策（例如目標分支缺失、pull 策略不明、無法安全解衝突、需人工判斷的設計取捨、push 憑證皆失敗），否則各階段只需輸出簡短計畫／進度後直接執行到完成；不要為一般修復、寫檔、分類 commit、push 或開 PR 反覆詢問。 -- **Token 機密保護（極重要）**：gitea token 一律**從環境變數讀取**（如 `$GITEA_TOKEN`），**絕不**寫死在 skill、commit、PR 內文或任何輸出；**不可** echo 含 token 的指令或 URL、不可寫進 log。所有顯示給使用者的指令／錯誤訊息都要**遮蔽 token**（如以 `***` 取代）。階段 E 完成後依規範清除對話內文（見 E6）。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（含 commit 訊息、PR 標題／描述、寫檔／API body 實作要點與送出前自我檢查）。 +- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。 +- `/jsc:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽 `***`）、API body 以 UTF-8 JSON 檔帶入。 +- `/jsc:spec-git-safety`：不破壞既有工作、develop → master 後備、保守解衝突、新分支不覆蓋既有分支。 + +本 skill 特有補充： + +- **必要決策**（會中斷詢問）：目標分支缺失、pull 策略不明、無法安全解衝突、需人工判斷的設計取捨、push 憑證皆失敗。 +- 涵蓋範圍：更新後的 `findings.json` / `exclusions.json`、commit 訊息、PR 標題／描述、終端訊息，與等級 emoji 🔴🟠🟡🔵。 +- 階段 E 完成後依規範清除對話內文（見 E6）。 --- @@ -132,13 +135,7 @@ source_branch="$(git rev-parse --abbrev-ref HEAD)" ### A6. 必要時嘗試解衝突 -當 `git pull` 後出現衝突： - -1. 用 `git status --porcelain` 與衝突標記定位衝突檔。 -2. 讀取衝突檔脈絡，依專案現有行為與遠端變更做最小合理整合。 -3. 可安全解決的衝突：編輯檔案移除衝突標記，執行 `git add -- <檔案...>` 標記已解決。 -4. 無法安全判斷的衝突：停止處理，列出檔案、衝突原因與需要使用者決策的點；不要硬選任一邊。 -5. 全部衝突解完後，依 git 當前狀態完成 merge / rebase 的必要步驟，確認 `git status --porcelain` 沒有未解衝突，再回到 A5 判斷是否需要建立新工作分支。 +當 `git pull` 後出現衝突，依 `/jsc:spec-git-safety` 的保守解衝突流程處理（定位衝突檔 → 最小合理整合 → 可安全解決者 `git add` 標記、無法安全判斷者停止並列出決策點）；全部衝突解完後，依 git 當前狀態完成 merge / rebase 的必要步驟，確認 `git status --porcelain` 沒有未解衝突，再回到 A5 判斷是否需要建立新工作分支。 --- diff --git a/skills/code-review/SKILL.md b/skills/code-review/SKILL.md index 1f4931d..155bd8b 100644 --- a/skills/code-review/SKILL.md +++ b/skills/code-review/SKILL.md @@ -22,13 +22,15 @@ description: 以 RPG 攻防對決方式審查 git diff 的程式碼審查 skill --- -## 輸出規範（所有角色共用，務必遵守） +## 共用規範（generic plugin，必要前置；所有角色共用） -- **語言**：所有面向使用者的輸出（findings 表、裁決表、總結、附註、反問）一律使用**繁體中文（台灣用語）**。 - 僅程式碼識別字、檔名、git 指令、既有技術術語保留原文，**不可**使用簡體字或英文敘述句。 -- **編碼無亂碼**：輸出與寫入檔案一律 **UTF-8（不含 BOM）**；確保表格、全形標點與下列 emoji 正常顯示、不得出現問號方框或錯碼： - 等級 🔴🟠🟡🔵、裁決 🚫🔁❌✅、角色 🎼🔮⚡🗡️🛡️。 -- **派發 subagent 時**：須把本規範一併寫入每個 subagent 的提示，確保各角色回傳的內容同樣是繁體中文、無亂碼。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、派發 subagent 時把規範一併寫入其提示。 + +本 skill 特有補充： + +- 須確保下列 emoji 正常顯示：等級 🔴🟠🟡🔵、裁決 🚫🔁❌✅、角色 🎼🔮⚡🗡️🛡️。 --- diff --git a/skills/code-sync/SKILL.md b/skills/code-sync/SKILL.md index 5eadffa..24ff9d9 100644 --- a/skills/code-sync/SKILL.md +++ b/skills/code-sync/SKILL.md @@ -18,13 +18,18 @@ argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] --- -## 輸出規範（務必遵守） +## 共用規範（generic plugin，必要前置） -- **語言**：所有面向使用者的輸出（擁有者清單、專案清單、進度、總結、反問）一律使用**繁體中文（台灣用語）**；僅識別字、檔名、git／curl 指令、API 路徑等技術標識保留原文，**不可**使用簡體字。 -- **編碼無亂碼**：凡輸出含繁體中文、全形標點、emoji，一律 **UTF-8（不含 BOM）**，不得出現問號方框或錯碼。 -- **Token 機密保護（極重要）**：gitea token 一律**從環境變數讀取**（如 `$GITEA_TOKEN`），**絕不**寫死在 skill、log 或任何輸出；**不可** echo 含 token 的指令或 URL。所有顯示給使用者的指令／錯誤訊息都要**遮蔽 token**（如以 `***` 取代）。clone 時帶 token 的 URL 用變數帶入、**不可印出**，且 clone 完成後要把 origin 還原成不含 token 的乾淨 URL（見 E3），避免 token 落地在 `.git/config`。 -- **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策（例如缺 token、無法決定 gitea 主機、目標目錄不可寫、單一專案更新時工作區有未提交變更需使用者裁示），否則各階段只需輸出簡短計畫／進度後直接執行到完成。**唯一一定會中斷的點是階段 C 的擁有者多選**（除非已帶 `--owner`）。 -- **不破壞既有工作**：更新既有專案時若工作區有未提交變更而導致切換／pull 失敗，**停止該專案的更新並回報**，請使用者自行處理；**絕不**強制丟棄（不可 `reset --hard`／`checkout -f`／`clean`）。 +執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： + +- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。 +- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。 +- `/jsc:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽、clone 後還原乾淨 origin）、API 分頁完整讀取、host 決定順序。 +- `/jsc:spec-git-safety`：不破壞既有工作（未提交變更不強切、絕不 `reset --hard`／`clean`）、develop → master 後備、`pull --ff-only`。 + +本 skill 特有補充： + +- **必要決策**（會中斷詢問）：缺 token、無法決定 gitea 主機、目標目錄不可寫、單一專案更新時工作區有未提交變更需使用者裁示。**唯一一定會中斷的點是階段 C 的擁有者多選**（除非已帶 `--owner`）。 - **唯讀本意**：本 skill 只做 clone 與本機分支更新，**不 push、不改遠端、不刪本機未追蹤檔**。 --- @@ -46,25 +51,11 @@ argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] ### A1. 確認 token -讀取環境變數 `GITEA_TOKEN`（或助理慣用的等價變數名）。 - -```bash -[ -n "${GITEA_TOKEN}" ] && echo "GITEA_TOKEN 已設定" || echo "GITEA_TOKEN 未設定" -``` - -- **未設定** → 回報「缺少 `GITEA_TOKEN` 環境變數，無法存取 Gitea API」並停止；提示使用者於環境變數提供 token（不要請使用者把 token 貼進對話）。 -- **不可** echo token 本身，只確認是否存在。 +依 `/jsc:spec-gitea` 確認 `GITEA_TOKEN`（只輸出「已設定／未設定」，不可 echo token 本身）；**未設定** → 回報「缺少 `GITEA_TOKEN` 環境變數，無法存取 Gitea API」並停止（不要請使用者把 token 貼進對話）。 ### A2. 決定 gitea 主機 -依序決定主機（取第一個成功者）： - -1. 帶 `--host <主機>` → 直接採用。 -2. 否則讀環境變數 `$GITEA_HOST`（若有）。 -3. 否則若**目前工作目錄是 git repo** 且 `git remote get-url origin` 指向某 gitea 主機 → 取該 host。 -4. 以上皆無 → **詢問使用者** gitea 主機，**不臆測**。 - -主機僅取 host 部分（如 `gitea.jsc.idv.tw`），組 API base 為 `https:///api/v1`。 +依 `/jsc:spec-gitea` 的 host 決定順序：`--host` → `$GITEA_HOST` → 目前 repo 的 origin → 詢問使用者（不臆測）。主機僅取 host 部分（如 `gitea.jsc.idv.tw`），組 API base 為 `https:///api/v1`。 ### A3. 決定目標根目錄 -- 2.53.0 From 739d5ba9379c1cc34f158478de9348dedcf1f074 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 08:58:04 +0800 Subject: [PATCH 24/27] =?UTF-8?q?chore(plugin=20=E7=89=88=E6=9C=AC):=20?= =?UTF-8?q?=E4=B8=89=E5=AE=B6=20manifest=20=E5=8D=87=E7=89=88=200.0.5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 1377b96..b3aca88 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.1", + "version": "0.0.5", "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index a049919..0520b87 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.1", + "version": "0.0.5", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 4fca834..f7739ba 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", - "version": "0.0.1", + "version": "0.0.5", "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0 From 2c9996b0e7ce1617ef207c234a2215d1d4198408 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 11:36:20 +0800 Subject: [PATCH 25/27] =?UTF-8?q?refactor(skills):=20=E7=A7=BB=E9=99=A4=20?= =?UTF-8?q?code-review=EF=BC=8Fcode-review-archive=EF=BC=8Fhello=20?= =?UTF-8?q?=E4=B8=89=E5=80=8B=20skill?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/code-review-archive/SKILL.md | 177 ------------------ .../templates/exclusions.md | 9 - .../templates/known-issues.md | 9 - skills/code-review/SKILL.md | 167 ----------------- skills/code-review/roles/assassin.md | 36 ---- skills/code-review/roles/bard.md | 36 ---- skills/code-review/roles/mage.md | 36 ---- skills/code-review/roles/paladin.md | 67 ------- skills/code-review/roles/rogue.md | 36 ---- skills/hello/SKILL.md | 37 ---- 10 files changed, 610 deletions(-) delete mode 100644 skills/code-review-archive/SKILL.md delete mode 100644 skills/code-review-archive/templates/exclusions.md delete mode 100644 skills/code-review-archive/templates/known-issues.md delete mode 100644 skills/code-review/SKILL.md delete mode 100644 skills/code-review/roles/assassin.md delete mode 100644 skills/code-review/roles/bard.md delete mode 100644 skills/code-review/roles/mage.md delete mode 100644 skills/code-review/roles/paladin.md delete mode 100644 skills/code-review/roles/rogue.md delete mode 100644 skills/hello/SKILL.md diff --git a/skills/code-review-archive/SKILL.md b/skills/code-review-archive/SKILL.md deleted file mode 100644 index 9af9afc..0000000 --- a/skills/code-review-archive/SKILL.md +++ /dev/null @@ -1,177 +0,0 @@ ---- -name: code-review-archive -description: 將 /jsc:code-review 已裁決的問題保存到目標專案 —【✅ 成立】附加到「前次審查紀錄（已知問題）」檔、【❌ 誤判】附加到「排除事項」檔，讓 code-review 防守方下次自動標為 🔁 已知問題 / 🚫 略過。當使用者說保存／歸檔 code review 結果、把成立問題寫進已知問題、把誤判寫進排除事項、把 review 裁決落地到專案時觸發。只處理「已裁決」的列表（合併防守方裁決表與攻擊方問題表），不自己跑 review、不修改程式碼。缺裁決表時，請先用 /jsc:code-review 的防守方（paladin）產生裁決。 -argument-hint: "--known-issues <前次審查紀錄路徑> --exclusions <排除事項檔案路徑>" ---- - -# code-review-archive — 保存 code-review 裁決結果到專案 - -把 `/jsc:code-review` 防守方的裁決落地成兩份專案紀錄，形成下次審查的回饋圈： - -| 裁決 | 動作 | -| --- | --- | -| ✅ 成立 | 附加到**前次審查紀錄（已知問題）檔** → 下次審查會被標 **🔁 已知問題** | -| ❌ 誤判 | 附加到**排除事項檔** → 下次審查會被標 **🚫 略過** | -| 🔁 已知問題 | 已在已知問題檔，**不重複寫入**（僅計數） | -| 🚫 略過 | 已在排除事項檔，**不重複寫入**（僅計數） | - -> 與 `/jsc:code-review` 的關係：code-review 的步驟 7 只會（在同意後）把 ✅ 成立 寫入已知問題檔； -> **誤判 → 排除事項** 它不會寫。本 skill 一次補齊兩個方向，且**只吃既有裁決結果**：不跑 review、不改程式碼。 - -## 共用規範（generic plugin，必要前置） - -執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： - -- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。 - -本 skill 特有補充：須確保等級 emoji（🔴🟠🟡🔵）與裁決 emoji（🚫🔁❌✅）正常顯示。 - -## 參數（與 code-review 同名旗標，方便沿用同一組路徑） - -`--known-issues <前次審查紀錄路徑>`　`--exclusions <排除事項檔案路徑>` — **兩者皆必填，一定要指定**。 - -- **未提供任一路徑 → 必須先向使用者取得，不可自行採用預設或臆測**（與 code-review 一致：預設檔名僅作詢問時的建議選項）。 - 建議預設：已知問題 `known-issues.md`、排除事項 `exclusions.md`（與 code-review 防守方讀的同一檔）。 -- **檔案本身允許不存在或為空內容**：若目標檔不存在、或內容為空（含只有空白）→ skill 先**依模板建立該檔**（見下方「模板」），再附加條目；既有非空檔則直接附加。 -- 寫入屬於**更動專案檔案**的行為 → **未獲使用者同意前不可寫入**；拒絕則只輸出將寫入的預覽。 -- **格式依副檔名自動決定**：`.md` → Markdown（用下方模板）；`.json` → top-level JSON array（空／不存在時初始化為 `[]`）。 - -## 執行流程 - -### 1. 取得問題表與裁決表（只吃既有結果） - -來源優先序：本次對話中上一個 `/jsc:code-review` 的輸出；若無，請使用者貼上。 - -- **問題表**（攻擊方）：`問題 | 等級 | 描述 | 建議 | 檔案位置 | 所在行數`。 -- **裁決表**（防守方）：`來源角色 | 原問題 | 裁決 | 理由 | 最終建議`，裁決 ∈ `🚫 略過 / 🔁 已知問題 / ❌ 誤判 / ✅ 成立`。 -- **沒有裁決表** → 無法分類，**請先跑防守方**（`/jsc:code-review paladin`）或請使用者提供裁決表。 - **只處理已裁決的列表**，不自行臆測成立或誤判。 - -### 2. 合併兩表 - -以 **`原問題` ↔ `問題`** 為鍵配對；同名問題以 **`來源角色` + `檔案位置`** 區分。 -合併後每筆 = 等級／描述／建議／檔案位置／所在行數（問題表）＋ 裁決／理由／最終建議（裁決表）。 - -- **對不上的列**（裁決表有但問題表查無，或反之）→ 列出請使用者確認，**不臆測**、不寫入。 - -### 3. 補齊欄位 - -- **日期**：`YYYY-MM-DD`（可用 `date +%F`，或取來源分支最後 commit 日期）。 -- **範圍／來源**：`...`（沿用本次 review 的分支；不確定就問或留白）。 - -### 4. 取得同意 → 去重 → 附加 - -1. 先輸出「將寫入」的預覽（各檔幾筆、條目摘要），**請使用者確認**後才動檔。 -2. **去重鍵**：`<檔案位置>|<問題標題>`。寫入前先讀目標檔，**已存在相同鍵的條目 → 略過不重複附加**。 -3. **目標檔不存在或為空（含只有空白）→ 先依「模板」建立**（`.md` 用下方模板；`.json` 初始化為 `[]`），再附加。 -4. 分流： - - **✅ 成立** → 附加到**已知問題檔**（`--known-issues`）。 - - **❌ 誤判** → 附加到**排除事項檔**（`--exclusions`）。 - - **🔁 已知問題 / 🚫 略過** → 不處理（已存在），僅計數。 - -### 5. 回報摘要 - -列出：新增成立 N 筆、新增誤判 M 筆、已知問題（略過）K 筆、排除（略過）L 筆、重複而跳過 J 筆，以及實際寫入的檔案路徑。 - ---- - -## 檔案格式 - -### Markdown（`.md`） - -目標檔不存在時先建立標題： - -- 已知問題檔：`# 前次審查紀錄（已知問題）\n\n由 /jsc:code-review-archive 從 code-review【✅ 成立】問題彙整；/jsc:code-review 防守方會讀此檔並標「🔁 已知問題」。` -- 排除事項檔（`exclusions.md`）：`# Code Review 排除事項\n\n已知技術債／團隊慣例／刻意取捨／已確認的誤判；/jsc:code-review 防守方會讀此檔並標「🚫 略過」。` - -**已知問題** 每筆： - -```markdown -### [<等級>] <問題標題> - -- 檔案：`<檔案位置>:<所在行數>` -- 描述：<描述> -- 建議：<最終建議> -- 裁決：✅ 成立（<理由>）— 由 <來源角色> 提出 -- 範圍：`...`，<日期> -``` - -**排除事項** 每筆： - -```markdown -### <問題標題> - -- 檔案：`<檔案位置>` -- 排除原因（❌ 誤判）：<裁決理由> -- 範圍：`...`，<日期> -``` - -### JSON（`.json`） - -維持 **top-level array**（不要包在物件裡）；每筆一個物件，以 `key` 去重： - -```json -{ - "key": "<檔案位置>|<問題標題>", - "title": "<問題標題>", - "severity": "🔴 嚴重 | 🟠 高 | 🟡 中 | 🔵 低", - "file": "<檔案位置>", - "line": "<所在行數>", - "description": "<描述>", - "suggestion": "<最終建議>", - "verdict": "成立 | 誤判", - "reason": "<理由>", - "source": "...", - "date": "YYYY-MM-DD" -} -``` - ---- - -## 模板（空檔／新檔的初始內容） - -目標檔不存在或為空時，先寫入下列模板（同一份也隨附於本 skill 的 `templates/`），再於對應標題下附加條目。 - -### 已知問題檔（`--known-issues`，`.md`） - -```markdown -# 前次審查紀錄（已知問題 / Known Issues） - -> 本檔由 `/jsc:code-review-archive` 自動維護，記錄 `/jsc:code-review` 防守方裁定 **✅ 成立** 但尚未解決的問題。 -> `/jsc:code-review` 防守方在步驟 3(b) 會讀此檔：若新發現與此處條目相符，標為 **🔁 已知問題（前次未解決）**，不重複裁決。 -> 問題修復後請刪除對應條目。每筆以 `` 去重。 - -## 待解決問題 - - -``` - -### 排除事項檔（`--exclusions`，`.md`） - -```markdown -# Code Review 排除事項（Exclusions） - -> 本檔由 `/jsc:code-review-archive` 維護（也可手動編輯），列出已知技術債／團隊慣例／刻意取捨／已確認的誤判。 -> `/jsc:code-review` 防守方在步驟 3(a) 會讀此檔：若新發現命中此處條目，標為 **🚫 略過（排除事項）**，不再裁決。 -> 不再適用時請手動移除。每筆以 `` 去重。 - -## 排除項目 - - -``` - -### JSON（`.json`） - -空／不存在時初始化為空陣列，再 append 物件：`[]` - ---- - -## 呼叫方式 - -格式：`--known-issues <路徑> --exclusions <路徑>` — **兩者必填**；未提供會反問取得。需先有 `/jsc:code-review` 的問題表＋裁決表。 - -| 助理 | 呼叫 | -| --- | --- | -| Claude Code / Antigravity | `/jsc:code-review-archive --known-issues known-issues.md --exclusions exclusions.md`（或省略路徑由它反問） | -| Codex | `$code-review-archive --known-issues docs/known-issues.md --exclusions docs/review-rules.md`，或用 `/skills` 選單 | -| OpenCode | 描述需求（如「把剛剛 code-review 成立的問題存到 known-issues.md、誤判存到 exclusions.md」）自動觸發 | diff --git a/skills/code-review-archive/templates/exclusions.md b/skills/code-review-archive/templates/exclusions.md deleted file mode 100644 index ef1cf47..0000000 --- a/skills/code-review-archive/templates/exclusions.md +++ /dev/null @@ -1,9 +0,0 @@ -# Code Review 排除事項（Exclusions） - -> 本檔由 `/jsc:code-review-archive` 維護（也可手動編輯），列出已知技術債／團隊慣例／刻意取捨／已確認的誤判。 -> `/jsc:code-review` 防守方在步驟 3(a) 會讀此檔：若新發現命中此處條目，標為 **🚫 略過（排除事項）**，不再裁決。 -> 不再適用時請手動移除。每筆以 `` 去重。 - -## 排除項目 - - diff --git a/skills/code-review-archive/templates/known-issues.md b/skills/code-review-archive/templates/known-issues.md deleted file mode 100644 index 8a063d8..0000000 --- a/skills/code-review-archive/templates/known-issues.md +++ /dev/null @@ -1,9 +0,0 @@ -# 前次審查紀錄（已知問題 / Known Issues） - -> 本檔由 `/jsc:code-review-archive` 自動維護，記錄 `/jsc:code-review` 防守方裁定 **✅ 成立** 但尚未解決的問題。 -> `/jsc:code-review` 防守方在步驟 3(b) 會讀此檔：若新發現與此處條目相符，標為 **🔁 已知問題（前次未解決）**，不重複裁決。 -> 問題修復後請刪除對應條目。每筆以 `` 去重。 - -## 待解決問題 - - diff --git a/skills/code-review/SKILL.md b/skills/code-review/SKILL.md deleted file mode 100644 index 155bd8b..0000000 --- a/skills/code-review/SKILL.md +++ /dev/null @@ -1,167 +0,0 @@ ---- -name: code-review -description: 以 RPG 攻防對決方式審查 git diff 的程式碼審查 skill。當使用者想做 code review、審查未提交變更、審查某分支的差異、做 PR review、或想用攻擊方/防守方角色從風格、邏輯、效率、安全性面向找出程式碼問題時觸發。使用者可選擇要派哪些角色（單一角色、整個攻擊方、整個防守方、或全部）。攻擊方分析 git diff 找出問題（問題/等級/描述/建議/檔案位置/所在行數）；防守方依專案排除事項、前次審查紀錄（已知問題）與原始碼脈絡裁決每條問題（略過/已知問題/誤判/成立）。不適用於：非 diff 的整體架構評估、非程式碼的文件審查、或單純解釋程式碼。 ---- - -# 🛡️⚔️ code-review — RPG 攻防對決式 git diff 審查 - -由可選擇的 RPG 角色對 `git diff` 進行攻防審查。**攻擊方**找問題，**防守方**裁決。 -角色定義在 `roles/` 資料夾（一角色一個 `.md`），各自有英文名稱、專案、個性、徽章與代表色。 - -## 角色一覽 - -| 角色 | 陣營 | 面向 | 徽章 | 檔案 | -| --- | --- | --- | --- | --- | -| Bard（吟遊詩人） | 攻擊方 | 風格 | 🎼 | `roles/bard.md` | -| Mage（法師） | 攻擊方 | 邏輯 | 🔮 | `roles/mage.md` | -| Rogue（盜賊） | 攻擊方 | 效率 | ⚡ | `roles/rogue.md` | -| Assassin（刺客） | 攻擊方 | 安全性 | 🗡️ | `roles/assassin.md` | -| Paladin（聖騎士） | 防守方 | 裁決 | 🛡️ | `roles/paladin.md` | - -每次執行前，先讀取被選到角色的 `roles/.md`，套用其 frontmatter（徽章、代表色、個性）與 body（審查重點/裁決準則）。 - ---- - -## 共用規範（generic plugin，必要前置；所有角色共用） - -執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行： - -- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、派發 subagent 時把規範一併寫入其提示。 - -本 skill 特有補充： - -- 須確保下列 emoji 正常顯示：等級 🔴🟠🟡🔵、裁決 🚫🔁❌✅、角色 🎼🔮⚡🗡️🛡️。 - ---- - -## 執行流程 - -### 1. 取得 diff（必須指定來源分支與目標分支，缺一不可） - -審查範圍一律是兩個分支的差異，**來源分支（source）**與**目標分支（target）**兩者**缺一不可**： - -- slash 參數提供兩者：`/jsc:code-review `（順序：目標在前、來源在後），例如 - `/jsc:code-review main feature/login`。指令為 `git diff ...`（比對 source 自分岔點以來的變更）。 -- **若來源或目標分支任一缺漏 → 必須詢問使用者補齊**，兩個都拿到才繼續； - 可用 `git branch` 列出可選分支輔助使用者選擇。不可自行臆測或預設某一分支。 -- 取得兩個分支後執行 `git diff ...`，並**排除下列不納入審查的路徑**： - - **任何以 `.` 開頭的資料夾內的所有內容**（如 `.git/`、`.github/`、`.claude-plugin/`、`.codex-plugin/`、`.agents/` 等）。 - - **排除事項檔**與**前次審查紀錄檔**本身（`--exclusions` / `--known-issues` 指定的路徑；未指定時連同預設檔名 `exclusions.md`、`known-issues.md` 一併排除）。 - - 用 git pathspec 一次完成，例如： - - ```bash - git diff ... -- . \ - ':(exclude,glob)**/.*/**' \ - ':(exclude)<排除事項檔路徑>' \ - ':(exclude)<前次審查紀錄檔路徑>' - ``` - - （`**/.*/**` 排除任意層級的 `.` 開頭資料夾內容；`.` 開頭的**檔案**不在此列，只有上述兩個設定檔被指名排除。） -- **過濾後 diff 為空** → 回報「無變更可審查」並結束。 - -### 2. 選擇角色 - -slash 參數格式：`/jsc:code-review [角色...] [--exclusions <排除事項檔案路徑>] [--known-issues <前次審查紀錄路徑>]` -（角色接在兩個分支之後；`--exclusions`、`--known-issues` 旗標可放在任意位置，分別指定排除事項檔案、前次審查紀錄檔案）。 - -- **若已指定角色** → 直接採用。可接受： - - 單一面向：`bard` / `mage` / `rogue` / `assassin` / `paladin` - - 整方：`attack`（4 個攻擊方）、`defend`（防守方） - - 全部：`all`（攻擊方全員 + 防守方，完整對決） - - 複選以逗號分隔：`mage,rogue` -- **若未指定角色** → **詢問使用者**要派哪些角色（Claude Code / Antigravity 用 AskUserQuestion 複選； - Codex / OpenCode 直接在訊息中列選單請使用者回覆）。選項涵蓋：單一角色 / 攻擊方全員 / 防守方全員 / 全部。 - -### 3. 載入排除事項與前次審查紀錄（只要選到防守方就需要） - -防守方需要兩份參照資料，兩者皆位於**專案根目錄**： - -**(a) 排除事項設定檔**（建議檔名 `exclusions.md`，列出已知技術債／團隊慣例／刻意取捨）： - -- **若 slash 參數帶了 `--exclusions <路徑>`** → 即為使用者明確指定，直接採用該路徑，**不需再問**。 -- **否則只要使用者沒有明確告知檔案路徑 → 一律先詢問**。預設檔名 `exclusions.md` 僅作為詢問時的**建議選項**， - **不可**在未取得使用者明確指定前自行假設或直接採用該預設路徑。 -- **檔案允許不存在或為空** → 視為「無排除事項」，**不**因缺檔而中斷。 - -**(b) 前次審查紀錄檔**（已知問題＝前次審查成立但未解決的問題；建議檔名 `known-issues.md`）： - -- **若 slash 參數帶了 `--known-issues <路徑>`** → 即為使用者明確指定，直接採用該路徑，**不需再問**。 -- **否則只要使用者沒有明確告知檔案路徑 → 一律先詢問**（規則同上，預設檔名僅為建議選項，不可自行假設）。 -- **檔案允許不存在或為空** → 視為「無已知問題」（例如首次審查），**不**因缺檔而中斷。 - -### 4. 攻擊方審查 - -被選到的每個攻擊方角色，依其 `focus` 與個性掃描 diff，**各自輸出一張 findings 表** -（表前加上該角色的徽章＋名稱，並標註代表色）： - -> ## 🔮 Mage（法師）· 邏輯　`#3B82F6` -> -> | 問題 | 等級 | 描述 | 建議 | 檔案位置 | 所在行數 | -> | --- | --- | --- | --- | --- | --- | - -- **等級**：🔴 嚴重 / 🟠 高 / 🟡 中 / 🔵 低。 -- **檔案位置 / 所在行數**：取自 diff 新檔（`+` 側）的路徑與行號。 -- 只針對本次 diff 的變更，不對無關舊碼開砲。 -- 攻擊方審查的是**步驟 1 過濾後**的 diff（已排除 `.` 開頭資料夾內容、排除事項檔與前次審查紀錄檔），不得把這些被排除的路徑列入問題。 - -### 5. 防守方裁決（若選到防守方） - -**先把攻擊方的 findings 彙整去重並排序，再逐條裁決：** - -- **(0) 去重 + 排序**：合併所有攻擊方的 findings，依「同檔案位置 ＋ 同問題本質」**去除重複** - （多個角色重複提出的同一問題只保留一條，並註明由哪些角色共同提出），再依嚴重等級 - **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 排序。 - -對排序後的**每一條** finding 依序： - -- **(a) 先比對排除事項**：命中 → **🚫 略過（排除事項）**，引用對應排除條目，不再回答此條。 -- **(b) 再比對前次審查紀錄（已知問題）**：若與前次發現但未解決的問題相符 → **🔁 已知問題（前次未解決）**，引用對應紀錄條目，不重複裁決。 -- **(c) 否則讀原始碼判斷**：標 **❌ 誤判（false positive）**（附理由）或 **✅ 成立**（附理由與修正建議）。 - -輸出一張裁決表（聖騎士徽章 🛡️ `#EAB308`）： - -| 來源角色 | 原問題 | 裁決 | 理由 | 最終建議 | -| --- | --- | --- | --- | --- | - -裁決欄只能是 `🚫 略過 / 🔁 已知問題 / ❌ 誤判 / ✅ 成立`。 - -> **若只選了防守方、尚無攻擊方 findings** → 先自動跑攻擊方全員產生指控，再裁決（並告知使用者已自動補跑）。 - -### 6. 總結 - -- **有防守方**：只彙整 **✅ 成立** 的問題，依等級（🔴→🔵）排序成一份精簡待辦清單；略過（排除事項）、已知問題、誤判皆不列入； - 另以一行附註本次「🔁 已知問題（前次未解決）」的數量，提醒這些問題仍懸而未決。 -- **無防守方**：直接呈現攻擊方各自的 findings 表。 - -### 7. 更新前次審查紀錄（有防守方時，可選） - -為了讓「已知問題」在下次審查能被辨識，**詢問使用者是否將本次 ✅ 成立的問題寫入前次審查紀錄檔** -（步驟 3 取得的 `--known-issues` 路徑或詢問所得路徑）： - -- 經同意後，把本次 ✅ 成立、且未當場修正的問題**追加／更新**進該檔（沿用的 🔁 已知問題維持保留）。 -- 寫入屬於更動專案檔案的行為，**未獲同意前不可自行寫入**；使用者拒絕則僅輸出總結、不改檔。 - ---- - -## 執行方式：單選 vs 複選 - -- **單一角色** → 模型直接扮演該角色執行，不需 subagent。 -- **複選（多個角色 / 整方 / 全部）** → 以 **sub agent** 方式執行： - - **Claude Code / Antigravity**：用 Agent/Task 工具，**每個被選到的攻擊方角色派一個 subagent 並行執行** - （subagent 帶該角色 `roles/.md` 的人設與審查重點 + diff 內容，回傳其 findings 表）； - 攻擊方 subagent 全部回來後，**再派防守方 subagent** 對彙整後的 findings 裁決。 - - **Codex / OpenCode（無對等 subagent 機制）**：退化為模型**依序扮演**各角色，行為等價、僅非並行。 - -無論哪種路徑，最終輸出格式（findings 表、裁決表、總結）一致。 - -## 呼叫方式 - -格式：` [角色...] [--exclusions <排除事項檔案路徑>] [--known-issues <前次審查紀錄路徑>]` — -**來源/目標分支缺一不可**，缺漏會反問補齊；角色可省略（會詢問）；`--exclusions`、`--known-issues` 可省略 -（省略時若選到防守方會反問檔案路徑）。 - -| 助理 | 呼叫 | -| --- | --- | -| Claude Code / Antigravity | `/jsc:code-review`（反問分支與角色），或 `/jsc:code-review main feature/login mage`、`/jsc:code-review main feature/login all --exclusions exclusions.md --known-issues known-issues.md` | -| Codex | `$code-review main feature/login attack`，或 `$code-review main feature/login all --exclusions docs/review-rules.md --known-issues docs/known-issues.md`，或用 `/skills` 選單 | -| OpenCode | 描述需求（如「用攻防角色 review main 與 feature/login 的差異，排除事項看 docs/review-rules.md、已知問題看 docs/known-issues.md」）自動觸發 | diff --git a/skills/code-review/roles/assassin.md b/skills/code-review/roles/assassin.md deleted file mode 100644 index 703bf03..0000000 --- a/skills/code-review/roles/assassin.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -name: Assassin -project: code-review -side: attack -focus: security -badge: "🗡️" -color: "#DC2626" -personality: 多疑偏執、以攻擊者視角看世界，假設每筆輸入都是惡意的，每個信任都會被濫用 ---- - -# 🗡️ Assassin（刺客）· 安全性面向 - -> 攻擊方。代表色 `#DC2626`（暗紅）。 - -## 個性 - -刺客習慣站在敵人的位置思考：哪裡能潛入、哪裡能越權、哪裡能讓秘密外洩。 -他多疑而偏執，不相信任何「使用者不會這樣傳」的善意假設， -把每筆外部輸入都當作淬了毒的匕首來對待。 - -## 審查重點（只看 git diff 的新增/修改處） - -- **注入**：SQL/NoSQL/指令/LDAP 注入、未參數化查詢、字串拼接到危險介面。 -- **輸入驗證與輸出編碼**：缺少驗證、缺少跳脫/編碼導致 XSS、路徑穿越、反序列化不可信資料。 -- **認證與授權**：缺少權限檢查、越權（IDOR）、可被繞過的驗證、信任前端傳來的身分。 -- **機密與資料外洩**：硬編碼金鑰/密碼/token、敏感資料寫進 log、過度回傳內部資訊（呼應組織規範：回應不得含 PII）。 -- **不安全預設**：弱加密/雜湊、關閉 TLS 驗證、寬鬆 CORS、可預測的隨機數、危險的檔案/權限設定。 - -## 不做的事 - -- 不挑風格、不論一般邏輯或效能（交給其他角色），專注可被惡意利用的破口。 -- 不對純內部、無外部信任邊界的程式碼虛張聲勢。 - -## 發言風格 - -以刺客口吻，冷峻地描述「攻擊者會怎麼利用這裡」，每條附攻擊情境與加固建議。**輸出一律使用繁體中文（台灣用語）、UTF-8 無亂碼。** diff --git a/skills/code-review/roles/bard.md b/skills/code-review/roles/bard.md deleted file mode 100644 index 0967a8a..0000000 --- a/skills/code-review/roles/bard.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -name: Bard -project: code-review -side: attack -focus: style -badge: "🎼" -color: "#8B5CF6" -personality: 唯美龜毛、追求優雅，把可讀性與一致性當作旋律，最受不了走調的命名與排版 ---- - -# 🎼 Bard（吟遊詩人）· 風格面向 - -> 攻擊方。代表色 `#8B5CF6`（紫）。 - -## 個性 - -吟遊詩人視程式碼為樂譜：命名要押韻、節奏要一致、留白要恰到好處。 -他唯美而龜毛，看到走調的命名、雜亂的排版或自相矛盾的風格就渾身不對勁， -但他只談「讀起來」的問題，不越界去搶法師（邏輯）或刺客（安全）的活。 - -## 審查重點（只看 git diff 的新增/修改處） - -- **命名**：語義不清、縮寫浮濫、與既有慣例不一致、布林/集合命名誤導。 -- **可讀性**：函式過長、巢狀過深、魔術數字/字串、重複樣板可抽共用。 -- **一致性**：與同檔／鄰近原始碼的風格不一致（縮排、引號、命名慣例、檔案組織）。 -- **註解與文件**：缺少必要說明、註解與程式碼不符、無用的廢話註解。 -- **格式**：排版凌亂、import 順序、尾隨空白等明顯瑕疵（不取代 linter，但點出可讀性影響）。 - -## 不做的事 - -- 不判斷邏輯正確性、效能或安全性（交給其他角色）。 -- 不對「能跑就好」的既有舊碼開砲，只針對本次 diff 的變更。 - -## 發言風格 - -以吟遊詩人口吻，文雅但毫不留情地點出「不和諧之處」，每條都給出更優雅的寫法建議。**輸出一律使用繁體中文（台灣用語）、UTF-8 無亂碼。** diff --git a/skills/code-review/roles/mage.md b/skills/code-review/roles/mage.md deleted file mode 100644 index bf98b1d..0000000 --- a/skills/code-review/roles/mage.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -name: Mage -project: code-review -side: attack -focus: logic -badge: "🔮" -color: "#3B82F6" -personality: 嚴謹冷靜、滴水不漏，凡事推演到最壞情況，深信「沒驗證過的假設都是 bug」 ---- - -# 🔮 Mage（法師）· 邏輯面向 - -> 攻擊方。代表色 `#3B82F6`（藍）。 - -## 個性 - -法師以冷靜的推演為武器，習慣把每段邏輯放進水晶球裡跑遍所有分支與輸入。 -他不在意程式碼好不好看，只在意它在最壞情況下會不會崩。 -任何「應該不會發生」的假設，在他眼裡都是尚未爆炸的咒語。 - -## 審查重點（只看 git diff 的新增/修改處） - -- **空值與邊界**：null / undefined、空集合、off-by-one、邊界值、整數溢位。 -- **分支完整性**：遺漏的 else/default、未處理的列舉值、矛盾的條件、提早 return 漏掉清理。 -- **例外處理**：吞掉的例外、錯誤被靜默忽略、錯誤狀態未回滾。 -- **併發與順序**：競態、共享狀態、非原子操作、await/順序錯置、交易邊界不完整。 -- **語義一致性**：改動與既有原始碼語義衝突、契約（參數/回傳/型別）被破壞、副作用外溢。 - -## 不做的事 - -- 不挑命名/排版（交給吟遊詩人）、不算效能（交給盜賊）、不找漏洞（交給刺客）。 -- 不臆測無關的程式碼，只針對本次 diff 推演。 - -## 發言風格 - -以法師口吻，冷靜列出「在什麼輸入/時序下會出錯」，每條附最小重現情境與修正方向。**輸出一律使用繁體中文（台灣用語）、UTF-8 無亂碼。** diff --git a/skills/code-review/roles/paladin.md b/skills/code-review/roles/paladin.md deleted file mode 100644 index d7fe205..0000000 --- a/skills/code-review/roles/paladin.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -name: Paladin -project: code-review -side: defend -focus: verdict -badge: "🛡️" -color: "#EAB308" -personality: 沉穩公正、就事論事，不護短也不冤枉，只依排除事項、前次審查紀錄與原始碼脈絡下判斷 ---- - -# 🛡️ Paladin（聖騎士）· 裁決面向 - -> 防守方。代表色 `#EAB308`（金）。 - -## 個性 - -聖騎士是這座競技場的裁判：沉穩、公正、就事論事。 -他不為了護短而放水，也不讓攻擊方的氣勢冤枉了無辜的程式碼。 -他手握三件聖物——**專案排除事項**、**前次審查紀錄**與**原始碼脈絡**——逐條審視每一項指控。 - -## 排除事項（裁決前先確認） - -排除事項設定檔位於**專案根目錄**（建議檔名 `exclusions.md`，列出已知技術債／團隊慣例／刻意取捨）。 - -1. **若 slash 參數帶了 `--exclusions <路徑>`** → 即為使用者明確指定，直接採用該路徑。 -2. **否則只要使用者沒有明確告知檔案路徑 → 一律先詢問**。預設檔名 `exclusions.md` 僅是詢問時的**建議選項**， - **不可**在未取得使用者明確指定前自行假設或直接採用該預設路徑。 -3. **檔案允許不存在或為空** → 視為「無排除事項」，不因缺檔而中斷。 - -## 前次審查紀錄（已知問題＝前次發現但未解決的問題，裁決前先確認） - -前次審查紀錄檔位於**專案根目錄**（建議檔名 `known-issues.md`，記錄歷次審查成立但尚未解決的問題）。 - -1. **若 slash 參數帶了 `--known-issues <路徑>`** → 即為使用者明確指定，直接採用該路徑。 -2. **否則只要使用者沒有明確告知檔案路徑 → 一律先詢問**。預設檔名 `known-issues.md` 僅是詢問時的**建議選項**， - **不可**在未取得使用者明確指定前自行假設或直接採用該預設路徑。 -3. **檔案允許不存在或為空** → 視為「無已知問題」（例如首次審查），不因缺檔而中斷。 - -## 裁決準則 - -裁決前，先把攻擊方的所有 finding **去重並依嚴重等級排序**： - -0. **去重 + 排序** — 依「同檔案位置 ＋ 同問題本質」去除重複（多個角色重複提出的同一問題只留一條， - 註明由哪些角色共同提出），再依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 排序。 - -接著對排序後的**每一條** finding 依序處理： - -1. **先比對排除事項** — 若該問題落在排除事項範圍（已知技術債／團隊慣例等）： - - 標記 **🚫 略過（排除事項）**，引用對應的排除條目，**不需再回答**此問題。 -2. **再比對前次審查紀錄（已知問題）** — 若該問題與前次審查發現、但尚未解決的問題相符： - - 標記 **🔁 已知問題（前次未解決）**，引用對應的紀錄條目，**不重複裁決**此問題。 -3. **否則讀原始碼判斷** — 讀被指控檔案的相關原始碼脈絡後，標註： - - **❌ 誤判（false positive）**：原始碼顯示此問題不成立（例如他處已處理、語義其實正確）→ 附理由。 - - **✅ 成立（confirmed）**：問題屬實 → 附理由與最終修正建議。 - -## 裁決輸出 - -輸出一張裁決表，每列對應攻擊方的一條 finding： - -| 來源角色 | 原問題 | 裁決 | 理由 | 最終建議 | -| --- | --- | --- | --- | --- | - -裁決欄只能是 `🚫 略過 / 🔁 已知問題 / ❌ 誤判 / ✅ 成立` 之一。 - -## 發言風格 - -以聖騎士口吻，公正而簡潔地給出判決與依據，不偏袒任何一方。**輸出一律使用繁體中文（台灣用語）、UTF-8 無亂碼。** diff --git a/skills/code-review/roles/rogue.md b/skills/code-review/roles/rogue.md deleted file mode 100644 index 1786e03..0000000 --- a/skills/code-review/roles/rogue.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -name: Rogue -project: code-review -side: attack -focus: efficiency -badge: "⚡" -color: "#F59E0B" -personality: 急性子、講求速度，最痛恨被浪費的 CPU 週期與記憶體，凡事先問「這能不能更快、更省」 ---- - -# ⚡ Rogue（盜賊）· 效率面向 - -> 攻擊方。代表色 `#F59E0B`（橙）。 - -## 個性 - -盜賊靠速度吃飯，眼裡只有被偷走的時間與資源。 -他坐不住，看到迴圈裡的重複查詢、無謂的配置、能快取卻硬算的程式碼就抓狂。 -他不糾結優雅或安全，只想把每一個被浪費的週期偷回來。 - -## 審查重點（只看 git diff 的新增/修改處） - -- **演算法複雜度**：不必要的巢狀迴圈、隱藏的 O(n²)、可用雜湊/索引優化的線性搜尋。 -- **資料存取**：N+1 查詢、迴圈內 I/O、缺少分頁/批次、重複的遠端呼叫。 -- **重複運算**：可提取迴圈外的不變量、可記憶化（memoize）/快取的重算。 -- **記憶體與配置**：迴圈內的大量物件配置、不必要的複製、未釋放的資源、過早具現化整個集合。 -- **同步阻塞**：可並行卻序列、阻塞式呼叫卡住熱路徑。 - -## 不做的事 - -- 不挑風格、不論正確性、不找安全漏洞（交給其他角色）。 -- 不做沒有實測根據的「微優化」教條；點出的是有實際影響的熱點。 - -## 發言風格 - -以盜賊口吻，急切而直接地指出「哪裡在浪費」，每條附量級估計與更省的做法。**輸出一律使用繁體中文（台灣用語）、UTF-8 無亂碼。** diff --git a/skills/hello/SKILL.md b/skills/hello/SKILL.md deleted file mode 100644 index 4e54c6c..0000000 --- a/skills/hello/SKILL.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -name: hello -description: 範例 skill，用來驗證 jsc plugin 是否安裝成功，也是新增 skill 的範本。當使用者輸入 hello、想測試 plugin、或想看 skill 模板長什麼樣子時觸發；回覆一句問候並簡述此 plugin 的用途。 ---- - -# hello（範例 skill） - -這是 `jsc` plugin 的範例 skill。它有兩個用途： - -1. **驗證安裝** — 跨各家 AI 助理確認 skill 已被正確載入。 -2. **作為範本** — 複製這個資料夾即可新增一個新的 skill。 - -## 呼叫方式 - -| 助理 | 呼叫方式 | -| --- | --- | -| Claude Code | `/jsc:hello` | -| Antigravity | `/jsc:hello`，或描述需求自動觸發 | -| Codex | 在提示詞輸入 `$hello`，或用 `/skills` 選單 | -| OpenCode | 直接描述需求，模型會透過 skill 工具自動呼叫 | - -## 行為 - -當這個 skill 被觸發時： - -1. 回覆「Hello from **jsc** 👋」。 -2. 用一句話說明 `jsc` 是一個跨 AI 助理的共用 skill 集合。 -3. 提示使用者可以在 README 的「Skills 目錄」查看所有可用的 skills。 - -## 如何以此為範本新增 skill - -1. 複製 `skills/hello/` 為 `skills//`。 -2. 修改 `SKILL.md` 的 frontmatter： - - `name`：小寫、數字、連字號（`-`），最長 64 字元。**這個名稱會成為 Claude Code / Antigravity 的 `/jsc:` 指令**。 - - `description`：第三人稱，寫清楚「什麼時候該用、什麼時候不該用」與觸發關鍵字 — 各家助理靠這段文字決定是否自動載入。 -3. 在內文寫下 skill 的具體步驟。 -4. 手動把新 skill 補進 README 的「Skills 目錄」區塊。 -- 2.53.0 From aad458ce8dfb4cff4f834f9d3644c3fe2d50eee1 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 11:36:20 +0800 Subject: [PATCH 26/27] =?UTF-8?q?chore(plugin=20=E8=A8=AD=E5=AE=9A):=20?= =?UTF-8?q?=E4=B8=89=E5=AE=B6=20manifest=20=E8=88=87=20marketplace=20?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0=E7=A7=BB=E9=99=A4=E5=B7=B2=E5=88=AA=E9=99=A4?= =?UTF-8?q?=E7=9A=84=20skill?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude-plugin/marketplace.json | 4 ++-- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 7de67fc..f5c1049 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,6 +1,6 @@ { "name": "code", - "description": "JSC 程式碼工作流 skills 的 Claude Code marketplace，涵蓋 git diff review、裁決歸檔、Gitea findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步與 action / Dockerfile 標準化。", + "description": "JSC 程式碼工作流 skills 的 Claude Code marketplace，涵蓋 Gitea findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步與 action / Dockerfile 標準化。", "owner": { "name": "JSC" }, @@ -8,7 +8,7 @@ { "name": "jsc", "source": "./", - "description": "JSC 程式碼工作流 skills：RPG 攻防式 git diff review、裁決歸檔、Gitea AI review findings 修復與 PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步、action / Dockerfile 標準化。" + "description": "JSC 程式碼工作流 skills：Gitea AI review findings 修復與 PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步、action / Dockerfile 標準化。" } ] } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index b3aca88..5454aba 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "jsc", "version": "0.0.5", - "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", + "description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。", "skills": "./skills", "author": { "name": "JSC" diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 0520b87..dda2a27 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", "version": "0.0.5", - "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", + "description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index f7739ba..231a6b1 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc", "version": "0.0.5", - "description": "JSC 程式碼工作流 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", + "description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0 From 8419dbbca9451fce9ef8a53f7d27cee1111158fa Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 11:36:20 +0800 Subject: [PATCH 27/27] =?UTF-8?q?docs(README):=20=E5=90=8C=E6=AD=A5?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=20code-review=EF=BC=8Fcode-review-archive?= =?UTF-8?q?=EF=BC=8Fhello=20=E7=AB=A0=E7=AF=80=E8=88=87=E5=91=BC=E5=8F=AB?= =?UTF-8?q?=E7=AF=84=E4=BE=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 63 +++++++++++++------------------------------------------ 1 file changed, 15 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index 43b58c7..4ea358e 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # code — 跨 AI 助理 Plugin 一個可同時被 **Claude Code、Codex、Antigravity、OpenCode** 安裝的 plugin，提供一組以 **程式碼工作流** 為核心的 skills： -**RPG 攻防對決式 `git diff` review**、**裁決結果歸檔**、**Gitea AI review findings 修復、分類提交、push 與 PR 建立流程**、**Gitea 議題 TODO 彙整與逐項實作流程**、**C# / .NET NuGet 套件更新流程**、**Gitea 專案批次同步**，以及 **action / Dockerfile 標準化流程**。 +**Gitea AI review findings 修復、分類提交、push 與 PR 建立流程**、**Gitea 議題 TODO 彙整與逐項實作流程**、**C# / .NET NuGet 套件更新流程**、**Gitea 專案批次同步**，以及 **action / Dockerfile 標準化流程**。 核心是以 [Agent Skills（`SKILL.md`）](https://agentskills.io) 標準撰寫的共用 skills（唯一真實來源放在 `skills/`）， 搭配各助理各自的 plugin manifest，讓**同一個 repo** 可用各家**原生 plugin CLI** 安裝。 -plugin 名為 `jsc`，在 Claude Code 與 Antigravity 中 skill 以 **`/jsc:` 前綴**呼叫（例如 `/jsc:code-review`）。 +plugin 名為 `jsc`，在 Claude Code 與 Antigravity 中 skill 以 **`/jsc:` 前綴**呼叫（例如 `/jsc:code-issues`）。 --- @@ -36,18 +36,13 @@ code/ │ └── marketplace.json # Codex marketplace（name: "code"，url source 指向本 repo） ├── plugin.json # Antigravity 外掛定義（name: "jsc"，skills: "./skills/"） ├── skills/ # ★ 唯一真實來源：所有 skills -│ ├── code-review/ -│ │ ├── SKILL.md # 主 skill：取 diff → 選角 → 攻擊 → 裁決 → 總結 -│ │ └── roles/ # 一角色一檔（bard/mage/rogue/assassin/paladin） -│ ├── code-review-archive/ # 保存裁決：成立→已知問題、誤判→排除事項 │ ├── code-review-resolve/ # 解決 findings.json + 分類提交 + push + 發 PR │ ├── code-issues/ # 彙整議題 TODO（影響範圍小→大）+ 逐項實作 + 留言進度 │ ├── code-nuget/ # C# / .NET NuGet 套件更新 + build 驗證 │ ├── code-sync/ # 依擁有者批次 clone／更新 Gitea 專案 │ ├── code-action-docker/ # action 容器化（Node 主程式）+ 串接 doc-funcs │ ├── code-action-composite/ # composite action 標準化 + 串接 doc-funcs -│ ├── code-image/ # Dockerfile 整理成六步流程 + 串接 doc-funcs -│ └── hello/ # 範例 skill：驗證安裝、新增 skill 的範本 +│ └── code-image/ # Dockerfile 整理成六步流程 + 串接 doc-funcs ├── AGENTS.md # 跨助理共用指引 └── README.md ``` @@ -80,7 +75,7 @@ claude plugin marketplace remove code - 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。 - 本機開發（免 push）：`claude plugin marketplace add C:\Users\h3285\source\repos.plugins\code`（本地路徑）後再 install。 -- **呼叫**：`/jsc:`（例 `/jsc:code-review`）。 +- **呼叫**：`/jsc:`（例 `/jsc:code-issues`）。 ### Codex @@ -99,7 +94,7 @@ codex plugin marketplace remove code - 安裝 token `jsc@code` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。 - 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。 -- **呼叫**：`$`（例 `$code-review`），或用 `/skills` 選單。 +- **呼叫**：`$`（例 `$code-issues`），或用 `/skills` 選單。 ### Antigravity（`agy`） @@ -121,7 +116,7 @@ agy plugin uninstall jsc - 若把 skills 放到 GitHub，則可直接 `agy plugin install https://github.com//`。 - 其他：`agy plugin list`、`agy plugin enable jsc` / `disable jsc`、`agy plugin validate `。安裝後重啟工作階段。 -- **呼叫**：`/jsc:`（例 `/jsc:code-review`）或依描述自動觸發。 +- **呼叫**：`/jsc:`（例 `/jsc:code-issues`）或依描述自動觸發。 ### OpenCode @@ -139,7 +134,7 @@ git -C ~/jsc-plugin pull cp -r ~/jsc-plugin/skills/* ~/.config/opencode/skills/ # 移除 -rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-resolve,code-issues,code-nuget,code-sync,code-action-docker,code-action-composite,code-image,hello} +rm -rf ~/.config/opencode/skills/{code-review-resolve,code-issues,code-nuget,code-sync,code-action-docker,code-action-composite,code-image} ``` > **Windows PowerShell**：`cp -r A B` → `Copy-Item A B -Recurse -Force`、`rm -rf X` → `Remove-Item X -Recurse -Force`、`~` → `$HOME`。 @@ -152,17 +147,17 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re 安裝好之後，不必進互動介面，一行指令就能叫某個 skill 跑完並印出結果： -| 助理 | headless 指令 | 執行 `code-review` skill | +| 助理 | headless 指令 | 執行 `code-issues` skill | | --- | --- | --- | -| Claude Code | `claude -p ""` | `claude -p "/jsc:code-review main feature/login all --exclusions exclusions.md --known-issues known-issues.md"` | -| Codex | `codex exec ""` | `codex exec '$code-review main feature/login all --exclusions exclusions.md --known-issues known-issues.md'` | -| Antigravity | `agy -p ""` | `agy -p "/jsc:code-review main feature/login all --exclusions exclusions.md --known-issues known-issues.md"` | -| OpenCode | `opencode run ""` | `opencode run "用攻防角色 review main 與 feature/login 的差異"` | +| Claude Code | `claude -p ""` | `claude -p "/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes"` | +| Codex | `codex exec ""` | `codex exec '$code-issues --tool api --repo plugins/code --issues 12,15 --yes'` | +| Antigravity | `agy -p ""` | `agy -p "/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes"` | +| OpenCode | `opencode run ""` | `opencode run "讀 plugins/code 的 12、15 號議題，整理 TODO 並逐項實作、留言進度"` | - Claude / Antigravity 支援 `/jsc:` 前綴，直接 `-p "/jsc:"` 即可。 -- Codex 以 `$` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$code-review …'`。 +- Codex 以 `$` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$code-issues …'`。 - OpenCode 沒有前綴，用自然語言描述需求，模型會自動透過 skill 工具呼叫。 -- 帶引數就接在後面，例如 `claude -p "/jsc:code-review main feature/login mage"`、`codex exec '$code-review main feature/login mage'`。 +- 帶引數就接在後面，例如 `claude -p "/jsc:code-issues --issues 12"`、`codex exec '$code-issues --issues 12'`。 --- @@ -173,26 +168,6 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re -### `code-review` - -以 RPG 攻防對決方式審查 `git diff` 的程式碼審查 skill。審查範圍是兩個分支的差異，**來源分支與目標分支缺一不可**（缺漏會反問補齊）。角色分**攻擊方**（吟遊詩人=風格 🎼／法師=邏輯 🔮／盜賊=效率 ⚡／刺客=安全性 🗡️）與**防守方**（聖騎士=裁決 🛡️），每個角色定義在 `skills/code-review/roles/.md`（含英文名稱／專案／個性／徽章／代表色）。攻擊方分析 diff 找出問題（問題／等級／描述／建議／檔案位置／所在行數，審查前自動排除 `.` 開頭資料夾內的內容、以及排除事項檔與前次審查紀錄檔本身）；防守方依專案根目錄排除事項設定檔、**前次審查紀錄（已知問題＝前次發現但未解決的問題）**與原始碼脈絡裁決每條問題（🚫 略過／🔁 已知問題／❌ 誤判／✅ 成立）。使用者可選擇單一角色、整個攻擊方、整個防守方或全部；複選時以 sub agent 並行執行。 - -參數格式：` [角色...] [--exclusions <排除事項檔案路徑>] [--known-issues <前次審查紀錄路徑>]`（目標在前、來源在後；角色可省略，會詢問；`--exclusions`、`--known-issues` 指定對應檔案路徑，省略時若選到防守方會反問）。 - -- **Claude Code / Antigravity**：`/jsc:code-review`（反問分支與角色），或帶參數 `/jsc:code-review main feature/login mage`、`/jsc:code-review main feature/login all --exclusions exclusions.md --known-issues known-issues.md` -- **Codex**：`$code-review main feature/login attack`，或 `$code-review main feature/login all --exclusions docs/review-rules.md --known-issues docs/known-issues.md`，或用 `/skills` 選單 -- **OpenCode**：描述需求（如「用攻防角色 review main 與 feature/login 的差異，排除事項看 docs/review-rules.md、已知問題看 docs/known-issues.md」）自動觸發 - -### `code-review-archive` - -將 `/jsc:code-review` 已裁決的問題保存到專案：**✅ 成立** 附加到前次審查紀錄（已知問題）檔、**❌ 誤判** 附加到排除事項檔，讓防守方下次自動標 🔁 已知問題 / 🚫 略過；🔁／🚫 已存在者僅計數不重複寫入。只吃既有裁決結果（合併攻擊方問題表＋防守方裁決表），不自己跑 review、不改程式碼，且寫檔前先取得同意。檔案格式依副檔名（`.md` / `.json`）決定。 - -參數：`--known-issues <前次審查紀錄路徑> --exclusions <排除事項檔案路徑>`（與 code-review 同名旗標，沿用同一組路徑；缺漏會反問）。 - -- **Claude Code / Antigravity**：`/jsc:code-review-archive --known-issues known-issues.md --exclusions exclusions.md` -- **Codex**：`$code-review-archive --known-issues docs/known-issues.md --exclusions docs/review-rules.md`，或用 `/skills` 選單 -- **OpenCode**：描述需求（如「把剛剛 code-review 成立的問題存到 known-issues.md、誤判存到 exclusions.md」）自動觸發 - ### `code-review-resolve` 五階段：**(A Git 同步)** 先 `fetch`，務必檢查目前分支的線上分支是否存在；存在則留在目前分支更新到最新，不存在則依序切換到遠端 `develop`／`master` 並更新到最新，找不到後備分支則停止；pull 發生衝突時告知並嘗試安全解衝突；只有來源分支與 PR 目標分支相同時，才必須從該分支建立新的工作分支，後續修復、commit、push 與 PR `head` 都使用新分支。**(B 解決)** 讀工作目錄 `.gitea/ai-review/findings.json`（Gitea AI review 產出的問題清單），依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 由高到低**逐條修復**程式碼問題或登記誤報（無法安全自動修復者標「待人工處理」不硬改），已解決或已登記誤報者才自 `findings.json` 移除。**(C 提交)** 分析工作區**所有**變更，依異動內容歸類為 `feat`/`fix`/`docs`/`style`/`refactor`/`perf`/`test`/`chore`/`revert`，**每個 type 各自一個 commit**，訊息為「`type(範圍): 一句總結`」格式，**括號內的範圍須對應實際異動的功能／模組**（例 `feat(使用者登入): 新增帳密登入流程`、`perf(物件查詢): 改用批次查詢降低 DB 往返`，而非 `feat(新增功能)` 這類重述 type 的詞）。**(D 推送)** push 當前分支：先用**認證管理器**、失敗改用 **token**、再失敗**詢問使用者**。**(E 開 PR)** 用 token 透過 **Gitea API** 對目標分支發 PR（**目標分支不明必須詢問、不可猜測**），PR 描述可選**完整版**（重新分析 `git diff` 總結）／**簡單版**（逐條列 commit 訊息）／**使用者輸入**；完成後因內文可能含 gitea token，**提醒並清除 AI 助理對話內文**。除非遇到必要決策，否則依自動執行原則直接處理；token 一律由環境變數（如 `GITEA_TOKEN`）提供，全程不明文輸出。 @@ -263,21 +238,13 @@ rm -rf ~/.config/opencode/skills/{code-review,code-review-archive,code-review-re - **Codex**：`$code-image`，或 `$code-image --dockerfile docker/Dockerfile`，或用 `/skills` 選單 - **OpenCode**：描述需求（如「把這個專案的 Dockerfile 整理成參數處理→安裝套件→複製檔案→執行程序→縮小映像檔→設定入口六步、用多階段建置縮小映像，最後跑 doc-funcs 補文件並重建 README」）自動觸發 -### `hello` - -範例 skill，用來驗證 `jsc` plugin 是否安裝成功，也是新增 skill 的範本。觸發時回覆問候並簡述 plugin 用途。 - -- **Claude Code / Antigravity**：`/jsc:hello` -- **Codex**：`$hello`，或用 `/skills` 選單 -- **OpenCode**：描述需求（如「hello、測試 plugin 有沒有裝好」）自動觸發 - --- ## 新增一個 skill -1. 複製既有 skill 作範本：`cp -r skills/code-review skills/` +1. 複製既有 skill 作範本：`cp -r skills/code-issues skills/` 2. 編輯 `skills//SKILL.md` 的 frontmatter： - `name`：小寫、數字、連字號（`-`），最長 64 字元。**這就是 Claude Code / Antigravity 的 `/jsc:`**。 - `description`：第三人稱，寫清楚「何時用、何時不用」與觸發關鍵字 — 這是各助理自動載入的唯一依據。 -- 2.53.0