今天要做什麼外掛（Plugins）

1. 外掛名稱：antigravity-chinese-copywriting
2. GitHub 儲存庫：https://github.com/AndyAWD/antigravity-chinese-copywriting

為什麼要做這個外掛（Plugins）

當初我要準備做 AI 自動版本控制的外掛（也就是我們後續 Day 26、Day 27 會介紹的 antigravity-git-flow）。在讓 AI 幫忙做版本控制之前，最重要的任務之一就是讓它自動產生標準的慣例式提交（Conventional Commits）訊息與提取請求（Pull Request）說明。

但是，提交訊息常常是中英文混合的。在還沒加上排版規範前，AI 產生的繁體中文訊息常常長這樣：

• fix: 修復iOS端登入API錯誤問題（中英數字全部擠在一起，沒有半形空格）
• 在中文句子裡隨便亂用半形逗號 , 或疊用一堆驚嘆號 !!!!
• 專有名詞大小寫亂寫，像是寫成 github、nodejs、Typescript

身為一個對版面有點強迫症的工程師，看到這種 commit 紀錄真的會抓狂！總不能每次開新專案都要手動複製貼上一大串提示詞（Prompt）給 AI 吧？所以最優雅的解法，就是把「中文文案排版指北」直接打包成一個隨插即用的 Antigravity 外掛，讓它成為整個 AI 自動化工作流的排版地基！

這個外掛做的過程

雖然這個外掛主要是設定檔與 Markdown 規則，但在製作過程中，我還真的踩了個哭笑不得的坑：

1. 踩坑：Gemini 偷懶放網址事件！

我一開始想得很美：既然網路上已經有現成的「中文文案排版指北」，那我直接叫 Agy CLI 去看這個網址，然後叫它把內容做成技能（Skill）。

本來以為幾秒鐘就能輕鬆收工，結果打開生成的 SKILL.md 一看，差點沒氣暈——大型語言模型（Large Language Model）Gemini 竟然給我偷懶！在技能規格裡只寫了一句：

「排版規則請參考網址：https://github.com/sparanoid/chinese-copywriting-guidelines 」

這在實際使用時根本是個大雷：

• 每次用技能都要連網爬蟲？ AI 為了幫我排版一句話，還得先發 HTTP 請求去讀外部網頁，平白無故多等好幾秒。
• 沒網路或被限流直接掛掉：如果在飛航模式、離線環境，或者 GitHub 觸發速率限制（Rate Limit），這個技能就直接失靈。
• 外部雜訊與幻覺：外部網頁可能改版或動態載入，AI 沒爬到完整內文就開始憑感覺瞎猜規則。

我立刻嚴格要求它修正：「絕對不要只放參考網址！把所有空格規則、全形標點、專有名詞大小寫對照表跟例外狀況，通通完整寫進 SKILL.md 裡面！」確保整個外掛是 100% 自包含且離線可用（Offline-first），最後才淬鍊出現在這份 159 行的扎實規則庫。

2. 演進：從 Claude Code 遷移到 Antigravity 與命名空間重構

看這個專案的 Git 歷史，其實記錄了一段有趣的演進歷程：

1. 原型探索：7 月底我其實先在 Claude Code 上做過實驗（當時技能名稱叫落落長的 chinese-copywriting-guidelines）。
2. 遷移 Antigravity（Commit 97bbd41）：8 月正式遷移成 Antigravity 外掛。第一筆 commit 訊息就是 refactor: 重構技能名稱為 guidelines，簡化斜線指令為 /chinese-copywriting-agy:guidelines，把外掛結構標準化。
3. 命名空間升級（Commit 8205c6c）：後來為了符合生態系的命名慣例，避免通用名 guidelines 撞名，我把外掛正式命名為 antigravity-chinese-copywriting，技能名稱改成 agy-chinese-copywriting，GitHub 儲存庫也正式更名為 antigravity-chinese-copywriting，指令升級為 /agy-chinese-copywriting。
4. 文件重構（Commit 9151789）：最後參考官方生態系外掛 agy_help 的架構，補足了完整的 README 規格、安裝途徑與生命週期指令。

目錄結構

一個標準的 Google Antigravity 外掛結構非常乾淨小巧：

antigravity-chinese-copywriting/
├── LICENSE                               # MIT 開源授權條款
├── README.md                              # 完整繁體中文說明文件
├── plugin.json                           # 外掛資訊清單（Plugin Manifest）
└── skills/                               # 技能目錄
    └── agy-chinese-copywriting/          # 中文文案排版技能目錄
        └── SKILL.md                      # 技能規格檔（YAML 前端資訊與排版手冊）

關鍵檔案解析

1. 外掛資訊清單：plugin.json

這就像外掛的身分證，負責宣告套件名稱、版本與 GitHub 資訊：

{
  "name": "antigravity-chinese-copywriting",
  "version": "1.0.0",
  "description": "Antigravity plugin for Chinese Copywriting Guidelines (sparanoid/chinese-copywriting-guidelines) - auto-spacing, full-width punctuation, and proper-noun casing across Antigravity CLI (agy), IDE, and Antigravity 2.0 (Desktop).",
  "author": "AndyAWD <anandydy529@gmail.com>",
  "license": "MIT",
  "homepage": "https://github.com/AndyAWD/antigravity-chinese-copywriting",
  "repository": "https://github.com/AndyAWD/antigravity-chinese-copywriting",
  "keywords": [
    "antigravity",
    "agy",
    "antigravity-chinese-copywriting",
    "agy-chinese-copywriting",
    "chinese-copywriting-agy",
    "zh-tw",
    "pangu",
    "style-guide"
  ]
}

2. 技能規格檔：skills/agy-chinese-copywriting/SKILL.md

檔案頂部是 YAML 前端資訊（YAML Frontmatter），讓 AI 知道什麼時候該主動觸發這個技能：

---
name: agy-chinese-copywriting
description: 套用 sparanoid/chinese-copywriting-guidelines 的中文文案排版規則 —— 中英文與數字之間補空格、使用全形中文標點、專有名詞正確大小寫（如 GitHub、iPhone、TypeScript、macOS）。當使用者明確請求「校對中文」「套用中文排版」「加空格」「pangu」「中文格式化」，或是 Antigravity 生態系（含 agy CLI, Antigravity IDE, Antigravity 2.0 Desktop）在撰寫、編輯 .md、.mdx、.txt、.rst 等文件檔的中文內容時，務必觸發此 skill。程式碼、code comments、字串常數、URL、檔名、以及純英文內容不套用。
---

前端資訊底下就是那 159 行扎實的離線排版規則。

這外掛怎麼用

安裝方式

你可以依照習慣選擇以下三種安裝途徑：

方式 1：GitHub 遠端一鍵安裝（最推薦）

打開終端機，直接輸入：

agy plugin install https://github.com/AndyAWD/antigravity-chinese-copywriting

Agy CLI 會自動幫你下載並註冊好，馬上就能用！

方式 2：本機開發模式安裝

如果你 clone 到本地想自己修改客製化：

# 在專案目錄下執行：
agy plugin install .

# 或是指定本地路徑：
agy plugin install /path/to/antigravity-chinese-copywriting

方式 3：專案工作區共享（團隊共用）

如果你只想讓某個專案生效，且希望跟著 Git 版控給團隊成員，直接把外掛放到專案目錄下的 .agents/plugins/ 即可：

你的專案/
└── .agents/
    └── plugins/
        └── antigravity-chinese-copywriting/
            ├── plugin.json
            └── skills/
                └── agy-chinese-copywriting/
                    └── SKILL.md

外掛生命週期管理

安裝完後，可以用這些 CLI 指令隨時管理：

# 查看目前裝了哪些外掛
agy plugin list

# 暫時停用外掛
agy plugin disable antigravity-chinese-copywriting

# 重新啟用外掛
agy plugin enable antigravity-chinese-copywriting

# 移除外掛
agy plugin uninstall antigravity-chinese-copywriting

在 Antigravity 2.0 桌面端也可以直接在 Settings > Plugins 裡用圖形開關一鍵啟閉。

三種實戰使用情境

1. 用斜線指令（Slash Command）即時校對

直接在對話框輸入指令：

> /agy-chinese-copywriting 幫我校對這段話：今天買了iPhone12花了3萬元，用github登入。

AI 就會精準吐出漂亮的排版：

今天買了 iPhone 12 花了 3 萬元，用 GitHub 登入。

2. 日常交談中自然觸發

只要在對話中說「幫我校對中文」、「加空格」、「排版一下」、「套用中文排版」或「pangu 一下」，AI 就會自動喚醒這個外掛幫你處理。

3. 寫 README 與文件時自動維持水準

當你叫 AI 幫你寫專案的 README.md、技術文章或 Release Notes 時，它會在背景自動套用這套排版標準，讓產出的中英混排文件自帶專業呼吸感！