回到專案首頁

Antigravity 專案可用 Skills 說明手冊

提供給開發者與 AI 協作的高效率專業技能手冊 (繁體中文版)

專案可用技能總覽 這些技能已預裝於專案的 .gemini/skills 目錄中
21

1. caveman

野人極簡溝通模式
caveman
💡 中文功能說明

超壓縮的溝通模式,能將 Token 使用量減少約 75%。它會主動省略所有客套話、冠詞與不必要的修飾贅詞,在保持 100% 技術精確度的前提下,以極致精簡的片段與符號進行回答。

⚡ 觸發條件
  • 當使用者說 'caveman mode'、'talk like caveman'、'use caveman' 時
  • 當使用者希望節省 token、要求 'less tokens'、'be brief' 或輸入 /caveman 命令時
📝 範例與情境說明
使用者:「為什麼 React 元件會重複渲染?」 野人模式回答:「Inline obj prop -> new ref -> re-render. useMemo.」

2. diagnose

紀律化問題診斷
diagnose
💡 中文功能說明

專門面向棘手 Bug 和效能退化的紀律化診斷循環。核心思維在於優先建立一個「快速、確定且可由 Agent 自動化運行的失敗/通過反饋環」,隨後依循「重現 -> 最小化 -> 列出可證偽假設 -> 工具觀測與插樁 -> 修復 -> 迴歸測試」的標準流程解決問題。

⚡ 觸發條件
  • 當使用者說 'diagnose this'、'debug this' 時
  • 當使用者報告 Bug、系統出錯(throwing/failing)或描述效能衰退(performance regression)時
📝 範例與情境說明
引導進行「建立測試反饋環 -> 穩定重現 -> 列出 3-5 個可證偽假設 -> 單一變量插樁 log -> 修正並於 caller seam 建立迴歸測試」。

3. find-skills

技能搜尋與安裝
find-skills
💡 中文功能說明

協助使用者在開源 Agent 技能生態系(skills.sh)中搜尋、評估並安裝適用的自訂技能包。透過 `npx skills` 命令列工具動態擴展 Agent 的專業領域能力。

⚡ 觸發條件
  • 當使用者詢問 'how do I do X'(且 X 為常見任務)或詢問是否有特定功能的技能時
  • 當使用者說 'find a skill for X'、'is there a skill that can...' 或想擴充 Agent 能力時
📝 範例與情境說明
搜尋 React 效能優化技能:npx skills find react performance 推薦並安裝適當技能:npx skills add vercel-labs/agent-skills@react-best-practices -g -y

4. git-guardrails-claude-code

Git 安全防護欄
git-guardrails-claude-code
💡 中文功能說明

為 Claude Code 設置 PreToolUse 攔截器鉤子(hook),在執行具有破壞性或危險的 Git 命令前自動阻止,保護本機或遠端專案分支免受誤操作損毀。

⚡ 觸發條件
  • 當使用者希望防範危險 Git 操作、設定 Git 安全鉤子或在 Claude Code 中阻止 push/reset 時
  • 提及 pre-commit 安全機制或環境防護時
📝 範例與情境說明
當 Agent 試圖執行 git push --force 或 git reset --hard 時,攔截器將其阻擋並拋出 [BLOCKED] 警告訊息,確保代碼庫安全。

5. grill-me

計畫與設計深度訪談
grill-me
💡 中文功能說明

圍繞開發計畫或架構設計,對使用者進行持續的訪談式提問,一次只提問一個問題,沿著決策樹的每個分支探討,直至雙方達成完全一致的理解,並解決所有依賴決策。

⚡ 觸發條件
  • 當使用者想要對開發計畫進行壓力測試、評估設計合理性時
  • 當使用者提及 'grill me' 或輸入 /grill-me 時
📝 範例與情境說明
提出一個核心架構提問,並附上 Agent 推薦的選項: 「您打算將狀態儲存在全域 Context 還是各別 Page Component 中?我推薦全域,因為這樣有利於跨頁面同步數據。」

6. grill-with-docs

領域文件對照訪談
grill-with-docs
💡 中文功能說明

結合專案既有的領域模型與決策文件(`CONTEXT.md`、`docs/adr/`),對使用者的開發計畫進行嚴格的壓力測試。當發現使用者的術語或設計與既有文件衝突時會立即指出,並隨共識即時更新文件。

⚡ 觸發條件
  • 當使用者想要對照專案既有術語表與架構決策,對計畫進行嚴格的壓力測試時
  • 當使用者提及 'grill with docs' 時
📝 範例與情境說明
當發現使用者所講的「帳戶」概念模糊時進行挑戰: 「您的術語表定義 'Customer' 與 'User' 是不同實體,您指的 'Account' 是指哪一個?我們應該修正 CONTEXT.md 以保持術語精確。」

7. gstack

開發堆疊與部署管理
gstack
💡 中文功能說明

提供一整套用於配置環境、同步大腦數據與發佈程式碼的自動化部署與維運技能組。包含了 devex-review、unfreeze、ship、sync-gbrain、skillify 等子工具。

⚡ 觸發條件
  • 當需要進行環境初始化、自動化代碼 ship(發佈)、同步 gbrain 狀態時
  • 管理瀏覽器 Cookie 或部署設定時
📝 範例與情境說明
自動化執行 ship 操作:執行建置、執行單元與整合測試、確認代碼無誤後合併分支並自動發佈推播通知。

8. handoff

任務移交文檔生成
handoff
💡 中文功能說明

將目前對話的完整脈絡、已完成的工作、待辦事項與當前系統狀態,高度壓縮整理為一份標準的 Markdown 移交文檔,使下一個接手的 Agent 能瞬間進入狀況,實現無縫任務交接。

⚡ 觸發條件
  • 當使用者需要結束當前會話、移交任務,或準備更換協作 Agent 時
  • 提及 'handoff' 或任務交接時
📝 範例與情境說明
在專案目錄下生成一個包含 # Context(背景)、# Completed(已完成)、# Next Steps(下一步)與 # Open Questions(待解決問題)的 Markdown 移交文件。

9. improve-codebase-architecture

程式碼庫架構優化
improve-codebase-architecture
💡 中文功能說明

根據專案的 `CONTEXT.md` 領域術語與 ADR 架構決策,尋找程式碼庫中可深化與優化的重構機會。主要著眼於消除緊密耦合、提升模組邊界清晰度與程式碼的可測試性。

⚡ 觸發條件
  • 當使用者想要改善架構、進行代碼重構、整併高度耦合模組或提高程式碼的可測試性與可讀性時
  • 提及 'improve architecture' 時
📝 範例與情境說明
分析現有 API 呼叫鏈,提議將多個緊密耦合的底層 DB 操作整併至統一的 Repository 分層中,並新增單元測試的 mock seam。

10. migrate-to-shoehorn

Shoehorn 測試斷言遷移
migrate-to-shoehorn
💡 中文功能說明

將測試檔案中的手動類型斷言(`as`)遷移至 `@total-typescript/shoehorn`。此舉能確保測試資料的安全與強型別約束,避免因強制斷言造成的隱式測試錯誤。

⚡ 觸發條件
  • 當使用者提到 'shoehorn'、想在測試中取代 'as' 斷言或需要建構部分測試資料時
  • 提及 TypeScript 測試重構時
📝 範例與情境說明
將測試程式中的 const fakeUser = { id: 1 } as User 遷移改寫為 const fakeUser = shoehorn({ id: 1 }),確保未填欄位能獲得安全的 TypeScript 輔助。

11. nlm-skill

NotebookLM 專家指南
nlm-skill
💡 中文功能說明

提供 Google NotebookLM 的程式化互動介面與指令,引導建立與管理筆記本、新增來源(網址、YouTube、雲端硬碟),並自動生成 Podcast 音訊、摘要報告、心智圖、字卡等高價值資產。

⚡ 觸發條件
  • 當使用者想要與 NotebookLM 進行程式化互動,或提及 'nlm'、'notebooklm' 時
  • 當提及 Podcast 生成(audio overview)或自動化文檔研究時
📝 範例與情境說明
匯入多個專案文件與開發文檔,自動生成一個英語雙人對話的 Podcast 音訊總覽檔案,並同步產出結構化心智圖與重點測驗題。

12. prototype

拋棄式原型開發
prototype
💡 中文功能說明

在投入正式實作前,快速開發一個暫時性、可運行的原型(例如終端機 App 或多套可切換的 UI),用於快速驗證設計、梳理狀態機邏輯並收集使用者反饋,避免過早進行無效的代碼堆疊。

⚡ 觸發條件
  • 當使用者說 'prototype this'、'let me play with it'、'try a few designs' 時
  • 想在確認最終方案前驗證資料模型或 UI 佈局選項時
📝 範例與情境說明
在單一頁面路由下設計 3 套不同佈局的 Dashboard UI,讓使用者點擊按鈕直接切換,快速比對不同設計的易用性。

13. scaffold-exercises

教學練習教材腳手架
scaffold-exercises
💡 中文功能說明

自動化建立標準的教學教材目錄結構,包含章節說明、練習問題(problem)、標準解答(solution)與概念解釋檔案(explainer),並確保該結構能順利通過 lint 檢驗。

⚡ 觸發條件
  • 當使用者想要腳手架化練習教材、建立練習 Stub 或設置全新教學課程章節時
  • 提及 'scaffold exercises' 時
📝 範例與情境說明
自動建立 /exercises/01-basics,並在該目錄下生成 problem.ts(待挖空作答)與 solution.ts(滿分標準答案)及測試檔案。

14. setup-matt-pocock-skills

Agent 專案技能初始化
setup-matt-pocock-skills
💡 中文功能說明

在專案根目錄中配置 `AGENTS.md` / `CLAUDE.md` 及 `docs/agents/` 目錄。此設定能告訴協作的各類開發技能:本專案使用何種 Issue 追蹤器(GitHub 或 Markdown 檔案)、triage 分類標籤、以及架構文件的儲存位置。

⚡ 觸發條件
  • 在首次使用 to-issues、triage、tdd、diagnose 等專業技能之前
  • 當這些技能因為缺乏專案 Issue tracker 資訊而無法正常運作時
📝 範例與情境說明
掃描當前專案,產生 AGENTS.md 檔案並標註:「本專案使用 GitHub Issues 作為追蹤器,優先 triage 標籤為 'bug' 與 'architecture'」。

15. setup-pre-commit

Pre-commit 提交檢驗設置
setup-pre-commit
💡 中文功能說明

在 Repo 中安裝與配置 Husky 與 lint-staged,整合 Prettier 程式碼格式化、TypeScript 類型檢查及自動單元測試。確保每次程式碼提交前都符合代碼品質規範。

⚡ 觸發條件
  • 當使用者想加入 pre-commit hook、設定 Husky 或在 commit 前強制執行檢驗時
  • 提及 'pre-commit' 時
📝 範例與情境說明
當使用者執行 git commit 時,背景自動針對本次變更的檔案執行 prettier --write 與 tsc --noEmit,確認格式與強型別無誤後才允許完成提交。

16. tdd

測試驅動開發 (TDD)
tdd
💡 中文功能說明

遵循嚴格的「紅燈-綠燈-重構」循環進行測試驅動開發。堅持「測試先行」原則,先撰寫會失敗的測試,再編寫剛好能通過測試的最簡程式碼,最後進行重構優化,保證程式碼的高穩定度與低耦合度。

⚡ 觸發條件
  • 當使用者提及 'tdd'、'red-green-refactor',或要求以測試先行方式開發功能/修復 Bug 時
  • 要求撰寫整合測試或單元測試覆蓋率時
📝 範例與情境說明
先寫一個會失敗的計算折扣邏輯測試 -> 撰寫剛好能通過測試的最簡折價程式碼 -> 重構代碼消除重複,並隨時執行測試確保無 Regression。

17. to-issues

開發計畫拆解 Issue
to-issues
💡 中文功能說明

採用垂直切片(vertical slices)策略,將大型的開發計畫、設計規格或 PRD,拆解成可以在專案追蹤器(GitHub 或 Markdown 檔案)上獨立分工、領取並被實作的精確 Issues (Tickets)。

⚡ 觸發條件
  • 當使用者想把 plan 轉換為 ticket、建立實作票券,或將龐大工作拆解為子 Issue 時
  • 提及 'to issues' 時
📝 範例與情境說明
將「實作購物車功能」的計畫,拆解為三個獨立可實作的 Issue: 1. Issue #1: 實作購物車 DB 儲存與 API。 2. Issue #2: 實作購物車前端 UI 卡片。 3. Issue #3: 整合促銷折價計算。

18. to-prd

對話脈絡生成 PRD
to-prd
💡 中文功能說明

將當前對話中的背景討論與功能共識,整理成一份專業且結構完整的 PRD(產品需求文件),並自動發佈至專案的 Issue 追蹤系統中供後續開發參考。

⚡ 觸發條件
  • 當使用者要求從目前的對話脈絡生成 PRD(產品需求文件)時
  • 提及 'to prd' 時
📝 範例與情境說明
自動收集討論中的 User Stories(使用者故事)、非功能性需求與核心業務邏輯,生成一份格式嚴謹的 Markdown PRD 檔案。

19. triage

Issue 狀態機分流整理
triage
💡 中文功能說明

透過 triage 角色與嚴格的狀態機,對專案的待處理 Bug、功能提案或使用者反應進行審查、核實、標籤分類與分流指派,為開發團隊準備乾淨且具備重現步驟的工作項。

⚡ 觸發條件
  • 當使用者想分類 Issues、處理 incoming bugs、指派工作,或管理 Issue 生命週期時
  • 提及 'triage' 或整理 issue tracker 時
📝 範例與情境說明
將新開的 bug ticket 標註為 triage:needed,確認其有完整重現步驟後,將狀態流轉為 status:accepted,並標記複雜度與對應 label。

20. write-a-skill

自訂新技能開發
write-a-skill
💡 中文功能說明

引導開發出結構正確、支援漸進式資訊揭露(progressive disclosure)並打包有輔助資源(如 script、範例)的全新 Agent Skill,用以擴展 Agent 的工具箱。

⚡ 觸發條件
  • 當使用者想要建立、撰寫或建構一個新的 Skill 來擴展 Agent 能力時
  • 提及 'write a skill' 時
📝 範例與情境說明
在 .gemini/skills/ 下建立包含符合 YAML 格式的 SKILL.md、/scripts 輔助指令以及 /examples 範例的完整技能結構。

21. zoom-out

全局宏觀檢視
zoom-out
💡 中文功能說明

當遇到陌生代碼或複雜系統時,引導 Agent 暫時抽離當前檔案的局部實作細節,提供更廣泛的上下文、繪製依賴關係圖或高層次的系統全局視角,幫助理清整體架構定位。

⚡ 觸發條件
  • 進入不熟悉的代碼區塊、感到迷失,或想理解目前模組在整個專案中的角色與定位時
  • 當使用者提及 'zoom out' / 'zoom-out' 或需要全局 context 時
📝 範例與情境說明
跳出單一實體類別定義,為使用者繪製整個 ordering 微服務的架構模型,並說明目前元件在非同步訊息處理鏈中的位置。