前言¶
寫好一個 SKILL.md 只是第一步。技能要上架給別人用,還面臨一系列問題:描述是否清楚、觸發條件是否合理、目錄結構是否規範、示例是否可復現。這些問題靠人工逐項檢查費時且容易遺漏,等到發佈後被用戶反饋才發現,返工成本更高。
下面介紹「技能醫生」這個 Skill,它把技能上架前的質量檢查流程固化成一套可執行的 SOP,面向技能作者,在創建、修改、審查技能時自動觸發。
這是什麼¶
技能醫生(Skill Dr)是一個面向技能作者的質量檢查 Skill,座標 @user_8d4ddd46/skill-dr,由社區作者 user_8d4ddd46 發佈在 SkillHub,當前版本 1.0.9,分類爲 dev-programming。
它解決的問題是:技能在創建、修改、審查階段缺少統一的質量把關。技能醫生把把關動作拆成兩層——一層是可機械執行的格式與結構檢查,一層是按固定 SOP 逐項走的深度診斷,讓作者在上架前就能發現問題。
核心功能¶
根據官方簡介,技能醫生提供兩類能力:
1、一鍵運行 15 項機械檢查。覆蓋技能文件層面的可客觀判定項,一次跑完,不必人工逐項覈對。
2、按 5 個子能力的 SOP 逐項深度診斷。機械檢查之外,再按固定流程對技能的子能力做深度審查,逐項給出診斷結論。
觸發方式:當用戶創建、修改、審查技能時自動觸發,無需手動點名調用。
範圍限定:專爲技能作者設計,不適用於技能使用場景。即它檢查的是技能本身的質量,不參與技能被使用後的運行過程。
安裝與啓用¶
技能醫生基於通用 SKILL.md 格式,通過 SkillHub 分發。本次成稿時官方頁面(https://api.skillhub.cn/user_8d4ddd46/skill-dr 及 https://www.skillhub.cn/skills/user_8d4ddd46/skill-dr)抓取失敗,未能從官方渠道覈實到具體安裝命令。
因此在啓用前,請先打開官方頁面確認安裝方式:
https://www.skillhub.cn/skills/user_8d4ddd46/skill-dr
頁面上的版本號、安裝命令、配置項以官方頁面爲準。本次覈實到的信息如下:
座標: @user_8d4ddd46/skill-dr
版本: 1.0.9
分類: dev-programming
來源: community
標籤: requires_api_key=false
requires_api_key=false 表示該 Skill 不需要額外的 API Key 配置。
關於 Cursor、Codex CLI、Claude Code 的安裝差異,官方資料未分別說明,此處不寫推測內容。
典型用法¶
以下是依據官方簡介還原的典型流程,步驟可復現。
1、編寫或修改技能。按 SKILL.md 格式寫好技能的描述、步驟、示例等內容。
2、讓技能醫生介入檢查。在創建、修改、審查技能的過程中,技能醫生會自動觸發:
觸發場景:創建 / 修改 / 審查技能
3、先看機械檢查結果。技能醫生一鍵運行 15 項機械檢查,把格式、結構等可客觀判定的問題一次性列出來,作者按清單逐項修復。
4、再按 SOP 做深度診斷。機械檢查通過後,技能醫生按 5 個子能力的 SOP 逐項深度診斷,對每個子能力給出診斷結論,作者據此補強薄弱環節。
5、重複檢查直到通過。修復後再觸發一次審查,確認 15 項機械檢查和 5 項 SOP 診斷均無問題,再進入上架環節。
適用場景與注意¶
適合誰:
- 技能作者。正在創建新技能、修改已有技能、或準備上架前做審查的人。
- 需要統一質量標準的場景。團隊內多人維護技能時,用同一套機械檢查和 SOP 口徑把關。
不適合的場景:
- 技能使用場景。技能醫生檢查的是技能本身的質量,不參與技能發佈後的運行和使用。
注意:
- 官方簡介沒有給出 15 項機械檢查和 5 個子能力的具體清單。清單內容以技能醫生自身的 SKILL.md 爲準,本文不做推測。
- 官方資料未提供具體安裝命令和在各編輯器中的啓用方式,本文未覈實到的內容一律不寫,請以官方頁面爲準。
結尾¶
技能醫生的價值在於把上架前的質量把關拆成「機械檢查 + SOP 診斷」兩層,讓技能作者在創建、修改、審查階段就能按固定流程發現問題,而不是等發佈後再收反饋。如果你正在維護 SKILL.md 格式的技能,值得在上架前跑一遍。
官方地址:https://www.skillhub.cn/skills/user_8d4ddd46/skill-dr