前言¶
自研或迭代 Agent Skill 时，常见做法是改完 SKILL.md 就交给模型「试一把」。这样能快速感知效果，但步骤不固定、结论难沉淀，回归时也容易漏项。若希望把「备份、对照规范、分阶段测场景与功能、修完再 bump、出报告」收成一条可重复执行的流水线，skill-function-test 面向的就是这类需求。
这是什么¶
skill-function-test 是 SkillHub 上的社区 Skill，坐标 @user_800d68d6/skill-function-test，当前版本 1.16.1，分类为 dev-programming。官方简介将其定位为技能场景测试套件：按固定顺序走完备份、蓝皮书、配置确认、多阶段测试、修复与版本 bump，最后生成双格式报告并把结论写入 test-report.md。流程由配置驱动，并通过钩子在未满足前置条件时强制阻断，避免跳过关键步骤。
- 官方 API 页：https://api.skillhub.cn/user_800d68d6/skill-function-test
- SkillHub 展示页：https://www.skillhub.cn/skills/user_800d68d6/skill-function-test
- 标签标明：
requires_api_key=false（无需额外 API Key）
核心功能¶
下面介绍官方简介中写明的整条测试链路，各阶段名称以 SkillHub 页面表述为准。
流程概览¶
整体顺序为：
- 备份 — 在改动与测试前保留可回滚状态。
- 蓝皮书 — 对照规范或基准文档，为后续测试提供依据。
- 配置确认 — 核对驱动流程的配置是否就绪。
- S1–S3 场景测试 — 场景维度的分阶段验证。
- D1–D6 功能测试 — 功能维度的分阶段验证。
- S4 执行忠实度 — 对执行与预期一致性的检查。
- 修复 — 根据失败项处理 Skill 或相关产物。
- bump — 在通过或约定条件下提升版本。
- 双格式报告 — 输出两种格式的测试报告。
- 结论写入
test-report.md— 将最终结论落到固定文件名，便于归档与 diff。
设计要点¶
- 配置驱动流程：步骤与参数由配置约束，而不是每次由对话临时拼凑。
- 钩子强制阻断：未通过门禁时不应静默进入下一阶段，降低「测了一半却当完成」的风险。
SkillHub 页面未单独列出 S1–S3、D1–D6、S4 各子项的具体用例定义；启用 Skill 后应以包内 SKILL.md 及配套配置为准执行。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词交给支持 Skill 的 AI 客户端由其按官方说明完成安装。
方式一：提示词安装¶
将下面意思发给当前 Agent（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_800d68d6/skill-function-test`。
安装说明全文见：https://skillhub.cn/install/skillhub.md
方式二：SkillHub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按官方文档执行完整安装或仅 CLI（命令见 skillhub.md 第一节）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @user_800d68d6/skill-function-test --dir <skills 目录>
常用 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
具体以你当前客户端文档为准；安装或更新后若客户端要求重启或重载 skills，按其产品说明操作。
典型用法¶
官方页面未给出独立的一键命令示例，典型用法是：在待测 Skill 所在项目或工作区启用 skill-function-test，由 Agent 按 SKILL.md 拉齐配置后，从备份起顺序执行至报告写入。
可复现的起步方式：
- 按上一节完成安装，并确认目标 Skill 路径与测试配置已就绪。
- 在对话中明确要测的对象（例如某个本地 Skill 包）并触发本 Skill。
- 在配置确认与钩子门禁通过后，依次完成 S1–S3、D1–D6、S4；失败则进入修复环节，再按流程 bump 与出报告。
- 检查工作区是否生成双格式报告及
test-report.md，用于提交前自检或 CI 旁路人工复核。
适用场景与注意¶
适合谁
- 维护社区或团队内多个 Skill，需要固定回归路径的开发者。
- 希望在版本 bump 前有备份、蓝皮书对照、分阶段测试与书面结论的维护者。
限制与注意
- 来源为 community，评分与下载量来自 SkillHub 展示（截至资料抓取：评分 100000，下载 1096）；安装数页面显示为 0，是否适合你的环境需自行试跑。
- 子阶段（S1–S3、D1–D6 等）的细则以安装后的 Skill 包内文档为准，本文仅复述官方简介中的阶段名称与顺序。
- 钩子阻断意味着中途跳过步骤可能被拒绝，适合严肃测试，不适合只想「快速聊两句」的轻量验证。
结尾¶
skill-function-test 把 Skill 测试从即兴对话收成「备份 → 规范对照 → 场景与功能分测 → 忠实度 → 修复与 bump → 双格式报告 + test-report.md」的配置驱动流程，并用钩子减少漏步。若你在 SkillHub 上维护 dev-programming 类 Skill，可从官方页获取 v1.16.1 并按 https://skillhub.cn/install/skillhub.md 安装 @user_800d68d6/skill-function-test 试跑一轮完整链路。
