feat: 建立 Setup Antigravity composite action 並將 CI 改為安裝驗證流程 #1

2026-07-17T04:53:41Z

jiantw83 commented

2026-07-17 04:53:41 +00:00

變更摘要

本次將原本的 Gitea Composite 範本改造為實用的 Setup Antigravity composite action，並同步調整 CI 流程與說明文件，總計 4 個檔案、+148 / -289 行。

feat(action)：action.yml 重寫為 Setup Antigravity composite action，包含三個步驟：顯示啟動橫幅（名稱／用途／更新時間）→ 以官方腳本安裝 Antigravity CLI（agy）→ 將 base64 編碼的 OAuth 憑證解碼寫入憑證檔並限縮權限。新增必填輸入參數 oauth，移除原本的 message 輸入與輸出。
docs(README)：重建 readme.md，補上 oauth 參數說明、執行步驟表與使用範例。
chore(CI)：將 workflow 由 .gitea/scoped_workflows/ci.yaml 移至 .gitea/workflows/ci.yaml，並把原本的「計算版本 → 發布 release → 清理舊版」流程改為「checkout → 以本地 action（uses: ./）安裝工具 → agy --version 驗證安裝」的安裝驗證流程。

影響範圍

本 repo 對外契約改變：引用端需改以 with: oauth: 傳入 base64 OAuth 憑證，原 message 輸入／輸出已移除。
CI 觸發條件維持 pull_request（目標分支 master 或 develop，opened / synchronize）不變。
workflow 檔案路徑變更（scoped_workflows → workflows），原發布 release 相關流程已被安裝驗證流程取代。

重點檔案

action.yml：composite action 主體與 oauth 輸入契約。
.gitea/workflows/ci.yaml：新的安裝驗證 CI（新增）。
.gitea/scoped_workflows/ci.yaml：原發布流程（刪除）。
readme.md：重建後的說明文件。

風險／注意事項（需人工確認）

CI 中 uses: ./ 未傳入必填 oauth：action.yml 已將 oauth 設為必填，但 .gitea/workflows/ci.yaml 的「安裝工具」步驟以 uses: ./ 引用時並未傳入 oauth，實際執行會因缺少必填輸入而失敗。若要讓 CI 通過，需補上 with: oauth: ${{ secrets.ANTIGRAVITY_OAUTH_B64 }}（或對應的 secret 名稱）。
agy 於 ~/.local/bin 的 PATH 問題：Antigravity CLI 安裝後 binary 位於 ~/.local/bin，該路徑預設不一定在 runner 的 PATH 上；agy --version 步驟可能因找不到指令而失敗，需先將 ~/.local/bin 加入 PATH（例如寫入 $GITHUB_PATH）。

## 變更摘要本次將原本的 Gitea Composite 範本改造為實用的 **Setup Antigravity** composite action，並同步調整 CI 流程與說明文件，總計 4 個檔案、+148 / -289 行。 - `feat(action)`：`action.yml` 重寫為 Setup Antigravity composite action，包含三個步驟：顯示啟動橫幅（名稱／用途／更新時間）→ 以官方腳本安裝 Antigravity CLI（`agy`）→ 將 base64 編碼的 OAuth 憑證解碼寫入憑證檔並限縮權限。新增必填輸入參數 `oauth`，移除原本的 `message` 輸入與輸出。 - `docs(README)`：重建 `readme.md`，補上 `oauth` 參數說明、執行步驟表與使用範例。 - `chore(CI)`：將 workflow 由 `.gitea/scoped_workflows/ci.yaml` 移至 `.gitea/workflows/ci.yaml`，並把原本的「計算版本 → 發布 release → 清理舊版」流程改為「checkout → 以本地 action（`uses: ./`）安裝工具 → `agy --version` 驗證安裝」的安裝驗證流程。 ## 影響範圍 - 本 repo 對外契約改變：引用端需改以 `with: oauth:` 傳入 base64 OAuth 憑證，原 `message` 輸入／輸出已移除。 - CI 觸發條件維持 `pull_request`（目標分支 `master` 或 `develop`，`opened` / `synchronize`）不變。 - workflow 檔案路徑變更（`scoped_workflows` → `workflows`），原發布 release 相關流程已被安裝驗證流程取代。 ## 重點檔案 - `action.yml`：composite action 主體與 `oauth` 輸入契約。 - `.gitea/workflows/ci.yaml`：新的安裝驗證 CI（新增）。 - `.gitea/scoped_workflows/ci.yaml`：原發布流程（刪除）。 - `readme.md`：重建後的說明文件。 ## 風險／注意事項（需人工確認） 1. **CI 中 `uses: ./` 未傳入必填 `oauth`**：`action.yml` 已將 `oauth` 設為必填，但 `.gitea/workflows/ci.yaml` 的「安裝工具」步驟以 `uses: ./` 引用時並未傳入 `oauth`，實際執行會因缺少必填輸入而失敗。若要讓 CI 通過，需補上 `with: oauth: ${{ secrets.ANTIGRAVITY_OAUTH_B64 }}`（或對應的 secret 名稱）。 2. **`agy` 於 `~/.local/bin` 的 PATH 問題**：Antigravity CLI 安裝後 binary 位於 `~/.local/bin`，該路徑預設不一定在 runner 的 `PATH` 上；`agy --version` 步驟可能因找不到指令而失敗，需先將 `~/.local/bin` 加入 `PATH`（例如寫入 `$GITHUB_PATH`）。

admin changed target branch from master to develop

2026-07-17 09:05:54 +00:00

admin added 4 commits 2026-07-17 09:05:54 +00:00

feat(action): 安裝 Antigravity CLI 並還原 OAuth 憑證 283c01941f

docs(README): 重建說明並補上 oauth 參數與使用範例 4d4d87f1cf

chore(CI): 將 workflow 移至 .gitea/workflows 並改為安裝驗證流程

composite-actions/template: CI / BUILD (pull_request) Failing after 5s

Details

CI / TEST (pull_request) Failing after 17s

Details

39a3e6c94b

chore(CI): 僅在 PR 至 develop 時觸發並移除未使用的環境變數

composite-actions/template: CI / BUILD (pull_request) Successful in 5s

Details

a831385e4b

admin merged commit 10a1db3214 into develop

2026-07-17 09:05:57 +00:00

admin deleted branch ai-review-resolve/master-20260717-125145

2026-07-17 09:05:57 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: composite-actions/setup-antigravity#1