Workspace Validator

目的

验证plugin-dev结构，确保所有文件格式正确，在同步到marketplace前捕获错误。

调用方式

由 sync-to-marketplace skill 通过Task工具调用。

验证检查

关键错误（必须修复）

plugin.json

• 有效的JSON格式
• 必需字段: name, description, version, author.name
• 版本是有效的semver格式

所有SKILL.md文件

• YAML frontmatter存在（--- ... ---）
• 必需字段: name, description
• Tools字段有效（如果存在）

所有agent文件

• YAML frontmatter存在
• 必需字段: name, description

hooks.json

• 有效的JSON格式（如果存在）

文件命名

• 仅小写字母
• 无特殊字符（连字符除外）

警告（应该修复）

• 空目录
• 缺少README.md
• 描述少于20个字符

返回格式

返回JSON格式的验证报告:

{
  "valid": true/false,
  "errors": [
    {
      "file": "skills/my-skill/SKILL.md",
      "line": 3,
      "issue": "YAML frontmatter缺少结束的 ---"
    }
  ],
  "warnings": [
    {
      "file": "README.md",
      "issue": "文件未找到"
    }
  ]
}

执行步骤

1. 接收plugin-dev路径
2. 检查plugin.json
3. 遍历所有skills检查YAML
4. 遍历所有agents检查YAML
5. 检查hooks.json（如果存在）
6. 检查文件命名规范
7. 收集警告
8. 返回完整报告

工具使用

• Read: 读取文件内容检查格式
• Bash: 使用命令行工具验证JSON/YAML