docs(doc-funcs): 補齊 action 與 workflow 文件

.gitea/workflows/ci.yaml

@@ -1,45 +1,92 @@
+# ============================================================================
+# 用途：在 pull request 針對 develop 分支開啟或同步時，分別以 Antigravity、Codex、Claude 環境執行本機 AI Code Review action。
+# 更新時間：2026/07/17 18:49:58
+# ============================================================================
+# Workflow 顯示名稱。
 name: CI
 
+# Workflow 觸發條件區塊。
 on:
+  # 以 pull request 事件觸發。
   pull_request:
+    # 限定 pull request 目標分支。
     branches:
+    # 僅在目標分支為 develop 時執行。
     - develop
+    # 限定 pull request 開啟與同步更新時執行。
     types: [opened, synchronize]
 
+# Job 定義區塊。
 jobs:
+  # Antigravity 工具環境測試 job。
   test-antigravity:
+    # Job 在 workflow UI 顯示的名稱。
     name: TEST (Antigravity)
+    # 指定執行 runner 標籤；需人工確認本 Gitea runner 是否使用 ubuntu 標籤。
     runs-on: ubuntu
+    # Job 執行步驟。
     steps:
+    # 取得存取庫內容供後續 action 使用。
     - name: 取得存取庫資訊
+      # 使用呼叫端 vars 指定的 checkout action 版本。
       uses: actions/checkout@${{ vars.ACTION_CHECKOUT_VERSION }}
+    # 安裝 Antigravity 工具環境。
     - name: 安裝工具
+      # 使用 Gitea composite action 安裝 Antigravity，版本由 vars 指定。
       uses: https://gitea.jsc.idv.tw/composite-actions/setup-antigravity@${{ vars.ACTION_SETUP_ANTIGRAVITY_VERSION }}
+    # 執行目前存取庫的 AI Code Review action。
     - name: 程式碼審查
+      # 以目前存取庫根目錄的 action.yml 作為 action 來源。
       uses: ./
+      # 傳入 action inputs。
       with:
+        # Gitea / GitHub token，用於 PR 留言與 findings 寫回。
         token: ${{ secrets.GITHUB_TOKEN }}
+  # Codex 工具環境測試 job。
   test-codex:
+    # Job 在 workflow UI 顯示的名稱。
     name: TEST (Codex)
+    # 指定執行 runner 標籤；需人工確認本 Gitea runner 是否使用 ubuntu 標籤。
     runs-on: ubuntu
+    # Job 執行步驟。
     steps:
+    # 取得存取庫內容供後續 action 使用。
     - name: 取得存取庫資訊
+      # 使用呼叫端 vars 指定的 checkout action 版本。
       uses: actions/checkout@${{ vars.ACTION_CHECKOUT_VERSION }}
+    # 安裝 Codex 工具環境。
     - name: 安裝工具
+      # 使用 Gitea composite action 安裝 Codex，版本由 vars 指定。
       uses: https://gitea.jsc.idv.tw/composite-actions/setup-codex@${{ vars.ACTION_SETUP_CODEX_VERSION }}
+    # 執行目前存取庫的 AI Code Review action。
     - name: 程式碼審查
+      # 以目前存取庫根目錄的 action.yml 作為 action 來源。
       uses: ./
+      # 傳入 action inputs。
       with:
+        # Gitea / GitHub token，用於 PR 留言與 findings 寫回。
         token: ${{ secrets.GITHUB_TOKEN }}
+  # Claude 工具環境測試 job。
   test-claude:
+    # Job 在 workflow UI 顯示的名稱。
     name: TEST (Claude)
+    # 指定執行 runner 標籤；需人工確認本 Gitea runner 是否使用 ubuntu 標籤。
     runs-on: ubuntu
+    # Job 執行步驟。
     steps:
+    # 取得存取庫內容供後續 action 使用。
     - name: 取得存取庫資訊
+      # 使用呼叫端 vars 指定的 checkout action 版本。
       uses: actions/checkout@${{ vars.ACTION_CHECKOUT_VERSION }}
+    # 安裝 Claude 工具環境。
     - name: 安裝工具
+      # 使用 Gitea composite action 安裝 Claude，版本由 vars 指定。
       uses: https://gitea.jsc.idv.tw/composite-actions/setup-claude@${{ vars.ACTION_SETUP_CLAUDE_VERSION }}
+    # 執行目前存取庫的 AI Code Review action。
     - name: 程式碼審查
+      # 以目前存取庫根目錄的 action.yml 作為 action 來源。
       uses: ./
+      # 傳入 action inputs。
       with:
+        # Gitea / GitHub token，用於 PR 留言與 findings 寫回。
         token: ${{ secrets.GITHUB_TOKEN }}