Skill 质量优化专家

要解决的问题

很多 SKILL.md 写完以后仍缺少可执行的质量验收：章节是否完整、描述是否可触发、目录结构是否符合发布规范、版本字段是否一致，都依赖人工反复检查。@user_6bedba2d/skillfaq 把这些检查整理成一个面向开发者的静态质量工作流，适合在提交 SkillHub 前做自检和整改。

工作方式

它围绕 RED、GREEN、REFACTOR 三个阶段推进：

• RED：读取目标 Skill 路径，确认当前文档状态、目标评分和成功标准。
• GREEN：执行 TRACE 五维评测，覆盖 Trust、Reliability、Adaptability、Convention、Effectiveness，并识别 P0/P1/P2 问题。
• REFACTOR：根据评测结果给出修复建议，重点处理阻塞发布的 P0 问题，再验证评分是否接近 target_score。

该技能也包含 SkillHub 合规检查，关注 frontmatter、必需文件、版本一致性和目录结构。评测深度可从 minimal 到 deep，适合快速扫描或完整审查。

适用边界

它主要做静态文档分析，不替代实际运行测试，也不检测代码逻辑错误或运行时问题。对于远程 Git 链接、加密内容、非标准结构，需要先整理成本地目录再评测。评分受文档完整度影响，发布判断仍建议结合人工复核。