菜单
Claude技能质量检查器,自动验证技能是否符合官方最佳实践标准。Use when 创建新技能需要验证规范、 修改现有技能需要质量检查、从他人处获取技能需要评估质量、批量检查多个技能的合规性。 适用于: (1) 新技能开发后的质量验证 (2) 技能更新后的合规检查 (3) 第三方技能的质量评估 (4) 团队技能库的标准化管理 (5) 技能打包前的最终审核
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
华安保险车险周报HTML可视化生成器。将车险周报数据（Excel/CSV/JSON/DuckDB）转化为交互式网页仪表盘，支持标签页切换（经营概览、保费进度、变动成本、损失暴露、费用支出）和下钻分析（机构/客户类别双维度）。采用ECharts图表、响应式布局、麦肯锡配色方案。触发场景：用户上传车险周报数据文件，要求生成HTML可视化网页、交互式仪表盘或网页版报告。
代码库功能完成度分析工具。分析项目中各功能模块的实现状态、核心文件存在性、架构采用情况，并生成结构化的JSON分析报告。适用于项目进度跟踪、功能盘点、技术债务评估等场景。
验证车险CSV数据的完整性和正确性,检查26个必需字段,验证数据类型、枚举值和业务规则。当用户提到"验证数据"、"检查数据"、"数据导入"、"CSV"时使用。
代码变更后自动同步开发文档。支持功能文档、技术设计、决策记录的智能更新。当用户提到更新文档、同步文档、完成功能、修改数据结构或新增KPI时激活。
智能检查本地代码与GitHub的同步状态,识别未提交、未推送、未拉取的更改,帮助在多台电脑之间无缝切换开发。触发词:"检查同步"、"切换电脑"、"准备下班"、"开始工作"。
基于每周六截止的年度累计CSV数据，精确计算车险业务16个核心KPI指标。接受原始CSV数据，执行聚合和计算，输出完整的KPI结果。当用户提到"计算KPI"、"KPI计算"、"赔付率"、"边际贡献"、"指标"时使用。
| name | skill-quality-validator |
| description | Claude技能质量检查器,自动验证技能是否符合官方最佳实践标准。Use when 创建新技能需要验证规范、 修改现有技能需要质量检查、从他人处获取技能需要评估质量、批量检查多个技能的合规性。 适用于: (1) 新技能开发后的质量验证 (2) 技能更新后的合规检查 (3) 第三方技能的质量评估 (4) 团队技能库的标准化管理 (5) 技能打包前的最终审核 |
Claude技能质量检查器,基于官方创建流程规范自动验证技能质量。
准备待检查的技能
/mnt/skills/user/my-skill)执行检查
python scripts/check_skill.py <技能路径>
查看报告
| 输入类型 | 示例 | 说明 |
|---|---|---|
| 技能目录 | /mnt/skills/user/my-skill | 本地技能目录 |
| .skill文件 | /home/claude/my-skill.skill | 打包的技能文件 |
| 相对路径 | ./my-skill | 当前目录的技能 |
| 绝对路径 | /home/claude/skill-folder | 任意位置的技能 |
检查器会验证以下7个维度:
结构完整性 (30分)
YAML规范性 (20分)
描述质量 (15分)
内容质量 (20分)
引用有效性 (10分)
代码质量 (5分)
文档质量
| 分数 | 等级 | 说明 |
|---|---|---|
| 90-100 | A - 优秀 | 完全符合最佳实践 |
| 80-89 | B - 良好 | 基本符合,有少量改进空间 |
| 70-79 | C - 合格 | 满足基本要求,建议优化 |
| 60-69 | D - 需改进 | 存在明显问题 |
| 0-59 | F - 不合格 | 有致命问题 |
通过标准: 评分≥70分 且 无致命问题
用户请求检查
↓
准备工作空间
- .skill文件自动解压
- 目录直接使用
↓
执行7项检查
- 结构、YAML、描述
- 内容、引用、代码、文档
↓
计算综合评分
- 扣分规则计算
- 等级评定
↓
生成详细报告
- 问题分级
- 改进建议
↓
输出检查结果
🔴 致命问题 (Critical)
⚠️ 警告 (Warning)
⭐ 建议 (Suggestion)
============================================================
技能质量检查报告
============================================================
技能名称: my-skill
综合评分: 85/100
评级等级: B - 良好
总问题数: 5
检查结果: ✅ 通过
============================================================
🔴 致命问题 (Critical Issues)
============================================================
1. 缺少必需文件: SKILL.md
💡 改进建议: 创建SKILL.md文件,这是技能的核心文档
============================================================
⚠️ 警告 (Warnings)
============================================================
1. description缺少"何时使用"说明
💡 改进建议: 添加 "Use when..." 或 "适用于..." 描述触发场景
2. 发现3个示例文件未清理
💡 改进建议: 删除以下文件: scripts/example.py, ...
============================================================
💡 优化建议 (Suggestions)
============================================================
1. 建议添加章节: 快速开始, 工作流程
💡 改进建议: 这些章节帮助用户快速理解如何使用技能
优先修复致命问题
处理警告
考虑建议
重新检查
检查器使用固定的评分标准,基于官方最佳实践文档。如需了解详细的检查项目和评分规则,参见:
references/checklist.mdreferences/quick_fixes.md如果你需要调整评分标准(不推荐),可以修改 scripts/check_skill.py 中的扣分参数:
# 示例: 调整description缺少"何时使用"的扣分
if not any(keyword in description.lower() for keyword in ...):
self.score -= 8 # 改为你希望的扣分值
工作流:
# 1. 创建技能
python /mnt/skills/examples/skill-creator/scripts/init_skill.py my-skill
# 2. 开发技能内容
# ... 编写SKILL.md, scripts, references ...
# 3. 质量检查
python /mnt/skills/user/skill-quality-validator/scripts/check_skill.py my-skill
# 4. 根据报告改进
# 5. 重新检查直到通过
工作流:
# 1. 修改技能内容
# ... 更新SKILL.md或添加新功能 ...
# 2. 验证更新是否合规
python scripts/check_skill.py /mnt/skills/user/existing-skill
# 3. 确保评分未降低
工作流:
# 1. 下载技能文件
# downloaded-skill.skill
# 2. 质量评估
python scripts/check_skill.py downloaded-skill.skill
# 3. 查看报告决定是否使用
工作流:
# 检查所有用户技能
for skill in /mnt/skills/user/*/; do
echo "检查: $skill"
python scripts/check_skill.py "$skill"
echo "---"
done
# 标准技能发布流程
# 1. 质量检查
python /mnt/skills/user/skill-quality-validator/scripts/check_skill.py my-skill
# 确保通过 (≥70分, 无致命问题)
# 2. 打包技能
python /mnt/skills/examples/skill-creator/scripts/package_skill.py my-skill
# 生成 my-skill.skill
# 3. 分发使用
建议在以下时机执行检查:
如需添加特定项目的检查规则,可以扩展 scripts/check_skill.py:
def _check_custom_requirement(self):
"""自定义检查项"""
# 你的检查逻辑
if not meets_requirement:
self._add_issue('warning', '问题描述', '改进建议')
self.score -= 5
在自动化流程中使用:
# GitHub Actions 示例
- name: Validate Skill Quality
run: |
python check_skill.py my-skill
if [ $? -ne 0 ]; then
echo "质量检查未通过"
exit 1
fi
基于检查结果生成README徽章:
references/checklist.md - 所有检查项的完整说明references/quick_fixes.md - 常见问题的解决方案# 确保Python 3可用
python3 --version
# 确保有执行权限
chmod +x scripts/check_skill.py
# .skill文件本质是zip文件
# 手动解压测试
unzip -t skill-file.skill
references/checklist.md 了解评分规则建议: 质量检查通过后,仍需进行实际功能测试。