Skills 开发教程：创建与发布自定义技能包

my-skill/
├── manifest.json        # 技能元数据（必需）
├── README.md            # 技能说明文档
├── prompts/             # 提示词模板
│   ├── system.md        # 系统提示词
│   ├── user-template.md # 用户输入模板
│   └── few-shot/        # Few-shot 示例
│       ├── example-1.md
│       └── example-2.md
├── tools/               # 工具定义
│   └── tools.json       # 工具列表与参数 Schema
├── workflows/           # 工作流定义
│   └── main.json        # 主工作流
├── knowledge/           # 领域知识库
│   ├── glossary.md      # 术语表
│   └── best-practices.md
├── tests/               # 测试用例
│   ├── test-cases.json
│   └── expected/        # 期望输出
│       └── case-1.json
└── assets/              # 静态资源
    └── icon.svg         # 技能图标

{
  "name": "code-reviewer",
  "version": "1.2.0",
  "description": "智能代码审查技能，支持多语言代码质量分析",
  "author": "your-name",
  "license": "MIT",
  "category": "development",
  "tags": ["code-review", "quality", "security"],

  "entry": "prompts/system.md",
  "tools": "tools/tools.json",
  "workflows": ["workflows/main.json"],

  "dependencies": {
    "mcp": ["filesystem", "git"],
    "skills": []
  },

  "permissions": {
    "filesystem": "read",
    "network": false,
    "subprocess": false
  },

  "config": {
    "severity_threshold": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "default": "medium",
      "description": "报告的最低严重级别"
    },
    "languages": {
      "type": "array",
      "items": { "type": "string" },
      "default": ["javascript", "python", "java"],
      "description": "支持审查的编程语言"
    }
  },

  "compatibility": {
    "workbuddy": ">=1.5.0"
  }
}

# 角色
你是一位资深代码审查专家，擅长 {{languages}} 语言的代码质量分析。

# 审查标准
按照以下维度逐项审查：
1. **代码规范**：命名、格式、注释是否符合团队规范
2. **逻辑正确性**：边界条件、异常处理、并发安全
3. **性能**：时间/空间复杂度、不必要的计算
4. **安全**：注入风险、敏感数据暴露、权限越权
5. **可维护性**：函数粒度、耦合度、可测试性

# 输出格式
以 Markdown 表格输出审查结果：

| 文件 | 行号 | 级别 | 类别 | 问题描述 | 修改建议 |
|------|------|------|------|----------|----------|

仅报告 {{severity_threshold}} 及以上级别的问题。

请审查以下代码变更：

## 变更文件
{{file_list}}

## Diff 内容
{{diff_content}}

## 上下文
{{context}}

// tools/tools.json
[
  {
    "name": "run_linter",
    "description": "对指定文件运行代码检查工具",
    "parameters": {
      "type": "object",
      "properties": {
        "files": {
          "type": "array",
          "items": { "type": "string" },
          "description": "待检查的文件路径列表"
        },
        "linter": {
          "type": "string",
          "enum": ["eslint", "pylint", "checkstyle"],
          "description": "使用的检查工具"
        }
      },
      "required": ["files"]
    }
  },
  {
    "name": "get_git_diff",
    "description": "获取 Git 变更的 diff 内容",
    "parameters": {
      "type": "object",
      "properties": {
        "base": { "type": "string", "default": "main" },
        "scope": { "type": "string", "enum": ["staged", "unstaged", "all"] }
      }
    }
  }
]

// workflows/main.json
{
  "name": "full-review",
  "steps": [
    {
      "id": "get_diff",
      "tool": "get_git_diff",
      "params": { "scope": "staged" }
    },
    {
      "id": "lint",
      "tool": "run_linter",
      "params": { "files": "{{steps.get_diff.result.files}}" }
    },
    {
      "id": "review",
      "prompt": "prompts/user-template.md",
      "params": {
        "diff_content": "{{steps.get_diff.result.diff}}",
        "file_list": "{{steps.get_diff.result.files}}",
        "lint_result": "{{steps.lint.result}}"
      }
    }
  ],
  "output": "{{steps.review.result}}"
}

# macOS/Linux
~/.workbuddy/skills/local/

# Windows
%USERPROFILE%\.workbuddy\skills\local\

{
  "config": {
    "_debug": {
      "type": "boolean",
      "default": false,
      "description": "开启调试模式，输出详细日志"
    }
  }
}

[
  {
    "name": "检测空指针异常",
    "input": {
      "code": "function getAge(user) { return user.age; }",
      "language": "javascript"
    },
    "expected": {
      "contains": ["空指针", "null", "undefined"],
      "severity": "high"
    }
  },
  {
    "name": "忽略合规代码",
    "input": {
      "code": "function add(a, b) { return a + b; }",
      "language": "javascript"
    },
    "expected": {
      "issues_count": 0
    }
  }
]

/skills validate code-reviewer

# 登录（首次）
/workbuddy login

# 发布
/skills publish code-reviewer

# 更新已有技能
/skills publish code-reviewer --update