前言¶
在 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