Vibe Coding 技能库、部署与配置整理笔记

一、Skills 核心概念

一句话定义:Skills 是可复用的指令包(文件夹形式),通过封装团队的工作流程、业务逻辑和领域知识,让 AI 在需要时自动调用执行,解决了 AI 缺乏专业知识的鸿沟。

与传统 Prompt 的本质区别

对比维度 Prompt 提示词 Claude Skills
生效范围 仅当前对话 跨对话持久化
内容形式 纯文本指令 文件夹(含规范、脚本、模板、资料)
可复制性 需手动复制粘贴 自动匹配调用
可组合性 不可叠加 多个 Skills 可组合使用
上下文占用 占用对话窗口 不占用上下文窗口

核心原则

Skill 能否被准确触发,完全取决于其 SKILL.md 中 description 的质量。不是简单的关键词匹配,而是 Claude 对能力和适用场景的语义理解。

Skill 文件夹结构

一个典型的 Skill 文件夹包含以下组件:

my-skill/
├── SKILL.md          # 核心指令、触发条件、执行指引
├── scripts/          # Python/JS 执行脚本
└── references/       # 按需加载的详细文档(表结构、API 规范等)

SKILL.md 文件格式

---
name: my-skill-name
description: 清晰描述技能的功能和使用场景
---
# 技能名称
[具体的指令内容,Claude 会在技能激活时遵循]

## 示例
- 示例1
- 示例2

## 指南
- 指南1
- 指南2

Frontmatter 只要求两个字段:name(唯一标识,小写,空格用连字符)和 description(技能功能和使用场景的完整描述)。

Skills vs MCP

Skills MCP
角色 程序化知识/工作流 工具连接协议
类比 大脑(知道怎么做) 手和脚(去执行)
典型场景 分析框架、SWOT 分析 连接 Google Drive、GitHub

二、Skills 资源仓库

1. Anthropic 官方 Skill 库

  • 地址https://github.com/anthropics/skills
  • Stars:150k+
  • 内容:包含创意设计、技术开发、企业沟通、文档处理等四大类技能
  • 亮点:包含驱动 Claude 文档能力的 docx、pdf、pptx、xlsx 子文件夹(source-available)

2. alirezarezvani/claude-skills

  • 地址https://github.com/alirezarezvani/claude-skills
  • Stars:17.9k+
  • 体量345+ production-ready skills + 30+ Agents + 70+ 自定义命令 + 579 Python 工具(纯标准库,无 pip 依赖)
  • 分类:工程、营销、产品、合规、C-level 咨询、研究、商业运营、金融等 9 大领域
  • 支持平台:Claude Code、OpenAI Codex、Gemini CLI、Cursor、Windsurf 等 13 个 AI 编码工具
  • 安装/plugin marketplace add alirezarezvani/claude-skills/plugin install engineering-skills@claude-code-skills

3. obra/superpowers

  • 地址https://github.com/obra/superpowers
  • Stars:226k+
  • 核心理念:完整的软件开发方法论,强调真正的红/绿 TDD、YAGNI、DRY
  • 工作流:启动时先问清需求 → 按块展示设计 → 签署设计 → 生成实现计划 → subagent-driven-development 执行
  • 官方 Marketplace 安装/plugin install superpowers@claude-plugins-official

4. superpowers-zh(中文增强版)

  • 地址https://github.com/jnMetaCode/superpowers-zh
  • Stars:5.2k+
  • 规模:14 个翻译 skills + 6 个中国特色原创 skills → 总计 20 个 skills
  • 支持工具:18 款(Claude Code、Copilot CLI、Cursor、Windsurf、Gemini CLI、Qwen Code 等)
  • 一键安装npx superpowers-zh(自动识别项目中的工具)
  • 特色:适配国内 Git 平台(Gitee、Coding、CNB)、中文排版规范、Conventional Commits 中文化

5. ComposioHQ/awesome-claude-skills

6. multica-ai/andrej-karpathy-skills

  • 地址https://github.com/multica-ai/andrej-karpathy-skills
  • Stars:174k+
  • 核心理念:基于 Andrej Karpathy 对 LLM 编码陷阱的观察,提炼出 4 条原则:
    1. Think Before Coding:明确假设、呈现多种解释、困惑时停下询问
    2. Simplicity First:无未要求的特性、无单次使用的抽象、50 行能解决的绝不写 200 行
    3. Surgical Changes:只改必须改的部分、匹配现有风格
    4. Goal-Driven Execution:定义成功标准、测试先行

三、Claude Code 安装配置

一键安装

# 设置代理(如需要)
PS> $Env:HTTP_PROXY = "http://127.0.0.1:7890"
PS> $Env:HTTPS_PROXY = "http://127.0.0.1:7890"

# 安装 Claude Code
PS> irm https://claude.ai/install.ps1 | iex

settings.json 配置示例(全局 ~/.claude/settings.json 或项目级 .claude/settings.json):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus"
  },
  "model": "haiku",
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.175"
}

插件市场管理

claude plugin marketplace list
claude plugin add xxx/xxx

官方插件安装(请选择性安装)

地址:https://claude.com/plugins

claude plugin install frontend-design@claude-plugins-official
claude plugin install superpowers@claude-plugins-official
claude plugin install skill-creator@claude-plugins-official

四、OpenClaw 安装配置

一键安装

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard --install-daemon
openclaw config set tools.profile full

配置示例

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen3.5-Plus",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus",
      }
    }
  }
}
posted @ 2026-03-12 17:13  wanghongwei-dev  阅读(142)  评论(0)    收藏  举报