前言¶
自己写 Skill 时，常见问题不是「能不能跑」，而是写完就交差：触发条件含糊、步骤和约束没对齐、改了一版却没人按同一套标准复查。团队里若各自凭感觉验收，质量会漂移，也不利于在 SkillHub 上长期维护。
下面介绍社区 Skill「Skill TRACE 质量评测流程」。它在每次创建或重大修改 Skill 之后，用 TRACE 五维度做自检，并要求全部子项达到 5.0 满分后才视为任务完成，把「写完」和「达标」拆开。
这是什么¶
Skill TRACE 质量评测流程（坐标 @user_fcba917f/skill-trace-checker，版本 1.0.0）是 SkillHub 社区来源（community）、分类为 dev-programming 的评测型 Skill。发布者为 user_fcba917f，SkillHub 页面标注作者为周博远（EFU）。标签 requires_api_key=false，不依赖额外 API Key。
它解决的是：Skill 创建或改版之后，缺少统一、可重复的验收口径。与「只跑一遍 happy path」不同，本 Skill 把 TRACE 体系固化为必须执行的检查流程。
TRACE 五维度¶
官方简介中的 TRACE 覆盖以下五个维度（英文缩写与中文名称一并保留）：
| 维度 | 含义 |
|---|---|
| Trust | 可信任度 |
| Reliability | 可靠性 |
| Adaptability | 适用性 |
| Convention | 规范性 |
| Effectiveness | 有效性 |
完成标准：各维度下的全部子项均需达到 5.0 满分；未达标则任务不算完成。具体子项清单与打分细则在 Skill 本体（SKILL.md）中定义，安装后由 Agent 按该 Skill 的指令执行，本文不展开未公开的内容。
触发条件¶
官方说明的触发场景很明确：
- 每次完成 Skill 创建之后；
- 每次对 Skill 进行重大修改之后。
在上述节点应自动执行本检查流程，而不是可选的「有空再看一眼」。
核心功能（已核实）¶
结合 SkillHub 页面与抓取元数据，可确认的能力边界如下：
- 五维 TRACE 自检：按 Trust、Reliability、Adaptability、Convention、Effectiveness 组织检查项。
- 满分门槛：全部子项 5.0 才视为任务完成。
- 与 Skill 生命周期绑定：创建或重大修改后触发，适合作为交付前的固定步骤。
- 无 API Key 要求：
requires_api_key=false，降低接入成本。
SkillHub 统计（以页面与抓取数据为准，会随时间变化）：评分 100000，下载约 910 次；安装数在抓取时为 0，以 SkillHub 实时页面为准。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或把提示词交给当前 AI 客户端由其按安装文档操作。
1. 检查 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档 执行完整安装或仅安装 CLI（文档中的 curl 安装脚本）。限网环境需在允许联网的权限下执行。
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。
skillhub install @user_fcba917f/skill-trace-checker --dir <你的 skills 目录>
常用客户端的 skills 路径（摘自官方安装文档，按你当前环境选用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可直接向 Agent 发送 SkillHub 页面给出的安装提示，核心是让其阅读并执行：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fcba917f/skill-trace-checker`。
安装完成后，按你所用客户端的要求刷新或重启 Agent，使新 Skill 进入可用列表。
典型用法¶
本 Skill 基于通用 SKILL.md 格式。公开页面未提供独立示例仓库，可复现的工作流如下：
- 完成某个 Skill 的新建或重大修改（含
SKILL.md及附属说明、脚本等）。 - 在同一 Agent 会话中启用或引用
@user_fcba917f/skill-trace-checker，对目标 Skill 执行 TRACE 自检。 - 对照 TRACE 五维度及 Skill 内定义的子项，逐项核对是否达到 5.0；若有未达标项，回到 Skill 文稿修改后再次执行检查。
- 仅在全部子项满分后，将「创建/修改 Skill」相关任务标记为完成。
若你同时维护「被测 Skill」与「本评测 Skill」，建议把第 2 步写进自己的团队规范或母 Skill 的交付清单，避免改版后跳过复检。
适用场景与注意¶
适合谁
- 经常在 Cursor、Claude Code、Codex 等环境里编写或迭代 Agent Skill 的开发者。
- 希望交付前有一致验收标准、而不是口头约定的个人或小团队。
限制与注意
- 评测深度取决于 Skill 本体中的子项定义；未安装或未加载时，Agent 无法自动套用 TRACE 流程。
- 「重大修改」的边界需结合你自己的版本管理习惯界定；官方仅给出触发语义，不替代你的变更评审。
- SkillHub 上的评分、下载量为动态数据，引用时以 SkillHub 详情页 为准。
- API 地址
https://api.skillhub.cn/user_fcba917f/skill-trace-checker用于 Skill 元数据与分发；浏览器直接访问可能返回 HTTP 405，安装仍以 CLI 或安装文档为准。
结尾¶
Skill TRACE 质量评测流程把「创建/改版 Skill」之后的验收，收敛为 TRACE 五维、子项 5.0 满分的可重复步骤，适合作为 Skill 工程化里固定的一环。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_fcba917f/skill-trace-checker
- 元数据 API：https://api.skillhub.cn/user_fcba917f/skill-trace-checker
- 安装说明：https://skillhub.cn/install/skillhub.md
