前言¶
在 MDF(單據頁面)上做擴展腳本時,常見問題是規範分散、接口約定和頁面生命週期容易記混,對話式編碼助手也容易按通用前端習慣生成與平臺不一致的代碼。把平臺側約定寫進 Skill,可以在相關任務裏固定上下文,減少反覆說明。
下面介紹 SkillHub 上的社區 Skill test-skill(@user_be70aa17/test-skill)。本文事實來自 SkillHub 公開頁面、官方安裝說明,以及通過 skillhub install 拉取到的 1.0.0 包內 SKILL.md。
這是什麼¶
test-skill 在 SkillHub 的中文摘要爲:MDF 擴展腳本開發;當用戶要對 MDF 單據頁面做擴展開發時使用本 skill。
- 發佈標識:
@user_be70aa17/test-skill,當前展示版本 v1.0.0(changelog 爲 Initial release)。 - 來源:社區發佈(
source: community),維護方爲 SkillHub 用戶 user_be70aa17。 - 分類:主類 dev-programming;子類標籤包含「前端開發」「腳本工具」。
- 官方入口(頁面可訪問):https://skillhub.cn/skills/user_be70aa17/test-skill
任務線索中的 API 路徑https://api.skillhub.cn/user_be70aa17/test-skill在 GET 請求下未返回可用正文(HTTP 405),安裝與下載實際走 SkillHub CLI 與api.skillhub.cn的 download 接口。
Skill 包遵循通用 SKILL.md 格式:Agent 讀取該文件中的說明與示例,在匹配場景下按其中約束作答。
核心功能¶
以下分「平臺摘要」與「包內實際內容」說明,避免把未覈實的能力寫進正文。
SkillHub 摘要(listing)¶
SkillHub 對 test-skill 的 summary_zh 僅一句定位:MDF 擴展腳本開發,面向 MDF 單據頁面擴展開發 場景。頁面未提供獨立的 overviewMd 長文說明。
安裝包內 SKILL.md(v1.0.0)¶
通過官方 CLI 安裝後,SKILL.md frontmatter 爲:
---
name: 超級厲害的skill
description: 超級厲害的skill
homepage: https://summarize.sh
---
正文標題爲「企業版本測試」,並包含 SMS 短信驗證碼 相關 HTTP 接口說明(例如 POST /api/v1/auth/sms/send、請求體字段 phone、常見錯誤碼等),以及指向 javascript:alert('XSS') 的 Markdown 鏈接。
因此:當前版本包內文檔與 SkillHub 中文摘要在主題上不一致。若你的目標是 MDF 擴展開發,啓用前應打開本地 SKILL.md 自行覈對是否與預期一致;不要把摘要自動等同於包內全部指令。
平臺側統計與安全(查閱 SkillHub 頁面嵌入數據)¶
截至編寫時從 SkillHub 技能頁 SSG 數據可見:
| 項 | 值 |
|---|---|
下載量 downloads |
1190 |
安裝量 installs |
1 |
| 版本數 | 1 |
標籤 requires_api_key |
false |
SkillHub 展示了兩份安全掃描結論(僅供參考):keen 爲「安全,無風險」;sanbu 爲「可疑,存在潛在風險」。包內存在可疑腳本類鏈接時,應在生產或敏感倉庫中謹慎啓用,並查看頁面提供的報告鏈接。
線索中的「評分 99306」「下載 715 次」未在本次打開的 SkillHub 頁面 JSON 中找到對應字段;正文以頁面展示的 downloads: 1190 與分類 dev-programming 爲準。
安裝與啓用¶
安裝流程以 SkillHub 官方文檔爲準:https://skillhub.cn/install/skillhub.md
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝(文檔推薦):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝 test-skill 到當前 Agent 的 skills 目錄¶
文檔要求 必須 使用 --dir 指向當前 Agent 識別的 skills 目錄,否則默認落在 ./skills/ 可能不會被加載。
skillhub install @user_be70aa17/test-skill --dir <skills 目錄>
常用路徑(摘自官方安裝說明):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
安裝成功後 CLI 會提示類似:Installed: @user_be70aa17/test-skill -> <目錄>/@user_be70aa17/test-skill。
也可將官方頁面給出的提示詞交給支持 Skill 的 Agent,讓其按 skillhub.md 完成安裝:
請根據 https://skillhub.cn/install/skillhub.md,安裝
@user_be70aa17/test-skill。
安裝或更新 skills 後,按你所用 Client 的要求重啓或刷新 Agent,以便加載新 Skill。
典型用法¶
SkillHub 摘要指向 MDF 單據頁面擴展開發;在摘要與包內文檔一致的前提下,典型用法是:在 Cursor、Claude Code 等已配置 skills 目錄的環境中啓用本 Skill,並在對話中明確 MDF 單據、擴展點與現有腳本約束,由 Agent 結合 SKILL.md 生成或修改擴展腳本。
可復現示例(來自當前包內 SKILL.md,與 MDF 無關,僅作接口說明樣例):發送短信驗證碼的請求體寫法如下。
中國大陸 11 位手機號:
{
"phone": "13800138000"
}
帶國際區號的港澳臺號碼:
{
"phone": "+85212345678"
}
對應接口路徑爲:
POST /api/v1/auth/sms/send
若你實際要做 MDF 擴展,應以平臺官方 MDF 開發文檔爲準,並確認後續版本是否會在 SKILL.md 中補齊 MDF 專用章節。
適用場景與注意¶
更適合誰
- 已在 SkillHub 檢索到本 Skill,且任務描述與 MDF 單據頁面擴展 相關(以 SkillHub 摘要爲準)的開發者。
- 願意通過 SkillHub CLI 管理 skills、並能接受社區未認證作者(
isAuthorVerified: false)包的風險自查。
限制與注意
- 摘要與包內容不一致:v1.0.0 的
SKILL.md以企業版測試與 SMS 接口文檔爲主,frontmatter 的 name/description 也與「test-skill / MDF」摘要不符,使用前務必本地閱讀全文。 - 安全掃描:sanbu 標記爲可疑;包內含
javascript:類鏈接,不要在不可信環境直接讓 Agent 執行其中外鏈或腳本。 - 未認領:
claim_state爲 unclaimed,上游倉庫鏈接爲空,問題反饋與版本演進需通過 SkillHub 與作者 handle 跟進。 - 統計隨頁面更新:下載量等以 SkillHub 技能頁實時數據爲準,與第三方摘錄可能不同。
結尾¶
test-skill 在 SkillHub 上被標註爲面向 MDF 單據頁面擴展腳本 的 dev-programming 類 Skill,可通過 skillhub install @user_be70aa17/test-skill 安裝到 Cursor 等工具的 skills 目錄。啓用前請覈對 SKILL.md 與摘要是否一致,並關注平臺安全掃描結果。
- 技能頁:https://skillhub.cn/skills/user_be70aa17/test-skill
- 安裝說明:https://skillhub.cn/install/skillhub.md
- 線索中的 API 頁:https://api.skillhub.cn/user_be70aa17/test-skill