链载Ai

标题: Claude Code Skills 国内实践全指南：从安装部署到高阶开发 [打印本页]

---

作者: 链载Ai    时间: 昨天 17:13
标题: Claude Code Skills 国内实践全指南：从安装部署到高阶开发

Claude Code 的本质不是一个聊天机器人，而是一个 “可装备技能”的AI智能体。核心转变在于：从反复撰写提示词的“人适应机器”，转变为通过标准化技能模块“让机器具备确定性的专业能力”。

如果说基础功能是“汽车”，那么Skills就是让这辆车具备越野、漂移、载货等特种能力的“改装套件”。它通过标准化文件（一个文件夹+SKILL.md+资源）封装复杂工作流，实现能力复用。

一、Claude Code Skills生态资源

1，官方教材库：官方技能

#Anthropic官方Skills库：https://github.com/anthropics/skills
#Skills 官方介绍（What are Skills）：https://support.claude.com/en/articles/12512176-what-are-skills#Claude Code Skills 文档：https://code.claude.com/docs/en/skills#Claude API Skills 指南：https://platform.claude.com/docs/en/build-with-claude/skills-guide#Skill Creator：https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md#Agent Skills 背景/机制：https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

#OpenAI：Codex Skills（规则与目录结构）

#Skills总览：https://developers.openai.com/codex/skills/#创建自定义Skills：https://developers.openai.com/codex/skills/create-skill/#ChatGPT环境的/home/oai/skills（社区实测打包仓）https://github.com/eliasjudin/oai-skills

2，社区精选集：寻找现成技能

#obra/superpowers

https://github.com/obra/superpowers#skills目录https://github.com/obra/superpowers/tree/main/skills

#ComposioHQ/awesome-claude-skills：生态集成导向（更新活跃，社区关注度高，强烈推荐）

由AI工具集成平台Composio维护，强调查找可直接用于生产、能与其他工具链集成的实战型技能。

通常按应用场景（如开发、数据分析、内容创作）或集成平台分类，便于寻找开箱即用的方案。

https://github.com/ComposioHQ/awesome-claude-skills

#VoltAgent/awesome-claude-skills：社区热度导向

注重收录近期流行、受关注度高、有创新性的技能，是追踪社区趋势的风向标。

https://github.com/VoltAgent/awesome-claude-skills

#travisvn/awesome-claude-skills：综合资源导航

提供一个覆盖面广、分类清晰的综合性资源索引，类似传统的“Awesome List”。资源导航分类比较经典和全面，旨在覆盖Skill生态的各个方面，方便系统性浏览。

https://github.com/travisvn/awesome-claude-skills

#BehiSecc/awesome-claude-skills：垂直领域导向

侧重安全（Security）相关或“生产就绪”的模板，内容领域性较强。分类会围绕特定领域（如安全审计、代码加固、合规检查）展开，深度大于广度。

https://github.com/BehiSecc/awesome-claude-skills

3，聚合市场 ：开箱即用

#SkillsMP：可搜索 Skills 目录（分类/检索）

https://skillsmp.com/

#ClaudeMarketplaces：marketplace/插件目录

https://claudemarketplaces.com/

#ClaudeCode Templates：模板与偏工程化配置集合、命令集

https://www.aitmpl.com/skillshttps://github.com/davila7/claude-code-templates

#ruvnet/claude-flow

企业级智能体集群编排平台，内置 25个 自然语言触发的技能，侧重于开发、GitHub、集群协调等

https://github.com/ruvnet/claude-flow

#wshobson/agents

精细化的插件化智能体市场，提供67个专注于Claude代码的专业化技能，涵盖开发、运维、AI、安全等多个类别

https://github.com/wshobson/agents

二、Claude Code Skill安装/部署

1，通过聚合市场网站（推荐）

以 SkillsMP 为例，在网站搜索、分类查找技能。

点击技能查看详情和安装命令

/pluginmarketplaceadd作者/仓库名

/pluginmarketplaceaddwshobson/agents

复制后，在Claude Code会话中直接粘贴该命令即可完成安装。

2，通过插件市场命令安装

进入到项目GitHub主页，通过技能所在的GitHub仓库（如wshobson/agents）安装

第一步：在Claude Code中输入命令添加整个市场

/pluginmarketplaceaddwshobson/agents

第二步：安装具体插件

/plugininstallsql-optimization-patterns

注意：此处由于技术市场新版本移除了某skill技能，可下载该skill.md文件，通过手动安装方式进行安装（参考下节）

3，手动安装（高级用户，自定义技能）

自己开发或从GitHub仓库直接下载的单个技能（.md文件）：

将技能文件（如 code-reviewer.SKILL.md）放置到本地技能目录：（可根据系统调整路径）。

~/.claude/skills/

重启Claude Code即可生效

第一步：下载sql-optimization-patterns技能文件,

blob:https://skillsmp.com/1dfeae32-c71d-4740-bab6-26f46b848134

第二步：解压后放到claude本地技能目录下（需重启claude）

第三步：重启claude后，输入 /context 命令查看，安装成功

三，Claude Code Skill完整操作流程

# 启动claude

claude

# 查看skill

/plugin

# 按键盘方向键切换tab，可查看当前已安装的技能、技能市场

#查看当前已安装的技能市场（当前仅默认的官方技能市场）

#安装wshobson/agents技能市场

方式1：直接输入

/pluginmarketplaceaddwshobson/agents

方式2：方向键切换到Marketplace，选择Add Marketplace

然后输入wshobson/agents

说明：如果网络问题，可以提前下载到本地，此处使用本地文件路径

#技能市场的技能浏览、更新、卸载

# 安装本地技能市场

#克隆skill项目到本地gitclonehttps://github.com/davila7/claude-code-templates.git

#搜索插件安装（以 code-review为例）

四、高阶进阶：开发自己的专属技能

开发技能的本质，是将你的经验转化为可复用的数字资产。一个高质量Skill的关键在于结构清晰、可执行、可验收。

----SKILL开发“产品思维----

一个优秀的SKILL不是一段对话提示，而是一个迷你产品。SKILL的KPI只有一个：可以一次跑通并验收结果。

1，编写 技能文件 (SKILL.md)完整

以一个生产级可用的“API接口生成器”技能的SKILL.md 示例

#SKILL.md

---name:api-interface-generatordescription:根据后端Controller代码，自动生成前端TypeScript接口定义与Axios请求函数。version:1.0.0author:your-nametags:-typescript-api-code-generation---#Goal-**输出物**：一个标准的TypeScript文件（`api.ts`），包含：1.所有接口的请求/响应类型定义（TypeScriptInterfaces）。2.对应每个接口的、已配置基础的Axios请求函数。-**可验证**：生成的代码应能通过TypeScript编译（`tsc--noEmit`检查）。#Inputs-**必填**：1.`controller_path`:后端Controller源代码的文件路径或直接粘贴的代码。2.`api_base_url`:后端API的基础URL（例如：`https://api.example.com/v1`）。-**可选**：1.`auth_type`:认证方式，默认为`'bearer'`（可选：`basic`,`none`）。#Constraints-**不做什么**：-不修改任何后端源代码。-不生成除TypeScript类型和请求函数之外的任何框架特定代码（如ReactHooks）。-**质量与边界**：-所有生成的函数必须包含完整的JSDoc注释，说明用途和参数。-必须处理常见的HTTP状态码错误（401，403，500）。-生成的接口名必须遵循`I{ControllerName}{MethodName}{Request/Response}`的帕斯卡命名规范。#Steps技能将按以下顺序自动执行：1.**解析与分析**：-读取或解析输入的Controller代码。-识别出所有的公开方法、HTTP方法（GET/POST等）、请求路径、请求参数和返回类型。2.**转换与生成**：-将识别的后端类型映射为TypeScript类型（如`String`->`string`,`List<User>`->`IUser[]`）。-为每个API端点生成：一个请求类型、一个响应类型、一个Axios请求函数。3.**组装与输出**：-将生成的代码按以下结构组装到`api.ts`文件中：```typescript//1.导入声明importaxiosfrom'axios';//2.所有类型定义exportinterfaceILoginRequest{...}//3.所有请求函数exportconstloginApi=(...)=>{...}```-在文件头部自动生成基于当前时间的生成注释。#VerificationChecklist在技能执行完成后，请对照此清单检查输出：-[]**完整性**：Controller中每个公开方法都生成了对应的请求函数。-[]**正确性**：生成的TypeScript代码无语法错误，可通过`tsc--noEmit`检查。-[]**实用性**：每个请求函数都正确配置了`method`、`url`、`params/data`。-[]**安全性**：认证令牌（`auth_type`）被正确集成到请求头配置中。-[]**文档化**：每个函数和接口都有清晰的JSDoc注释。#Advanced:MCP工具集成(可选)如果技能需要访问外部资源（如读取文件、调用Git），可以声明MCP工具：```yaml#在SKILL.md同级目录创建skill.yamltools:-name:read_filedescription:读取本地文件内容-name:list_directorydescription:列出目录内容

2，放入claude本地skill目录，重启claude（新版本貌似不用重启）

~/.claude/skills/#技能根目录└──api-interface-generator/#【必须】为技能创建的文件夹└──SKILL.md#【必须】技能主文件，必须叫此名

3，测试新编写技能（api-interface-generator）

# 创建一个空目录，和待测试java文件

// UserController.java - 用于技能测试package com.example.demo.controller;importorg.springframework.web.bind.annotation.*;importjava.util.List;@RestController@RequestMapping("/api/v1/users")publicclassUserController{
 /**  * 用户登录  *@paramrequest 登录请求  *@return登录响应（含令牌）  */ @PostMapping("/login") publicApiResponse<LoginResponse>login(@RequestBodyLoginRequestrequest) {   // 实现逻辑...   returnApiResponse.success(newLoginResponse());  }
 /**  * 获取用户列表（分页）  *@parampage 页码  *@paramsize 每页大小  *@return用户列表  */ @GetMapping("") publicApiResponse<ageResult<UserDto>>getUsers(     @RequestParam(defaultValue ="1") int page,     @RequestParam(defaultValue ="20") int size) {   // 实现逻辑...   returnApiResponse.success(newPageResult<>());  }
 /**  * 更新用户信息  *@paramid 用户ID  *@paramuser 用户数据  *@return更新结果  */ @PutMapping("/{id}") publicApiResponse<UserDto>updateUser(     @PathVariableLongid,     @RequestBodyUpdateUserRequestuser) {   // 实现逻辑...   returnApiResponse.success(newUserDto());  }
 // 内部DTO定义（技能需要识别这些类型） publicstaticclassLoginRequest{   privateStringusername;   privateStringpassword;   // getters/setters...  }
 publicstaticclassLoginResponse{   privateStringtoken;   privateUserDtouser;   // getters/setters...  }
 publicstaticclassUpdateUserRequest{   privateStringnickname;   privateStringavatar;   // getters/setters...  }}

# 启动claude，并输入提示词

请使用api-interface-generator技能，基于当前目录下的UserController.java文件，生成前端TypeScriptAPI代码，API基础URL设为https://api.myxxx.com/v1

# 测试结果：自动生成api.ts文件，并自动进行了编译验证

//GeneratedbyAPIInterfaceGeneratoron2026-01-08importaxios,{AxiosInstance}from'axios';//BaseAPIconfigurationconstAPI_BASE_URL='https://api.myxxx.com/v1';constapiClient=axios.create({baseURL:API_BASE_URL,headers:{'Content-Type':'application/json',//Authorizationheaderwillbeaddeddynamicallyforprotectedendpoints}});//ErrorhandlinginterceptorapiClient.interceptors.response.use((response)=>response,(error)=>{if(error.response?.status===401){thrownewError('Unauthorizedleaseloginagain');}if(error.response?.status===403){thrownewError('Forbidden:Youdonothavepermission');}if(error.response?.status===500){thrownewError('Internalservererror');}throwerror;});//RequesttypedefinitionsexportinterfaceILoginRequest{username:string;password:string;}exportinterfaceILoginResponse{token:string;user:IUserDto;}exportinterfaceIUserDto{nickname?:string;avatar?:string;}exportinterfaceIUpdateUserRequest{nickname?:string;avatar?:string;}exportinterfaceIApiResponse<T>{success:boolean;data?:T;message?:string;}exportinterfaceIPageResult<T>{list:T[];total:number;page:number;size:number;}//APIrequestfunctions/***用户登录*@paramrequest登录请求体，包含用户名和密码*@returns返回登录响应，包含访问令牌和用户信息*/exportconstloginApi=async(request:ILoginRequest)romise<ApiResponse<ILoginResponse>>=>{constresponse=awaitapiClient.post<ApiResponse<ILoginResponse>>('/users/login',request);returnresponse.data;};/***获取用户列表（分页）*@parampage页码，默认为1*@paramsize每页大小，默认为20*@returns返回分页的用户列表数据*/exportconstgetUsersApi=async(page:number=1,size:number=20)romise<ApiResponse<ageResult<IUserDto>>>=>{constparams={page,size};constresponse=awaitapiClient.get<ApiResponse<ageResult<IUserDto>>>('/users',{params});returnresponse.data;};/***更新用户信息*@paramid用户ID*@paramuser用户更新数据*@returns返回更新后的用户信息*/exportconstupdateUserApi=async(id:number,user:IUpdateUserRequest)romise<ApiResponse<IUserDto>>=>{constresponse=awaitapiClient.put<ApiResponse<IUserDto>>(`/users/${id}`,user);returnresponse.data;};//HelperfunctiontosetauthorizationtokenexportconstsetAuthToken=(token:string)=>{apiClient.defaults.headers.common['Authorization']=`Bearer${token}`;};//HelperfunctiontoclearauthorizationtokenexportconstclearAuthToken=()=>{deleteapiClient.defaults.headers.common['Authorization'];};//LegacytypesforbackwardscompatibilitytypeApiResponse<T>=IApiResponse<T>;typePageResult<T>=IPageResult<T>;

五、Claude SKILL使用及开发总结

Skill是一个标准化、可复用的“智能指令包”，它通过一个文件夹（内含 SKILL.md 和可选脚本/资源）来封装一个具体的工作流程。其核心思想是：将你的经验，转化为AI可稳定执行、团队可复用的数字资产。

1，使用流程总结

使用一个Skill只需三步：发现 → 安装 → 自然语言调用。

第一步：可通过聚合市场、社区精选集找到你需要的skill

第二步：根据本文安装方式，进行技能安装

#方式1:从已知仓库添加市场并安装/pluginmarketplaceaddwshobson/agents/plugininstallsql-optimization-patterns#方式2:手动安装（用于本地技能），正确目录结构：~/.claude/skills/your-skill-name/SKILL.md

第三步：自然语言调用：无需记忆命令，直接用自然语言描述任务，如“用 code-review 审查这段代码”，匹配的技能会自动触发。

2，开发流程总结：

开发技能的本质是编写清晰的“机器说明书”，以下总结为五步创建自己专属技能：

第一步：构思与定义

明确目标：哪项重复工作你想自动化？（例如：手动将API文档转TS代码）。

定义输入/输出：技能需要什么（Inputs）？必须交付什么（Goal）？

划定边界：明确什么不做（Constraints），防止技能滥用或膨胀。

第二步：编写SKILL.md

使用上述示例SKILL模板，从name、description开始填写。

核心是Steps：用清晰的动宾短语描述，让AI能像程序一样执行。避免模糊语言。

制定Verification Checklist：这是技能质量的守门员，每一项都应可客观检查。

第三步：本地测试与迭代

安装技能：按正确结构（~/.claude/skills/your-skill-name/SKILL.md）放入本地目录。

重启并加载：重启Claude Code，用/skills list确认技能出现。

实战测试：使用真实但简单的输入调用技能，对照检查清单逐项验证输出。

Debug与优化：根据失败点，回溯修改Steps或Constraints。这是最关键的环节。

第四步：使用“偷师”提示词进行代码审查

将你的技能草案抛给任意AI，让它从第三方视角审视，帮你修改：

“请作为技能审计员，按【输入/输出/边界/依赖工具/失败模式/验证清单】审查我的SKILL.md草案，找出3个最高风险点，并给出具体修改建议。”

第五步：分享与部署

个人使用：保存在本地技能目录即可。

团队共享：将技能文件夹推送到团队Git仓库，成员可克隆到本地skills目录。

社区分享：可发布到聚合市场（如SkillsMP），通常需要提交GitHub仓库链接。

3，一些注意事项

目录结构是铁律：技能必须放在 ~/.claude/skills/<skill-name>/SKILL.md，否则无法加载。

学习官方范例：Anthropic官方Skills仓库 是最佳“教材”，其中的 pdf-processor 等是生产级参考。

理解底层规则：OpenAI Codex Skills文档 阐释了渐进式披露等核心设计哲学。

从最小闭环开始：选择一个15分钟能手工完成的小任务，开发你的第一个技能，完成“构思-测试-跑通”的完整循环。

---

欢迎光临 链载Ai (https://www.lianzai.com/)

Powered by Discuz! X3.5