iT邦幫忙

2026 iThome 鐵人賽

0
Claude AI

把 Claude 練成專家:30 天打造可驗證的 Agent Skills系列 第 26 篇

Day 27|證據會過期:來源重驗、版本更新與相容性檢查

  • 分享至 

  • xImage
  •  

Day 26 定義了維護與貢獻的責任。今天處理一個不需要有人改程式,也可能讓結果失效的情況:時間經過了。來源到期、外部文件改版、安裝工具更新,都可能讓昨天的驗證不再足以支持今天的宣稱。

本文延續 ticket-source-guard 的教學設計。以下日期、版本與流程都是示意,不表示真實來源已經重驗或專案已經完成相容性測試。

把重驗條件寫成資料

「有空再看」不是可執行的維護規則。先記錄哪些情況會讓證據失去效力,哪些變更需要重新跑案例。

來源證據:到期、撤銷、範圍變更或出現衝突
輸出契約:欄位、狀態或退出方式改變
執行環境:依賴版本、工具權限或安裝路徑改變
文件:範例命令、格式規則或支援範圍改變

這些是本範例的重驗條件,不是所有 Skill 都必須採用的排程。不同來源的有效期也不能憑感覺統一設成一年。

到期不等於證明它是假的

過期的證據不能繼續支撐「目前有效」,但也不能直接改寫成「惡意網站」。分類器應保留原因,讓使用者知道缺的是什麼。

{
  "status": "UNCONFIRMED",
  "reason": "EVIDENCE_EXPIRED",
  "evidence_version": "registry-v4",
  "evaluation_date": "2026-10-08",
  "next_step": "REVALIDATE"
}

這是教學用的輸出契約。UNCONFIRMED 表示沒有足夠的當前依據,不表示授權交易,也不表示已判定來源惡意。不能只改 evaluation_date,卻沿用過期證據的可信結論。

重驗要確認原本的範圍

新的頁面仍然存在,不等於原本的活動、主辦方與購票路徑都沒變。重驗時應核對證據支持的用途與時間,而不只確認 HTTP 回應成功。

原紀錄:來源、取得日期、活動與用途、有效期
新證據:當前內容與取得日期
差異:host、路徑、活動、撤銷或衝突訊息
決定:維持、縮小範圍、撤銷,或待釐清
驗證:相關 fixture 與判斷結果

若沒有足夠的新證據,維持待重驗狀態,不把「暫時查不到變更」當成「已確認沒有變更」。私人來源的存取與公開分享仍要分開處理。

相容性要附環境,不貼空白標章

Agent Skills 規格描述 SKILL.md 與可選的 scripts、references、assets;可選的 compatibility 欄位可說明環境需求。這些格式資訊不會自動證明某個 agent 已經成功執行完整任務。

Vercel skills CLI 的 README 提供安裝、列出與選擇 Skill 的方式。安裝工具能找到檔案,也不代表分類器、權限與任務結果都符合預期。

驗證紀錄(示意)
Skill:固定 commit
安裝工具:實際測過的版本
目標環境:產品、版本、作業系統與依賴
範圍:格式、安裝、script、任務型 eval
結果:通過、失敗、未測
限制:未測部分不宣稱支援

不要為了表格好看,把「未測」改成「應該可以」。外部工具更新後,先比對受影響的介面,再選擇需要重跑的測試;不能只因版號變了,就宣稱所有功能都壞了。

更新紀錄要能回到同一份內容

重驗結論應連到 registry 版本、Skill commit、fixture 與評估日期。Day 24 的發行包紀錄也要跟著更新,避免下載包與最新文件各說各話。

如果新版本改變狀態語義,說明使用者影響與遷移方式;若只是補充同一結論的證據,也記錄來源差異。回退程式版本不會讓已撤銷的來源重新有效,程式與證據必須分開判斷。

今天完成的驗收標準

[ ] 重驗條件明確,不只依賴人工記憶
[ ] 到期、惡意與未知是不同的判斷
[ ] 新證據核對用途與時間,不只確認頁面存在
[ ] 相容性紀錄包含版本、環境、範圍與未測項目
[ ] 更新可追到 registry、commit、fixture 與日期
[ ] 回退程式不會復活撤銷或過期的證據

參考資料
https://agentskills.io/specification
https://github.com/vercel-labs/skills?tab=readme-ov-file

明天預告

Day 28 把一次失敗轉成可重現的事件紀錄與回歸測試,並區分修正、回退與尚未釐清的狀態。


上一篇
Day 26|維護與貢獻的邊界:測試責任、registry 權限與有效文件
下一篇
Day 28|把失敗變成回歸測試:事件紀錄、修正與安全回退
系列文
把 Claude 練成專家:30 天打造可驗證的 Agent Skills 共 29 篇
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言