cpp-testing

cpp-testing 技能概覽

cpp-testing 技能能幫你用一套實務導向的流程來撰寫、執行與除錯 C++ 測試，核心圍繞 GoogleTest/GoogleMock、CMake 與 CTest。它最適合需要補 coverage、穩定 flaky tests，或為現代 C++ 程式碼建立可重複使用測試框架的人，不適合拿來做一般性的 C++ 功能開發。

cpp-testing 適合做什麼

當工作重點是讓測試更可靠、也更有用時，就該用 cpp-testing 技能：新增單元測試、整合測試、回歸覆蓋、失敗測試分流，或使用 sanitizer 進行除錯。它的主要價值在於幫你做測試設計與執行上的決策支援，尤其是在 mocks、fakes、test fixtures 與以 CTest 驅動的執行方式之間需要取捨時。

cpp-testing 適合誰使用

這個 cpp-testing skill 很適合 C++ 開發者、build system 負責人，以及在已經使用或可採用 GoogleTest/CTest 的 repository 中工作的 agent。當任務描述很模糊、但明顯和測試有關時，它特別好用，例如「修掉這個 flaky suite」、「補上這個模組的 coverage」或「讓 CI 更早抓到這個 bug」。

cpp-testing 有什麼不同

和通用提示詞相比，cpp-testing 提供的是更聚焦的 test-first 工作流程：什麼時候該用、什麼時候不該用、測試要怎麼組織，以及如何用對 CI 友善的方式執行。這讓 cpp-testing guide 相較於泛泛的「寫測試」提示更可操作，也更適合 Test Automation，因為它會偏向 isolation、discoverability 與最小化、可重現的驗證方式。

如何使用 cpp-testing 技能

安裝 cpp-testing

使用以下指令安裝 cpp-testing 技能：

npx skills add affaan-m/everything-claude-code --skill cpp-testing

接著把 agent 指向你的 C++ 專案所在的 repository。當 agent 能先檢查實際的 build 檔案、測試結構與既有慣例，再提出修改建議時，這個技能的效果最好。

先讀對的檔案

先從 SKILL.md 開始，再視情況查看 README.md、AGENTS.md、metadata.json，以及任何存在的 rules/、references/、resources/ 或 scripts/ 資料夾。在這個 repository 裡，SKILL.md 是唯一的來源檔，所以第一步的流程很單純：先讀技能內容，再把建議對照到你自己的 CMakeLists.txt、測試目錄與 CI 設定。

給它可執行的任務提示

好的 cpp-testing usage 提示詞，會明確寫出被測程式碼、失敗模式、想要的測試層級，以及任何限制。例如：「為 Parser::parseConfig() 補上 GoogleTest coverage；測試要保持 deterministic，避免依賴 filesystem，並使用 CMake/CTest，讓 suite 可以在 CI 上執行。」這樣就能給技能足夠脈絡，去判斷該用單元測試、整合測試、mocks 還是 fixtures。

遵循測試工作流程

把這個技能當成 red-green-refactor 的助手來用：先定義行為，再撰寫或調整會失敗的測試，接著用最小的程式碼變更讓測試通過，最後再整理測試的結構。處理 flaky tests 時，先請它判斷可能的非決定性來源，再用 CTest 把執行範圍縮小到失敗的單一測試，之後再擴回整個 suite。若是做診斷，也要一併說明你想要的是 assertions、logging、sanitizer 指引，還是 CI gating 建議。

cpp-testing 技能 FAQ

cpp-testing 只適用於 GoogleTest 專案嗎？

不是。GoogleTest/GoogleMock 是預設契合度最高的選擇，但底層的 cpp-testing 技能同樣適用於需要結構化測試執行的 CMake/CTest 型 C++ 專案，即使周邊 repository 還搭配了其他工具也沒問題。如果你的專案不是 C++，或根本沒有明確的測試邊界，那它大概就不是對的技能。

什麼時候不該用 cpp-testing？

如果只是做功能實作，卻沒有任何測試變更；如果是和測試無關的大範圍重構；或如果不是 C++ repository，就不要用它。當任務主要是效能調校，而且沒有測試失敗、回歸問題或 correctness check 可作為依據時，cpp-testing guide 也不太適合。

這比一般提示詞更好嗎？

通常是，前提是目標在於提升測試執行品質，而不只是生成程式碼。cpp-testing skill 會針對 isolation、測試佈局與 CTest 使用加上明確的意見型指引，當 agent 必須判斷測試該怎麼組織、或失敗該怎麼重現時，就能少很多猜測。

對初學者友善嗎？

是的，只要你能描述被測程式碼，以及你想驗證的行為。這個技能在使用者能提供具體範例、失敗的測試名稱，或一個小型 CMake target 時特別有幫助；如果需求只有「把測試變好」，它就沒那麼有效。

如何提升 cpp-testing 技能

提供更精準的輸入

要讓 cpp-testing 的輸出更好，最有效的方法就是一開始就提供明確的目標、預期行為與限制。好的輸入會提到 class 或 function、需要哪一種測試，以及任何硬性條件，例如「不能用網路」、「不能 sleep」、「必須在 CTest 下執行」或「測試必須保持 hermetic」。

要求最小且可驗證的變更

當你要求的是窄範圍的第一輪產出時，cpp-testing skill 通常表現最好：一個會失敗的測試、一個 bug fix、一次 sanitizer 執行，或一組可直接上 CI 的命令序列。這樣產出的 diff 會更清楚，也能降低把測試框架做得過度複雜的風險。

留意常見失敗模式

最常見的失敗模式是過度 mock、隱藏的共用狀態，以及本機會過、但在 CTest 或 CI 下會失敗的測試。如果第一次結果不夠好，可以補上真實的測試進入點、目前的 fixture 設定，以及觀察到的失敗輸出，讓技能能根據證據推理，而不是靠假設。

在第一次執行後持續迭代

把第一次結果拿來收斂範圍：如果測試太脆弱，就要求更隔離的 fixture；如果測試太淺，就要求補 edge cases 或回歸覆蓋；如果執行太慢，就要求先跑子集的執行計畫。對 cpp-testing for Test Automation 來說，這種反覆迭代的流程往往正是品質提升最大的來源。