Karakuri
← 所有 Skills

外部精選 · 單一 Skill

Skill Doctor:從真實對話檢查 Agent Skills

了解 Skill Doctor 如何分析本機 Agent 對話、評估已安裝技能的使用情況,並產生可審閱的改善草案與報告。

用途分類
程式開發
適用平台
Warp · Claude Code · Codex · Pi · Grok Build · ZCode · Hermes
原作者/維護者
Warp
授權
MIT
本站收錄
介紹更新
收錄後尚未更新
來源查核
查看原始專案 ↗

用途

你可能安裝了不少 Agent Skills,卻不知道它們是否在需要時被使用,也不知道哪些工作仍讓助理反覆試錯。Skill Doctor 是 Warp common-skills 中的一份 Skill:它讀取指定範圍內的本機 Agent 對話,評估工作過程,然後產生報告與附有對話依據的技能修改草案。原始 Skill列出完整流程。

它的綜合分數由五項構成:效率、程式碼品質、流程遵循、回答冗長度與 Skill 覆蓋率。前四項依對話評分,覆蓋率看抽樣對話中是否偵測到已安裝 Skill;五項的權重並不相同。報告會整理三個具體問題,並只根據評分失敗的對話提出修改建議。這是上游文件描述的評估方法,不是本站對任何 Agent 的實測成績。

適用情境

若你維護專案或全域 Skills,想知道 Skill 是否在需要時沒有觸發、前置檢查是否缺漏,或相同錯誤為何一再發生,可以用它整理近期對話的線索。你可選目前儲存庫、指定專案或所有本機對話,也可選擇只評估專案 Skills,或連同全域 Skills 一起評估。

我們認為它較適合有本機對話紀錄、能審閱原始對話與修改草案的人。報告能指出值得追查的問題,不能取代你對需求、程式碼和團隊規則的判斷;這是本站的使用建議。

使用範例

假設團隊有一份「提交前檢查」Skill,卻常在對話末尾才發現測試沒跑。可以請支援的 Agent 使用 Skill Doctor 評估這個儲存庫的近期對話與專案 Skills。它會先詢問對話和技能的範圍,再從本機紀錄抽樣、依四項規則評分,並計算 Skill 覆蓋率。若失敗對話顯示那份 Skill 根本沒觸發,報告可能建議調整觸發描述;若步驟漏掉檢查,則可能提出具體修訂與 diff。

這是假設例子;本站沒有用該團隊資料執行 Skill Doctor。實際建議須能追溯到失敗對話的具體片段;原始 Skill 不要求把泛泛的最佳實踐直接加進技能檔。

限制

程式碼品質只在對話顯示程式碼變更時評分;證據不足會標為 insufficient_evidence,不強行算成失敗。若所選範圍沒有近期可評的對話,流程會停止,提示擴大時間窗口或更換專案。評分依抽樣紀錄與規則而來,不能證明 Skill 對所有任務有效,也不能保證修改草案正確。

依原始 Skill 的規定,對話與技能內容留在本機,暫存目錄保存報告與提議版本,建議階段不直接改寫真正的 Skill 檔案。只有報告可由使用者選擇分享,分享前仍須自行檢查內容。這描述的是該 Skill 的預期流程,不代表本站對你的執行環境或後續分享提供安全保證。官方支援環境清單也會變動;若目前執行的 Agent 無法確認為支援環境,Skill 應在讀取對話前停止。

安裝方式

官方 README使用 skills CLI 安裝共用 Skills。以下依單一 Skill 的指令格式,以 Warp 全域安裝為例;這裡只展示命令,不會執行:

npx skills@latest add warpdotdev/common-skills --skill skill-doctor --agent warp --global

在其他環境使用時,先確認支援環境文件與 skills CLI 的對應代理選項。Skill Doctor 需要能讀取該環境的本機對話紀錄;安裝 Skill 本身不會產生可評的歷史對話。原始 Skill 也要求先選對話與技能範圍,再開始收集。

參考來源

回 Skills 目錄