create-verification-skill | 建立實際操作的驗證技能
本頁以 pstack-claude 0.9.126 為基準。這是教學文件，不會在本次寫作中建立或執行驗證技能。
定位與適用情境
測試通過，不代表代理知道如何啟動應用程式、按下按鈕並留下結果。此技能從儲存庫找出操作方法，產出專案本地驗證技能 (project-local verification skill)，讓下一位代理能按相同步驟操作真實程式。
情境是一個待辦清單網站。團隊已有瀏覽器測試框架 (browser test harness)，卻沒有說明如何用空資料庫啟動、建立待辦，再確認重新整理後仍存在。輸入是專案原始碼、啟動文件與現有測試。輸出是名為 verify 的技能及功能地圖 (feature map)，不是只增加一份測試摘要。
準備
- 提供目標專案或單一套件範圍、允許使用的測試帳號與資料目錄。
- 確認可用的瀏覽器自動化工具、啟動指令及連接埠。不能假設平台自帶瀏覽器控制能力。
- 設定證據保存位置，與執行後可清理的暫存資料分開。若無法同時啟動兩個隔離實例，要明寫只能序列操作。
Claude Code 使用 /pstack:create-verification-skill。Codex 插件技能選單插入 $pstack:create-verification-skill，skills-only 安裝則用 $create-verification-skill。也可使用下方自然語言需求，這不是 slash 指令。
操作步驟
- 先讀專案。 從 README、套件指令、路由與現有測試確認使用者介面、啟動方式、操作工具、可觀察結果及隔離方式。專案無法啟動時先精確回報，不對壞掉的基底編造操作步驟。
- 產生可執行的說明。 Claude Code 的單一專案目標是
.claude/skills/verify/SKILL.md，單體儲存庫 (monorepo) 則放在涉及的套件內。寫入name: verify、有效 description，以及 Launch、Doctor、Drive、Evidence、Cleanup、Helpers。Doctor 必須是唯讀健康檢查，Launch 必須從空資料目錄到可操作狀態。 - 建立功能地圖。 先涵蓋最重要的 3 至 5 個功能。例如建立、完成與篩選待辦。每份文件保留
Sub-features、How to get to it (user POV)、Driving it with <harness>、Gotchas四個 H2，另有 README 索引。操作選擇器必須來自實際介面。 - 照產物重跑一遍。 啟動、健康檢查，操作一個已映射功能。記錄輸入動作、畫面結果及持久化副作用。清理成功或失敗嘗試所建立的程序與暫存狀態，再確認證據仍在指定位置。
- 交接維護入口。 列出已跑過的功能與尚未驗證部分，交給
maintain-verification-skill後續維護。若只在替代環境測試，要列出真實環境仍未驗證的設定步驟。
可直接使用的提示詞
用 pstack:create-verification-skill 為這個待辦清單網站建立 verify 技能。
先讀專案啟動文件、路由與現有瀏覽器測試，不要猜測選擇器。
列出預計新增的檔案及隔離方式，再在我允許的測試資料範圍內操作。
功能地圖先涵蓋建立、完成、篩選待辦。
實際走一次建立待辦並重新整理的流程，保存動作與結果的證據。
清理只處理這次建立的實例和暫存狀態，證據必須保留。
無法啟動、缺帳號或缺控制工具時回報阻礙，不要宣稱已驗證。
不要提交、推送、部署或連線正式服務。預期結果與驗收
- 另一位代理只讀產物就能知道如何啟動、判斷可操作狀態、執行操作與清理。輔助腳本若有提供，必須可執行，且文件列出呼叫方式。
- 至少一個功能有真實操作與副作用證據。只有最後一張截圖，不能證明資料確實經由使用者路徑建立。
- 清理後證據仍存在。沒有實際跑過的產物只能稱為草稿，不能稱為已交付的驗證技能。
限制與權限
此技能會新增專案檔案，也可能啟動程序、寫測試資料。這些權限需先界定，不包含安裝未核准依賴、修改正式資料或提交 Git 的授權。不要按程序名稱大量終止程序，只停止本次啟動的實例。
原文的輸出路徑屬於 Claude Code。Codex 應改用其專案技能位置，不能照抄 .claude/skills/。其他平台要先確認技能探索位置與操作工具。名稱叫 dry-run 不代表無副作用，仍須觀察檔案、網路及 Git 參照是否改動。一次成功也不表示功能地圖中的所有功能都已驗證。