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
羽毛球分组比赛记分
小程序二维码

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

小夜