前言¶
寫一個 AI skill,最難的不是把它跑起來,而是動工之前不知道該做成什麼樣,收工之後不知道該不該上線。description 寫得寬,agent 什麼任務都來觸發;寫得窄,真正該用的時候又不進來。評審這類東西時,也沒有一個穩定的說法,往往憑感覺改兩行就交差。
skill coach 把這件事拆成一套五步法:事前給方向,事後查好壞。判斷結果落到三種之一——可以放心用、先修再用、乾脆別要。
這是什麼¶
skill coach 是一個面向 AI skill 的設計與評審技能,座標 @user_dc515faf/skillcoach,由社區開發者 user_dc515faf 發佈並維護,當前版本 1.0.1,分類 ai-agent。
它只做一件事:圍繞 skill 本身給方向、做審查、做優化。技能基於通用 SKILL.md 格式,不依賴額外的 API key(標籤 requires_api_key=false)。在 SkillHub 上評分爲 100000,下載 1120 次,安裝數顯示爲 0。
核心功能¶
支撐這套方法的是 R-V-C-E 心智模型,按順序走四步:風險(Risk)→ 價值(Value)→ 工藝(Craft)→ 證據(Evidence)。風險預判這件事該不該存在,價值判斷它解決什麼問題,工藝決定觸發邊界畫在哪、確定性靠什麼,證據回答怎麼驗證它真的有效。
它提供兩種模式,對應事前和事後兩個階段。
1、設計模式。用於用戶想新建一個 skill、或者問”這個 skill 該怎麼設計 / 怎麼做 / 做成什麼樣”時。做法是像產品經理一樣用 R-V-C-E 反向給設計方向:先做風險預判,判斷這個 skill 該不該存在;再畫觸發邊界,明確什麼任務進來、什麼任務不進來;然後確定確定性靠什麼保證;最後定怎麼驗證。產出的是可執行的設計方案,不是籠統的建議。
2、評審模式。用於評審、檢查已有 skill 好不好的時候。包括優化 description 或觸發條件、判斷該不該上線或合併、分析 skill 之間會不會互相搶觸發,以及回答”這個 skill 寫得怎麼樣 / 能不能用 / 有什麼問題”。
觸發方式支持中英文混合的自然表達,常見觸發詞包括:做一個 skill、這個 skill 該怎麼設計、新建 skill、審查 skill、評審 skill、檢查 skill、優化 skill、skill 質量、skill review、這個 skill 好不好、skill 該不該上、skill 觸發不準、skill 互相搶。
安裝與啓用¶
skill coach 是標準 SKILL.md 格式的技能,本地啓用把技能目錄放進項目的 skill 目錄,由 agent 在會話中按觸發詞自動調用即可。例如 Cursor 放在 .cursor/skills/,Claude Code 放在 .claude/skills/,Codex CLI 按其技能目錄約定放置;安裝後在會話裏直接說”做一個 skill”或”評審這個 skill”即可喚起。
它不需要配置 API key,也沒有額外的環境變量要填。
典型用法¶
下面三個例子都來自技能自身的觸發詞約定,可以直接復現。
新建 skill 前先要方向:
我想做一個把 PDF 表格抽成 Excel 的 skill,這個 skill 該怎麼設計?
skill coach 會進入設計模式,按 R-V-C-E 先判風險(該不該存在、會不會和已有 skill 搶任務),再定觸發邊界,最後給出驗證方式。
寫完之後做質量把關:
審查這個 skill,看看觸發條件準不準
此時進入評審模式,檢查 description 的觸發表述、確定性來源和驗證證據,結論會落在”放心用 / 先修再用 / 乾脆別要”之一。
排查多個 skill 互相干擾:
我的幾個 skill 之間會不會互相搶觸發?
這類問題直接指向評審模式中的觸發衝突分析,適合在上線或合併之前做一遍。
適用場景與注意¶
適合兩類人。一是正在新建 skill、卡在設計階段拿不準方向的開發者;二是手上已有 skill、準備上線或合併、想先做一遍質量檢查的人。
有幾條邊界要留意。
第一,如果對”要做什麼”本身還沒想清楚,先不要急着上 R-V-C-E。技能自身給出的銜接方式是:先用 grill 理清需求,再用本技能給設計方向。
第二,明確不要用它處理這些場景:與 skill 無關的普通編碼和調試,應該用 debug-session;與 skill 無關的產品或流程設計,應該用 grill;不涉及”某個 skill 該怎麼做或好不好”的一般問答,也不適合。它只評價 skill,不代替調試和需求梳理。
第三,評審結論分三檔,其中”乾脆別要”是有意識的輸出,不是失敗。如果 R 階段判斷風險過高、價值不成立,正確做法是不做,而不是勉強上線再修補。
結尾¶
skill coach 的價值在於把 skill 的設計和評審從憑感覺變成一套可複用的四步判斷:風險、價值、工藝、證據。事前用它定方向,事後用它查好壞,兩種情況下都能拿到明確結論。
官方地址:https://api.skillhub.cn/user_dc515faf/skillcoach,SkillHub 頁面:https://www.skillhub.cn/skills/user_dc515faf/skillcoach。