D:\ai\.trae\skills\dev-workflow
SkillHub TRACE 评测体系从 可信任度（Trust）、可靠性（Reliability）、适用性（Adaptability）、规范性（Convention）、有效性（Effectiveness） 五个维度全面评估 Skill 的质量。该体系基于 SkillHub 平台的长期运营实践及腾讯新闻团队的内容生产经验沉淀而成，旨在帮助用户快速识别高质量 Skill。
特别说明：本报告不是官方报告，而是 TRACE 评测体系的模拟检测，最终测评结果以 SkillHub 为准。
等级阈值：≥4.7 优秀（Excellent） | ≥4.2 良好（Good） | ≥3.5 一般（Fair） | <3.5 待改进（Needs improvement）
dev-workflow 是一个结构精密的全栈开发工作流引擎，9 阶段门禁管线 + 模型路由 + 技能编排三层架构设计扎实，T 维接近满分体现了出色的安全合规意识。
相比 no-skill 裸模型：工作流结构化增益 +2.5、反模式检测增益 +2.5、知识可追溯增益 +2.5。主要短板在于 Gotchas/FAQ 脚本检测兼容性和 examples 数量。
安全红线维度近乎满分。安全声明独立章节覆盖脚本行为全边界，三分类边界每类≥3例且附带替代工具引导，全中文适配国内开发场景。
| 子项 | 得分 | 证据 | 建议 |
|---|---|---|---|
| T1 安全性扫描 | 4.6 | 含 scripts/phase-gate.py（35KB），安全声明覆盖：仅本地I/O、无网络/数据收集/外部API，无密钥泄露 | 安全声明中增加"代码可审计"承诺 |
| T2 国内适配性 | 5.0 | 全中文 SKILL.md，tags 含中文关键词（工作流、全栈开发、阶段管控），示例输出中文化 | — |
| T3 边界/权限控制 | 5.0 | ✅/⚠️/❌ 三分类每类≥3例，❌类附带替代方案（context-anchor独立/各Skill直接激活/独立使用） | — |
| T4 安全声明 | 5.0 | "零、定位与安全声明"章节明确：不发起网络请求、不收集数据、不访问外部API，限定在 .trae/ 目录 | — |
降级兜底出色（每个不该用场景都有替代工具），phase-gate check 双重校验。但 Gotchas 被脚本漏检、缺少交互式引导模板和显式 Rules 章节。
| 子项 | 得分 | 证据 | 建议 |
|---|---|---|---|
| R1 异常处理 | 4.2 | ⚠️脚本漏检：L149-157有5条Gotchas（表格格式），phase-gate.py check/check--skills校验。缺交互式引导模板 | 增加交互式引导模板：不完整输入→先给假设方案→列缺失项 |
| R2 可运行性 | 3.8 | 9阶段×详细子步骤+出口检查（references/phases/），phase-gate.py完整CLI门禁。脚本未检测到显式steps | 增加显式步骤编号（Step 1/2/3）提升脚本检测率 |
| R3 交付物完整性 | 4.4 | phase-gate check+check--skills双重校验，context-anchor锚点防漂移，5条Gotchas覆盖关键失败 | 增加"Rules/约束规则"章节结构化核心原则 |
| R4 降级处理 | 4.8 | ❌边界每类附替代方案：简单脚本→context-anchor、已有CI/CD→各Skill直接激活、非Web→独立激活 | 可补充降级后的最小可用工作流模式 |
边界定义场景化且具体，受众分三类各有使用指南。A2 受 YAML `>` 解析错误影响被严重低估（实际 description 约150字符），缺少风格参数传递机制。
| 子项 | 得分 | 证据 | 建议 |
|---|---|---|---|
| A1 边界清晰度 | 4.8 | ✅/⚠️/❌ 三分类含场景化判断："从零开始全栈"→✅、"已有代码库"→⚠️（从Phase1开始）、"简单脚本"→❌+替代 | 增加"模糊场景决策树" |
| A2 Description触发质量 | 3.8 | ⚠️脚本解析错误：YAML `>` 折叠块被解析为length=1，实际约150字符含完整功能+路由。activation含5触发短语 | 改用YAML `|` 字面量块标量提升解析兼容性 |
| A3 国内适用性 | 4.6 | 显式"受众说明"章节，三类用户（全栈独立/专精/Leader+PM）各有具体使用方式差异描述 | 增加技术栈偏好（React vs Vue）适配建议 |
| A4 场景覆盖广度 | 4.2 | model-config.toml支持按阶段配置LLM路由，技能编排三级分类，skip --reason自定义管理 | 增加"风格卡片"参数（严格模式/TDD模式） |
渐进式披露结构出色（13 refs + 155行 body），frontmatter 信息完整。C4 被脚本漏检（实际有5 Gotchas+6 FAQ），C2 因 phase- 前缀×9 触发去重降档。
| 子项 | 得分 | 证据 | 建议 |
|---|---|---|---|
| C1 用途/适用说明 | 4.5 | 4个examples（init/status/advance/skip），均可复制CLI+预期输出，doc类型阈值5 | 增加第5个example（E2E全流程或model命令） |
| C2 渐进披露 | 4.5 | refs=13≫8，body=155<200，三层结构清晰。⚠️ phase-前缀×9触发去重降档（规则#4） | 合并或拆分phase文件消除前缀重复 |
| C3 元信息结构 | 4.7 | name有效+kebab-case匹配目录，frontmatter完整（license/cooperates_with/tags/priority），refs仅1子目录 | 增加templates/或guides/子目录使subdirs≥2 |
| C4 Gotchas与指令规范 | 3.8 | ⚠️脚本漏检：L149-157有5条Gotchas（表格:陷阱→正确做法），L159-178有6条FAQ（实质非充数），受±0.3限幅 | 改标题为"## Gotchas"提升脚本兼容；FAQ扩至3-4句 |
9阶段门禁+模型路由+技能编排形成完整知识体系。阶段出口校验强、快速开始降低上手门槛。仅差1个example和1个refs子目录可突破瓶颈。
| 子项 | 得分 | 证据 | 建议 |
|---|---|---|---|
| E1 任务完成度 | 4.6 | 9阶段门禁强制出口验证，每阶段子步骤checklist+出口条件，模型按阶段自动路由（Opus→Sonnet→Haiku） | 增加"禁止胡编"显式规则：API须与Phase2设计一致 |
| E2 正确性/权威性 | 4.0 | 4个examples覆盖核心CLI操作，每个含真实CLI输出。doc阈值5个 | 增加第5个example触发满分 |
| E3 交付物质量 | 4.4 | 9阶段方法论+模型路由策略+三级技能编排+锚点协同协议，完整领域知识体系。仅1个refs子目录 | 拆分refs为phases/+guides/+templates/提升至4.7+ |
| E4 增益归因 | 4.6 | "快速开始"章节5个可复制CLI命令，4个examples可直接复制，phase-gate.py完整可运行35KB | Gotchas修复脚本检测后可达4.8+ |
| 对比维度 | no-skill（裸模型） | 启用此 skill | 增益 |
|---|---|---|---|
| 概念准确性 | 2.5 | 4.0 | +1.5 |
| 适用场景判断 | 2.0 | 4.5 | +2.5 |
| 反模式/错误检测 | 1.5 | 4.0 | +2.5 |
| 知识可追溯性 | 2.0 | 4.5 | +2.5 |
| Token 成本 | 0 | ~5,500 tokens | 中等 |
| # | 检查项 | 结果 | 证据 |
|---|---|---|---|
| 1 | SKILL.md 存在 | ✅ | SKILL.md 190行/5,545字符 |
| 2 | Name 与目录名一致 | ✅ | name: dev-workflow ↔ 目录 dev-workflow |
| 3 | Name 格式有效（kebab-case） | ✅ | dev-workflow 符合 kebab-case 规范 |
| 4 | Description 有效（1-1024 chars） | ✅ | YAML `>` 折叠块约150字符，含完整功能描述+路由场景 |
| 5 | License 字段 | ✅ | license: MIT |
| 6 | 目录结构规范 | ✅ | scripts/(1) + references/(13+1子目录) + examples/(4) |
| 7 | 渐进式披露质量 | ✅ | 快速开始→阶段总览→references/phases/三层结构，13depth文档 |
| 8 | Description 触发质量 | ⚠️ | 内容实质性达标，但YAML `>` 语法导致脚本解析为1字符 |
| 9 | 脚本安全性 | ✅ | phase-gate.py仅本地文件读写，安全声明覆盖完整 |
| 10 | 密钥/敏感信息扫描 | ✅ | 未检测到secrets/API keys/硬编码凭据 |
评估依据：SkillHub TRACE 评测体系
合规检查：agentskills.io 官方规范 · Generated 2026-07-02