💡 中文功能說明
超壓縮的溝通模式,能將 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.」
💡 中文功能說明
專門面向棘手 Bug 和效能退化的紀律化診斷循環。核心思維在於優先建立一個「快速、確定且可由 Agent 自動化運行的失敗/通過反饋環」,隨後依循「重現 -> 最小化 -> 列出可證偽假設 -> 工具觀測與插樁 -> 修復 -> 迴歸測試」的標準流程解決問題。
⚡ 觸發條件
- 當使用者說 'diagnose this'、'debug this' 時
- 當使用者報告 Bug、系統出錯(throwing/failing)或描述效能衰退(performance regression)時
📝 範例與情境說明
引導進行「建立測試反饋環 -> 穩定重現 -> 列出 3-5 個可證偽假設 -> 單一變量插樁 log -> 修正並於 caller seam 建立迴歸測試」。
💡 中文功能說明
協助使用者在開源 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
💡 中文功能說明
為 Claude Code 設置 PreToolUse 攔截器鉤子(hook),在執行具有破壞性或危險的 Git 命令前自動阻止,保護本機或遠端專案分支免受誤操作損毀。
⚡ 觸發條件
- 當使用者希望防範危險 Git 操作、設定 Git 安全鉤子或在 Claude Code 中阻止 push/reset 時
- 提及 pre-commit 安全機制或環境防護時
📝 範例與情境說明
當 Agent 試圖執行 git push --force 或 git reset --hard 時,攔截器將其阻擋並拋出 [BLOCKED] 警告訊息,確保代碼庫安全。
💡 中文功能說明
圍繞開發計畫或架構設計,對使用者進行持續的訪談式提問,一次只提問一個問題,沿著決策樹的每個分支探討,直至雙方達成完全一致的理解,並解決所有依賴決策。
⚡ 觸發條件
- 當使用者想要對開發計畫進行壓力測試、評估設計合理性時
- 當使用者提及 'grill me' 或輸入 /grill-me 時
📝 範例與情境說明
提出一個核心架構提問,並附上 Agent 推薦的選項:
「您打算將狀態儲存在全域 Context 還是各別 Page Component 中?我推薦全域,因為這樣有利於跨頁面同步數據。」
💡 中文功能說明
結合專案既有的領域模型與決策文件(`CONTEXT.md`、`docs/adr/`),對使用者的開發計畫進行嚴格的壓力測試。當發現使用者的術語或設計與既有文件衝突時會立即指出,並隨共識即時更新文件。
⚡ 觸發條件
- 當使用者想要對照專案既有術語表與架構決策,對計畫進行嚴格的壓力測試時
- 當使用者提及 'grill with docs' 時
📝 範例與情境說明
當發現使用者所講的「帳戶」概念模糊時進行挑戰:
「您的術語表定義 'Customer' 與 'User' 是不同實體,您指的 'Account' 是指哪一個?我們應該修正 CONTEXT.md 以保持術語精確。」
💡 中文功能說明
提供一整套用於配置環境、同步大腦數據與發佈程式碼的自動化部署與維運技能組。包含了 devex-review、unfreeze、ship、sync-gbrain、skillify 等子工具。
⚡ 觸發條件
- 當需要進行環境初始化、自動化代碼 ship(發佈)、同步 gbrain 狀態時
- 管理瀏覽器 Cookie 或部署設定時
📝 範例與情境說明
自動化執行 ship 操作:執行建置、執行單元與整合測試、確認代碼無誤後合併分支並自動發佈推播通知。
💡 中文功能說明
將目前對話的完整脈絡、已完成的工作、待辦事項與當前系統狀態,高度壓縮整理為一份標準的 Markdown 移交文檔,使下一個接手的 Agent 能瞬間進入狀況,實現無縫任務交接。
⚡ 觸發條件
- 當使用者需要結束當前會話、移交任務,或準備更換協作 Agent 時
- 提及 'handoff' 或任務交接時
📝 範例與情境說明
在專案目錄下生成一個包含 # Context(背景)、# Completed(已完成)、# Next Steps(下一步)與 # Open Questions(待解決問題)的 Markdown 移交文件。
💡 中文功能說明
根據專案的 `CONTEXT.md` 領域術語與 ADR 架構決策,尋找程式碼庫中可深化與優化的重構機會。主要著眼於消除緊密耦合、提升模組邊界清晰度與程式碼的可測試性。
⚡ 觸發條件
- 當使用者想要改善架構、進行代碼重構、整併高度耦合模組或提高程式碼的可測試性與可讀性時
- 提及 'improve architecture' 時
📝 範例與情境說明
分析現有 API 呼叫鏈,提議將多個緊密耦合的底層 DB 操作整併至統一的 Repository 分層中,並新增單元測試的 mock seam。
💡 中文功能說明
將測試檔案中的手動類型斷言(`as`)遷移至 `@total-typescript/shoehorn`。此舉能確保測試資料的安全與強型別約束,避免因強制斷言造成的隱式測試錯誤。
⚡ 觸發條件
- 當使用者提到 'shoehorn'、想在測試中取代 'as' 斷言或需要建構部分測試資料時
- 提及 TypeScript 測試重構時
📝 範例與情境說明
將測試程式中的 const fakeUser = { id: 1 } as User 遷移改寫為 const fakeUser = shoehorn({ id: 1 }),確保未填欄位能獲得安全的 TypeScript 輔助。
💡 中文功能說明
提供 Google NotebookLM 的程式化互動介面與指令,引導建立與管理筆記本、新增來源(網址、YouTube、雲端硬碟),並自動生成 Podcast 音訊、摘要報告、心智圖、字卡等高價值資產。
⚡ 觸發條件
- 當使用者想要與 NotebookLM 進行程式化互動,或提及 'nlm'、'notebooklm' 時
- 當提及 Podcast 生成(audio overview)或自動化文檔研究時
📝 範例與情境說明
匯入多個專案文件與開發文檔,自動生成一個英語雙人對話的 Podcast 音訊總覽檔案,並同步產出結構化心智圖與重點測驗題。
💡 中文功能說明
在投入正式實作前,快速開發一個暫時性、可運行的原型(例如終端機 App 或多套可切換的 UI),用於快速驗證設計、梳理狀態機邏輯並收集使用者反饋,避免過早進行無效的代碼堆疊。
⚡ 觸發條件
- 當使用者說 'prototype this'、'let me play with it'、'try a few designs' 時
- 想在確認最終方案前驗證資料模型或 UI 佈局選項時
📝 範例與情境說明
在單一頁面路由下設計 3 套不同佈局的 Dashboard UI,讓使用者點擊按鈕直接切換,快速比對不同設計的易用性。
💡 中文功能說明
自動化建立標準的教學教材目錄結構,包含章節說明、練習問題(problem)、標準解答(solution)與概念解釋檔案(explainer),並確保該結構能順利通過 lint 檢驗。
⚡ 觸發條件
- 當使用者想要腳手架化練習教材、建立練習 Stub 或設置全新教學課程章節時
- 提及 'scaffold exercises' 時
📝 範例與情境說明
自動建立 /exercises/01-basics,並在該目錄下生成 problem.ts(待挖空作答)與 solution.ts(滿分標準答案)及測試檔案。
💡 中文功能說明
在專案根目錄中配置 `AGENTS.md` / `CLAUDE.md` 及 `docs/agents/` 目錄。此設定能告訴協作的各類開發技能:本專案使用何種 Issue 追蹤器(GitHub 或 Markdown 檔案)、triage 分類標籤、以及架構文件的儲存位置。
⚡ 觸發條件
- 在首次使用 to-issues、triage、tdd、diagnose 等專業技能之前
- 當這些技能因為缺乏專案 Issue tracker 資訊而無法正常運作時
📝 範例與情境說明
掃描當前專案,產生 AGENTS.md 檔案並標註:「本專案使用 GitHub Issues 作為追蹤器,優先 triage 標籤為 'bug' 與 'architecture'」。
💡 中文功能說明
在 Repo 中安裝與配置 Husky 與 lint-staged,整合 Prettier 程式碼格式化、TypeScript 類型檢查及自動單元測試。確保每次程式碼提交前都符合代碼品質規範。
⚡ 觸發條件
- 當使用者想加入 pre-commit hook、設定 Husky 或在 commit 前強制執行檢驗時
- 提及 'pre-commit' 時
📝 範例與情境說明
當使用者執行 git commit 時,背景自動針對本次變更的檔案執行 prettier --write 與 tsc --noEmit,確認格式與強型別無誤後才允許完成提交。
💡 中文功能說明
遵循嚴格的「紅燈-綠燈-重構」循環進行測試驅動開發。堅持「測試先行」原則,先撰寫會失敗的測試,再編寫剛好能通過測試的最簡程式碼,最後進行重構優化,保證程式碼的高穩定度與低耦合度。
⚡ 觸發條件
- 當使用者提及 'tdd'、'red-green-refactor',或要求以測試先行方式開發功能/修復 Bug 時
- 要求撰寫整合測試或單元測試覆蓋率時
📝 範例與情境說明
先寫一個會失敗的計算折扣邏輯測試 -> 撰寫剛好能通過測試的最簡折價程式碼 -> 重構代碼消除重複,並隨時執行測試確保無 Regression。
💡 中文功能說明
採用垂直切片(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: 整合促銷折價計算。
💡 中文功能說明
將當前對話中的背景討論與功能共識,整理成一份專業且結構完整的 PRD(產品需求文件),並自動發佈至專案的 Issue 追蹤系統中供後續開發參考。
⚡ 觸發條件
- 當使用者要求從目前的對話脈絡生成 PRD(產品需求文件)時
- 提及 'to prd' 時
📝 範例與情境說明
自動收集討論中的 User Stories(使用者故事)、非功能性需求與核心業務邏輯,生成一份格式嚴謹的 Markdown PRD 檔案。
💡 中文功能說明
透過 triage 角色與嚴格的狀態機,對專案的待處理 Bug、功能提案或使用者反應進行審查、核實、標籤分類與分流指派,為開發團隊準備乾淨且具備重現步驟的工作項。
⚡ 觸發條件
- 當使用者想分類 Issues、處理 incoming bugs、指派工作,或管理 Issue 生命週期時
- 提及 'triage' 或整理 issue tracker 時
📝 範例與情境說明
將新開的 bug ticket 標註為 triage:needed,確認其有完整重現步驟後,將狀態流轉為 status:accepted,並標記複雜度與對應 label。
💡 中文功能說明
引導開發出結構正確、支援漸進式資訊揭露(progressive disclosure)並打包有輔助資源(如 script、範例)的全新 Agent Skill,用以擴展 Agent 的工具箱。
⚡ 觸發條件
- 當使用者想要建立、撰寫或建構一個新的 Skill 來擴展 Agent 能力時
- 提及 'write a skill' 時
📝 範例與情境說明
在 .gemini/skills/ 下建立包含符合 YAML 格式的 SKILL.md、/scripts 輔助指令以及 /examples 範例的完整技能結構。
💡 中文功能說明
當遇到陌生代碼或複雜系統時,引導 Agent 暫時抽離當前檔案的局部實作細節,提供更廣泛的上下文、繪製依賴關係圖或高層次的系統全局視角,幫助理清整體架構定位。
⚡ 觸發條件
- 進入不熟悉的代碼區塊、感到迷失,或想理解目前模組在整個專案中的角色與定位時
- 當使用者提及 'zoom out' / 'zoom-out' 或需要全局 context 時
📝 範例與情境說明
跳出單一實體類別定義,為使用者繪製整個 ordering 微服務的架構模型,並說明目前元件在非同步訊息處理鏈中的位置。