maintain-verification-skill | 維護功能地圖與操作證據
本頁以 pstack-claude 0.9.126 為基準。教學中的維護流程不會在本次文件寫作中執行。
定位與適用情境
驗證技能 (verification skill) 會隨產品變更過期。此技能逐一檢查功能地圖 (feature map) 的來源與真實操作，不因文件看來正確就省略實測。
情境是待辦網站把「完成」按鈕換成核取方塊。既有 verify 技能還在點舊選擇器，功能地圖也漏了新篩選入口。輸入是既有技能目錄、功能索引與目前產品原始碼。任務是修正驗證資料，不是順手修產品。
準備
- 找出具有啟動、操作說明與功能地圖的專案技能。多個候選要先指定目標。找不到就停止，改用
create-verification-skill。 - 準備可隔離的測試資料、操作工具及證據位置。長時間伺服器與短命令列程式有不同啟動模型，依目標技能決定。
- 確認平台能否執行每功能一位唯讀來源讀取者的平行工作。這些讀取者不能同時操作同一個應用程式。
Claude Code 使用 /pstack:maintain-verification-skill。Codex 插件選單插入 $pstack:maintain-verification-skill，skills-only 使用 $maintain-verification-skill。Codex 的平行來源讀取對應 spawn_agent，需確認主機有提供該工具。
操作步驟
- 核對索引。 讀取功能 README 與相鄰文件，找出缺漏、重複與失效項目。不要另造一份無人維護的盤點資料取代原索引。
- 逐功能查來源。 每份功能文件交由一位唯讀讀取者，回報功能摘要、來源入口、疑似漂移及一份操作配方。協調者收齊結果，再核對被指出的漂移。新增入口必須有具體來源路徑支持。
- 實際走完所有功能。 由協調者單獨操作。第一次操作、異常後及每個獨立短命令列工作階段都先做 Doctor。健康程序中的介面若已卡死，重設到已知狀態或重啟，不盲目重試。保存每個功能的證據。
- 分類再修。 舊按鈕名稱是文件漂移 (doc drift)，能用但腳本點不到是操作工具缺口 (harness gap)，真正無法完成待辦則是產品缺口 (product gap)。只改驗證技能自己的說明、地圖及腳本。修過腳本要重新實測。Doctor 本身因技能漂移失效時，修正後依需要重啟，再重試一次。
- 清理與回報。 清理每輪殘留與最後一輪實例，確認證據保留。回報
clean、changed或blocked。只有已證明的修正才適合整理成單一 PR，是否提交仍取決於授權。
可直接使用的提示詞
用 pstack:maintain-verification-skill 維護這個待辦網站既有的 verify 技能。
只允許修改該技能目錄內的文件、功能地圖與自有操作腳本。
逐功能查來源，再由單一協調者實際操作每個功能。
重點檢查完成待辦的新核取方塊，以及篩選功能的新入口。
每份功能列出來源、操作證據或無法到達的具體前置條件。
文件漂移與產品故障要分開，不要改產品程式讓流程通過。
清理執行殘留但保留證據。回報 clean、changed 或 blocked。
本輪不建立分支、不提交、不推送、不開 PR。預期結果與驗收
clean必須代表每個功能都有來源查核與實際操作覆蓋，且沒有值得交付的修正。只有讀文件不能判為 clean。changed應能逐項對照修改理由與重新操作的證據。產品回歸另列為發現，不混入文件修正。- 功能若因帳號權限、作業系統或外部狀態無法到達，只有列出具體前置條件與嘗試路徑才可記為
verified-unreachable。這不代表該功能成功。 blocked應列出未完成覆蓋的功能及原因。不能以跳過難測功能換取綠色結論。
限制與權限
原文要求平行來源波次與協調者實測。工具不足時應揭露差距，不把單人閱讀稱為已完成平行查核。Codex 的專案技能位置不同於 Claude Code 的 .claude/skills/verify/，依平台對應處理。
修改範圍只限目標驗證技能目錄。來源讀取者不能寫檔或操作程式。程序、暫存資料與證據有不同生命週期，失敗輪次也必須清理，不能誤停共用實例。Git 暫存 (stage)、提交 (commit)、推送 (push) 與開 PR 都是額外寫入動作，不因技能提到交付就自動獲准。