Merge pull request '更新版本號至 0.2.0 並補強 code-review-resolve 盤點規則' (#35) from develop into master

Reviewed-on: #35
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "JSC 程式碼審查 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程，以及 C# / .NET NuGet 套件更新流程；於 Claude Code 以 /jsc: 前綴呼叫。",
   "skills": "./skills",
   "author": {

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "JSC 程式碼審查 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程，以及 C# / .NET NuGet 套件更新流程。",
   "skills": "./skills"
 }

README.md

@@ -223,13 +223,13 @@ rm -rf ~/.config/opencode/skills/code-review
 
 ### `code-review-action-docker`
 
-把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把所有 `.js` 集中到 **`app/`**、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 node 版本**的 `Dockerfile`，**每步內容依主程式（`app/`）實作量身決定**（先盤點相依／是否需 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`；(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 <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>] [--yes]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷；`--yes` 略過一般確認，但主程式改寫與 doc-funcs 的實作詢問仍會中斷）。
 
 - **Claude Code / Antigravity**：`/jsc:code-review-action-docker`，或 `/jsc:code-review-action-docker --action-dir ~/work/my-action --node-version 22`
 - **Codex**：`$code-review-action-docker`，或 `$code-review-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單
-- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、所有 js 收進 app/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發
+- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發
 
 ### `code-review-action-composite`
 

plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "JSC 程式碼審查 plugin，提供 RPG 攻防式 git diff review、裁決結果歸檔、Gitea AI review findings 修復/PR 流程，以及 C# / .NET NuGet 套件更新流程；於 Antigravity 以 /jsc: 前綴呼叫。",
   "skills": "./skills/"
 }

skills/code-review-action-docker/SKILL.md

@@ -1,17 +1,17 @@
 ---
 name: code-review-action-docker
-description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化，並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且所有 `.js` 檔一律集中到 `app/` 資料夾；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 node 版本的 `Dockerfile`；(4) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、容器化 action、action 主程式 node 化、把 js 收進 app、產 entrypoint.sh／Dockerfile 給 action，或提到 code-review-action-docker 時觸發。不適用於：非 action 專案、純前端打包、或不需容器化的一般 repo。
+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-review-action-docker 時觸發。不適用於：非 action 專案、純前端打包、或不需容器化的一般 repo。
 argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>] [--yes]"
 ---
 
 # code-review-action-docker — action 容器化（Node 主程式）＋文件化
 
-五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將所有 `.js` 收進 `app/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。
+五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將所有 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。
 
 | 階段 | 動作 |
 | --- | --- |
 | A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description` → 判斷目前主程式與語言 |
-| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 所有 `.js` 集中到 `app/`，更新所有引用、`package.json`、`action.yml` |
+| 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） |
@@ -25,7 +25,7 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [-
 - **自動執行原則**：除非使用者明確要求先確認，或遇到不可忽略的必要決策，否則各階段只需輸出簡短計畫／進度後直接執行到完成。**一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。
 - **不破壞既有工作**：移動 `.js`、改寫主程式、覆寫 `entrypoint.sh`／`Dockerfile`／`action.yml` 前，若工作區有未提交變更，先提醒使用者建議先 commit／備份；**絕不** `reset --hard`／`checkout -f`／`clean`，也不刪除使用者既有原始碼。移動檔案優先用 `git mv` 以保留歷史。
 - **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。
-- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、`.js`（搬移到 `app/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。
+- **不擴及無關檔案**：本 skill 只動 action 專案根目錄內的：主程式、`.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`，以及階段 E 由 doc-funcs 流程處理的目標；排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴。
 
 ---
 
@@ -71,7 +71,7 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [-
 
 ---
 
-## 階段 B：主程式 Node 化，並將所有 `.js` 收進 `app/`
+## 階段 B：主程式 Node 化，並將所有 `.js` 收進 `src/`
 
 ### B1. 主程式 Node 化
 
@@ -82,15 +82,15 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [-
   - 任何無法可靠等價翻譯處，**不臆測**：以 `// 需人工確認：...` 標註並回報。
   - 改寫完成後，原非 Node 主程式於 B2 一併處理（移除或保留由使用者裁示；預設保留並在 README／回報標註已由 Node 取代）。
 
-### B2. 所有 `.js` 集中到 `app/`
+### B2. 所有 `.js` 集中到 `src/`
 
-- 在 action 根目錄建立 `app/`（若不存在）。
+- 在 action 根目錄建立 `src/`（若不存在）。
-- 將專案內所有 `.js`／`.mjs`／`.cjs`（排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）**移入 `app/`**，優先 `git mv` 保留歷史。主程式入口統一為 `app/index.js`（或 `app/<main>.js`）。
+- 將專案內所有 `.js`／`.mjs`／`.cjs`（排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）**移入 `src/`**，優先 `git mv` 保留歷史。主程式入口統一為 `src/index.js`（或 `src/<main>.js`）。
 - **移動後必須更新所有引用**，確保不破壞：
   - 模組間的 `require`／`import` 相對路徑。
-  - `package.json` 的 `main`／`bin`／`scripts`／`exports`（指向 `app/...`）。
+  - `package.json` 的 `main`／`bin`／`scripts`／`exports`（指向 `src/...`）。
   - `action.yml`／`Dockerfile`／`entrypoint.sh` 內對主程式路徑的引用。
-- 若 `app/` 下無 `package.json` 而專案需要相依，於 `app/` 建立或移入 `package.json`，`main` 指向入口檔；不擅自新增與功能無關的相依。
+- 若 `src/` 下無 `package.json` 而專案需要相依，於 `src/` 建立或移入 `package.json`，`main` 指向入口檔；不擅自新增與功能無關的相依。
 
 ### B3. action.yml 對齊 docker
 
@@ -113,7 +113,7 @@ runs:
 
 - **更新時間**為產生此檔當下的時間戳，使用台灣時區（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/app/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。
+- 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。
 
 範例（實際路徑依階段 B 入口而定）：
 
@@ -129,7 +129,7 @@ echo "更新時間: 2026/06/30 18:30:05"
 echo "================================================"
 
 # 啟動 node 主程式（以 exec 取代 shell，正確處理訊號與 exit code）
-exec node /action/app/index.js "$@"
+exec node /action/src/index.js "$@"
 ```
 
 - 賦予可執行權限：`chmod +x entrypoint.sh`（並於 git 標記為可執行）。
@@ -139,25 +139,25 @@ exec node /action/app/index.js "$@"
 
 ## 階段 D：產生 Dockerfile（使用最新 node 版本，六步流程依主程式實作量身產生）
 
-在 action 根目錄產生（或覆寫）`Dockerfile`，**base image 使用最新 node 版本**，採**多階段建置**以縮小最終映像檔。六步流程是**骨架**，但**每一步的實際內容必須依階段 B 的主程式（`app/`）實作決定**——不要套用與主程式無關的固定樣板，也不要硬塞主程式用不到的安裝或建置指令。
+在 action 根目錄產生（或覆寫）`Dockerfile`，**base image 使用最新 node 版本**，採**多階段建置**以縮小最終映像檔。六步流程是**骨架**，但**每一步的實際內容必須依階段 B 的主程式（`src/`）實作決定**——不要套用與主程式無關的固定樣板，也不要硬塞主程式用不到的安裝或建置指令。
 
 ### D0. 先盤點主程式實作需求
 
-產生 Dockerfile 前，先檢視 `app/` 主程式與 `package.json`，判斷各步該放什麼：
+產生 Dockerfile 前，先檢視 `src/` 主程式與 `package.json`，判斷各步該放什麼：
 
-- **相依套件**：`app/package.json` 的 `dependencies`／`devDependencies`、是否有 lockfile（`package-lock.json`／`npm-shrinkwrap.json`）。決定第 2 步用 `npm ci` 還是 `npm install`、是否需要 dev 相依來 build。
+- **相依套件**：`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 決定的主程式入口（如 `app/index.js`），決定第 6 步與 `entrypoint.sh` 內 `node` 路徑。
+- **入口檔**：階段 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` 主程式實際需要的檔案（`app/`、`entrypoint.sh`，及主程式會讀取的資源）；不需要的檔案不必帶入。
+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 時帶入 `app/` 與 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 相依與快取帶進最終映像。
 6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。
 
 base image 版本：預設 build 基底 `node:latest`、runtime 基底 `node:slim`（皆為最新版，slim 用於縮小）；帶 `--node-version <tag>`（如 `22`、`lts`）時改用 `node:<tag>` 與 `node:<tag>-slim`。若需確認當前最新穩定版號，可查詢 Docker Hub（`https://hub.docker.com/_/node`）後於 `FROM` 註記實際版本，但**預設行為是使用最新版**。
@@ -175,11 +175,11 @@ ARG NODE_RUNTIME=slim
 FROM node:${NODE_VERSION} AS build
 WORKDIR /action
 
-# 2. 安裝套件：先帶相依描述以利 layer 快取，再裝 app/ 相依
+# 2. 安裝套件：先帶相依描述以利 layer 快取，再裝 src/ 相依
 #    （需 build 時改裝完整相依；需 OS 套件時於此 apt-get install 並清快取）
-COPY app/package*.json /action/app/
+COPY src/package*.json /action/src/
-RUN if [ -f /action/app/package.json ]; then \
+RUN if [ -f /action/src/package.json ]; then \
-        cd /action/app && (npm ci --omit=dev || npm install --omit=dev); \
+        cd /action/src && (npm ci --omit=dev || npm install --omit=dev); \
     fi
 
 # 3. 複製檔案：複製主程式實際需要的檔案
@@ -200,7 +200,7 @@ 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/app/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式。
+- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式。
 - 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 doc-funcs 指令檔流程統一補齊。
 
 ---
@@ -210,7 +210,7 @@ ENTRYPOINT ["/action/entrypoint.sh"]
 容器化與 Node 化完成後，對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程，替程式碼與指令檔補文件並重建 README：
 
 - 以階段 A1 的 action 根目錄為目標，執行 `doc-funcs` skill 的完整流程（判斷語言 → 掃描 function 與指令檔 → 建立 `.docs/` 草稿 → 草稿品質檢查 → 詢問使用者如何實作 → 依選擇寫回 → 保守優化 → 重建 README → 錨點檢查 → 清理草稿 → 建置／語法驗證）。
-- doc-funcs 會涵蓋本次新增／變更的指令檔：`entrypoint.sh`（補齊「用途＋更新日期同一註解區塊」與逐行註解）、`Dockerfile`（逐行註解）；以及 `app/` 內 Node 主程式與各 function 的文件註解。
+- doc-funcs 會涵蓋本次新增／變更的指令檔：`entrypoint.sh`（補齊「用途＋更新日期同一註解區塊」與逐行註解）、`Dockerfile`（逐行註解）；以及 `src/` 內 Node 主程式與各 function 的文件註解。
 - doc-funcs 的「如何實作」詢問（全部一起／逐個／其他）由使用者於該流程內裁示，本 skill 不代為決定。
 - 完成後依 doc-funcs 規範重建根目錄 `README.md`（含台灣時區更新時間、專案列表、功能列表、使用範例）。
 
@@ -223,7 +223,7 @@ ENTRYPOINT ["/action/entrypoint.sh"]
 各階段執行後輸出：
 
 - **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node。
-- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `app/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）。
+- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）。
 - **階段 C／D**：`entrypoint.sh` 的輸出內容（名稱／用途／更新時間）與啟動的 node 主程式、`Dockerfile` 採用的 node 版本與 `ENTRYPOINT`。
 - **階段 E**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
 - 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。
@@ -238,4 +238,4 @@ ENTRYPOINT ["/action/entrypoint.sh"]
 | --- | --- |
 | Claude Code / Antigravity | `/jsc:code-review-action-docker`，或 `/jsc:code-review-action-docker --action-dir ~/work/my-action --node-version 22` |
 | Codex | `$code-review-action-docker`，或 `$code-review-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 |
-| OpenCode | 描述需求（如「把這個 action 主程式改成 node、所有 js 收進 app/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |
+| OpenCode | 描述需求（如「把這個 action 主程式改成 node、所有 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |

skills/code-review-resolve/SKILL.md

@@ -6,13 +6,13 @@ argument-hint: "[--findings <findings.json 路徑>] [--target <目標分支>] [-
 
 # code-review-resolve — 解決 AI review findings、分類提交、push 並開 PR
 
-五階段 skill：先執行 **git 同步**（`git fetch` → 確認目前分支的遠端分支是否存在；存在則留在目前分支 `git pull` 更新，不存在則切換到 `develop`，再退而 `master` 後 `git pull` 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時告知並嘗試解衝突），再**逐條處理** `.gitea/ai-review/findings.json` 裡的問題；成立問題修復後自 findings 移除，可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json` 後也可自 findings 移除，接著把工作區所有變更**依 conventional commit 類型分門別類 commit**，然後 **push 當前分支**，最後**透過 Gitea API 發 PR**。
+五階段 skill：先執行 **git 同步**（`git fetch` → 確認目前分支的遠端分支是否存在；存在則留在目前分支 `git pull` 更新，不存在則切換到 `develop`，再退而 `master` 後 `git pull` 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時告知並嘗試解衝突），再**逐條處理** `.gitea/ai-review/findings.json` 裡的問題；成立問題修復後自 findings 移除，可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json` 後也可自 findings 移除，接著**必須盤點並處理工作區的所有變更**，再依 conventional commit 類型分門別類 commit，然後 **push 當前分支**，最後**透過 Gitea API 發 PR**。
 
 | 階段 | 動作 |
 | --- | --- |
 | A. Git 同步 | `git fetch` → 當前分支不在遠端則切換 develop（再退而 master）→ `git pull`／必要時解衝突 → 只有來源分支與 PR 目標分支相同時才建立新工作分支 |
 | B. 解決問題 | 讀 `findings.json` / `exclusions.json` → 依等級 🔴→🟠→🟡→🔵 逐條修復或判斷誤報 → 已解決者自 `findings.json` 移除，誤報寫入 `exclusions.json` 後也可移除；**無待處理問題則跳到階段 D** |
-| C. 分類提交 | 分析工作區所有變更 → 依 feat/fix/docs/style/refactor/perf/test/chore/revert 分組 → 各組一個 commit |
+| C. 分類提交 | 必須分析並涵蓋工作區所有變更（已修改／新增／刪除／改名，含已暫存與未暫存、未追蹤檔、findings/exclusions 更新）→ 依 feat/fix/docs/style/refactor/perf/test/chore/revert 分組 → 各組一個 commit |
 | D. Push 當前分支 | 認證管理器 → 失敗改 token → 再失敗詢問使用者；**無 commit 可 push 則跳到階段 E** |
 | E. 發出 PR | 確定目標分支（不明必問）→ 選 PR 描述（完整／簡單／自訂）→ token 呼叫 Gitea API 建 PR → 通知並清除內文 |
 
@@ -237,16 +237,17 @@ canonical 等級為 `critical` / `warning` / `info`；其他寫法容錯對應
 ### C1. 盤點工作區變更
 
 ```bash
-git status --porcelain
+git status --porcelain=v1 -uall
 git diff            # 已追蹤檔的未暫存變更
 git diff --staged   # 已暫存變更
+git ls-files --others --exclude-standard   # 未追蹤檔
 ```
 
-涵蓋**所有**變更：已修改、新增（未追蹤）、刪除、改名。**無任何變更** → 回報「工作區無變更可提交」，跳過提交直接進入階段 D（D 會因無 commit 可 push 而跳到階段 E）。
+盤點時必須以 `git status --porcelain=v1 -uall` 為主，不可只看 `git diff`，因為那會漏掉未追蹤檔。盤點範圍必須包含**所有**變更：已修改檔、新增檔（`??` 未追蹤檔）、刪除檔、改名檔，以及已暫存與未暫存變更。`git diff`、`git diff --staged`、`git ls-files --others --exclude-standard` 只作為輔助核對。**無任何變更** → 回報「工作區無變更可提交」，跳過提交直接進入階段 D（D 會因無 commit 可 push 而跳到階段 E）。
 
 ### C2. 依異動內容歸類 conventional commit 類型
 
-逐一檢視每個變更檔的**實際異動內容**（不只看路徑），歸入下列其一：
+逐一檢視每個變更檔的**實際異動內容**（不只看路徑），歸入下列其一；**所有 `??` 未追蹤檔都必須納入分類**，不能因為它們不在 `git diff` 裡就漏掉：
 
 | type | 適用情境 |
 | --- | --- |
@@ -262,10 +263,11 @@ git diff --staged   # 已暫存變更
 
 - **同一檔案橫跨多型** → 以該檔**主要異動性質**歸類；難以拆分時就近歸入影響最大的一類，並在總結註記。
 - **階段 B 修復產生的變更**：依其性質歸類（修 bug→`fix`、補功能→`feat`、改文件→`docs`…）。`findings.json` / `exclusions.json` 的問題狀態更新歸 `chore`。
+- **未追蹤新檔**：必須照實際內容歸入對應 type，必要時在提交前明確 `git add -- <path>`，不可因為是新檔就略過。
 
 ### C3. 產出提交計畫
 
-把變更檔依 type 分組，**每個 type 一個 commit**，輸出提交計畫；除非使用者要求確認或分組有不可忽略的取捨，否則直接提交：
+把變更檔依 type 分組，**每個 type 一個 commit**，輸出提交計畫；**所有變更項目都必須被追蹤並納入計畫，不能遺漏任何 `??` 未追蹤檔**。除非使用者要求確認或分組有不可忽略的取捨，否則直接提交：
 
 | 順序 | type(範圍) | commit 訊息 | 納入檔案 |
 | --- | --- | --- | --- |
@@ -280,6 +282,7 @@ git diff --staged   # 已暫存變更
   - `一句總結`：把這個 commit 內所有異動**總結成一句**繁體中文（簡短、聚焦做了什麼）。
   - 範例：`feat(使用者登入): 新增帳密登入與 token 簽發`、`fix(結帳流程): 修正空購物車導致的結帳例外`、`perf(物件查詢): 改用批次查詢降低 DB 往返`、`docs(README): 補上安裝與呼叫方式說明`、`chore(ai-review 狀態): 更新 findings.json 與 exclusions.json`。
 - **提交順序建議**：`fix`/`feat` 等核心異動在前，`docs`/`style`/`chore` 在後（純屬建議，可依相依性調整）。
+- **盤點要求**：提交計畫必須完整對應 C1 盤點出的所有變更項目，若有新檔或未追蹤檔，必須明確列入對應 commit，不能只根據 `git diff` 下結論。
 
 ### C4. 執行分類提交
 
@@ -292,6 +295,8 @@ git commit -m "type(範圍): 一句總結"   # 範圍＝實際異動的功能／
 
 - **逐組 add／commit**，確保每個 commit 只含該類異動；不要一次 `git add -A` 再混在一起。
 - 改名／刪除檔一併納入對應組的 `git add`（`git add -A -- <路徑>` 或明確列出）。
+- **所有 `??` 未追蹤檔都必須納入提交**；若是新檔，必要時要明確執行 `git add -- <path>`，不可漏掉。
+- **不可只根據 `git diff` 判斷變更**；C1 盤點出的所有異動都必須反映到分類與提交，否則視為提交計畫不完整。
 - commit 完成後進入階段 D（push）。`--no-commit` 時不進入後續階段；若工作區無變更而沒有產生任何新 commit，仍進入階段 D，由 D 判斷無 commit 可 push 後跳到階段 E。
 
 ---