test-skill:面向 MDF 單據頁面擴展開發的 Agent Skill

前言

在 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)包的風險自查。

限制與注意

  1. 摘要與包內容不一致:v1.0.0 的 SKILL.md 以企業版測試與 SMS 接口文檔爲主,frontmatter 的 name/description 也與「test-skill / MDF」摘要不符,使用前務必本地閱讀全文。
  2. 安全掃描:sanbu 標記爲可疑;包內含 javascript: 類鏈接,不要在不可信環境直接讓 Agent 執行其中外鏈或腳本。
  3. 未認領:claim_state 爲 unclaimed,上游倉庫鏈接爲空,問題反饋與版本演進需通過 SkillHub 與作者 handle 跟進。
  4. 統計隨頁面更新:下載量等以 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜