Claude Code Skills 系列（3/3）：精通参考篇 - 进阶技巧与完整手册

第一部分：进阶技巧
- [1. 组合使用多个 Skills](#1. 组合使用多个 Skills)
- - [1.1 完整的开发工作流](#1.1 完整的开发工作流)
  - - [创建工作流 Skill](#创建工作流 Skill)
  - [1.2 Skills 协作模式](#1.2 Skills 协作模式)
  - - [模式 1：顺序执行](#模式 1：顺序执行)
    - [模式 2：并行执行](#模式 2：并行执行)
    - [模式 3：条件分支](#模式 3：条件分支)
  - [1.3 实战案例：CI/CD 工作流](#1.3 实战案例：CI/CD 工作流)
- [2. 条件执行与动态配置](#2. 条件执行与动态配置)
- - [2.1 基于环境的条件执行](#2.1 基于环境的条件执行)
  - - 检测当前环境
  - [2.2 基于项目类型的动态配置](#2.2 基于项目类型的动态配置)
  - [2.3 基于用户输入的动态行为](#2.3 基于用户输入的动态行为)
- [3. 链式调用与工作流](#3. 链式调用与工作流)
- - [3.1 创建链式工作流](#3.1 创建链式工作流)
  - - [示例：完整的 PR 流程](#示例：完整的 PR 流程)
  - [3.2 错误处理与回滚](#3.2 错误处理与回滚)
  - [3.3 并行任务协调](#3.3 并行任务协调)
- [4. 模板系统](#4. 模板系统)
- - [4.1 创建模板驱动的 Skill](#4.1 创建模板驱动的 Skill)
  - - 目录结构
    - SKILL.md
    - [React 组件模板（templates/react-component.tsx）](#React 组件模板（templates/react-component.tsx）)
    - 测试模板（templates/component.test.ts）
  - [4.2 高级模板技巧](#4.2 高级模板技巧)
  - - 条件模板
    - 多文件模板
- [5. 子代理与工具限制](#5. 子代理与工具限制)
- - [5.1 使用子代理（Subagent）](#5.1 使用子代理（Subagent）)
  - - 什么是子代理
    - 配置子代理
  - [5.2 工具访问限制](#5.2 工具访问限制)
  - [5.3 安全最佳实践](#5.3 安全最佳实践)
  - - 敏感操作的安全配置
    - 数据操作的安全配置
第二部分：快速参考
- [6. 命令速查表](#6. 命令速查表)
- - [6.1 Claude Code 基本命令](#6.1 Claude Code 基本命令)
  - [6.2 Windows 文件操作命令（CMD）](#6.2 Windows 文件操作命令（CMD）)
  - [6.3 Git 常用命令](#6.3 Git 常用命令)
  - [6.4 环境变量](#6.4 环境变量)
- [7. 目录结构速查](#7. 目录结构速查)
- - [7.1 个人级配置](#7.1 个人级配置)
  - [7.2 项目级配置](#7.2 项目级配置)
  - [7.3 Skill 内部结构](#7.3 Skill 内部结构)
  - [7.4 多仓库管理结构](#7.4 多仓库管理结构)
- [8. Frontmatter 速查表](#8. Frontmatter 速查表)
- - [8.1 所有可用字段](#8.1 所有可用字段)
  - [8.2 常用配置组合](#8.2 常用配置组合)
  - - [配置 1：默认 Skill（双向调用）](#配置 1：默认 Skill（双向调用）)
    - [配置 2：仅手动调用（敏感操作）](#配置 2：仅手动调用（敏感操作）)
    - [配置 3：仅 AI 调用（背景知识）](#配置 3：仅 AI 调用（背景知识）)
    - [配置 4：只读模式](#配置 4：只读模式)
    - [配置 5：子代理模式](#配置 5：子代理模式)
- [9. 变量替换速查](#9. 变量替换速查)
- - [9.1 参数变量](#9.1 参数变量)
  - [9.2 使用示例](#9.2 使用示例)
  - - [示例 1：单个参数](#示例 1：单个参数)
    - [示例 2：多个参数](#示例 2：多个参数)
    - [示例 3：可选参数](#示例 3：可选参数)
  - [9.3 命令注入变量](#9.3 命令注入变量)
  - - [示例 1：获取当前分支](#示例 1：获取当前分支)
    - [示例 2：获取文件列表](#示例 2：获取文件列表)
    - [示例 3：获取系统信息](#示例 3：获取系统信息)
  - [9.4 环境变量](#9.4 环境变量)
  - - 使用示例
第三部分：学习资源
- [10. 官方资源](#10. 官方资源)
- - [10.1 官方文档](#10.1 官方文档)
  - [10.2 官方仓库](#10.2 官方仓库)
  - [10.3 Agent Skills 标准](#10.3 Agent Skills 标准)
- [11. 社区资源](#11. 社区资源)
- - [11.1 Superpowers ⭐⭐⭐⭐⭐](#11.1 Superpowers ⭐⭐⭐⭐⭐)
  - [11.2 Jeffallan/claude-skills](#11.2 Jeffallan/claude-skills)
  - [11.3 Awesome Claude Skills](#11.3 Awesome Claude Skills)
  - [11.4 Skills 市场平台](#11.4 Skills 市场平台)
  - [11.5 中文教程](#11.5 中文教程)
- [12. 实践建议](#12. 实践建议)
- - [12.1 学习路径](#12.1 学习路径)
  - - 第一周：基础使用
    - [第二周：自定义 Skills](#第二周：自定义 Skills)
    - 第三周：高级功能
    - 第四周：团队协作
  - [12.2 最佳实践建议](#12.2 最佳实践建议)
  - - [1. 从简单开始](#1. 从简单开始)
    - [2. 迭代改进](#2. 迭代改进)
    - [3. 记录和分享](#3. 记录和分享)
    - [4. 定期维护](#4. 定期维护)
  - [12.3 常见陷阱](#12.3 常见陷阱)
  - - [陷阱 1：Description 过于复杂](#陷阱 1：Description 过于复杂)
    - [陷阱 2：过度预判](#陷阱 2：过度预判)
    - [陷阱 3：忽略安全](#陷阱 3：忽略安全)
第四部分：总结
- [13. 核心要点回顾](#13. 核心要点回顾)
- - [13.1 Skills 的本质](#13.1 Skills 的本质)
  - [13.2 配置级别](#13.2 配置级别)
  - [13.3 文件结构](#13.3 文件结构)
  - [13.4 SKILL.md 格式](#13.4 SKILL.md 格式)
  - [13.5 编写原则](#13.5 编写原则)
  - [13.6 高级技巧](#13.6 高级技巧)
- [14. 最常用配置推荐](#14. 最常用配置推荐)
- - [14.1 个人开发者配置](#14.1 个人开发者配置)
  - [14.2 团队项目配置](#14.2 团队项目配置)
  - [14.3 全栈开发配置](#14.3 全栈开发配置)
  - [14.4 快速启动配置](#14.4 快速启动配置)
- [15. 下一步行动](#15. 下一步行动)
- - [15.1 立即行动清单](#15.1 立即行动清单)
  - [15.2 持续学习建议](#15.2 持续学习建议)
  - [15.3 获取帮助](#15.3 获取帮助)
  - [15.4 贡献社区](#15.4 贡献社区)
- 附录
- [附录 A：常见错误代码](#附录 A：常见错误代码)
- - [A.1 错误代码表](#A.1 错误代码表)
  - [A.2 详细错误说明](#A.2 详细错误说明)
  - - [错误 1：SKILL_NOT_FOUND](#错误 1：SKILL_NOT_FOUND)
    - [错误 2：INVALID_FRONTMATTER](#错误 2：INVALID_FRONTMATTER)
    - [错误 3：TOOL_NOT_ALLOWED](#错误 3：TOOL_NOT_ALLOWED)
- [附录 B：调试技巧](#附录 B：调试技巧)
- - [B.1 基本调试命令](#B.1 基本调试命令)
  - [B.2 检查 Skill 配置](#B.2 检查 Skill 配置)
  - [B.3 调试工作流](#B.3 调试工作流)
  - - [步骤 1：确认 Skill 已加载](#步骤 1：确认 Skill 已加载)
    - [步骤 2：测试手动调用](#步骤 2：测试手动调用)
    - [步骤 3：测试自动触发](#步骤 3：测试自动触发)
    - [步骤 4：检查工具权限](#步骤 4：检查工具权限)
  - [B.4 常见问题排查](#B.4 常见问题排查)
  - - [问题 1：Skill 不触发](#问题 1：Skill 不触发)
    - [问题 2：参数传递失败](#问题 2：参数传递失败)
    - [问题 3：命令注入失败](#问题 3：命令注入失败)
- [附录 C：性能优化清单](#附录 C：性能优化清单)
- - [C.1 优化 Description](#C.1 优化 Description)
  - [C.2 优化 Skill 内容](#C.2 优化 Skill 内容)
  - [C.3 管理 Skills 数量](#C.3 管理 Skills 数量)
  - [C.4 监控上下文使用](#C.4 监控上下文使用)
  - [C.5 优化工具访问](#C.5 优化工具访问)
  - [C.6 性能检查清单](#C.6 性能检查清单)

系列导航

[第 1 篇：入门实战篇 - 快速上手 Claude Code Skills](#第 1 篇：入门实战篇 - 快速上手 Claude Code Skills)

[第 2 篇：开发进阶篇 - 创建与管理自定义 Skills](#第 2 篇：开发进阶篇 - 创建与管理自定义 Skills)

第 3 篇：精通参考篇 - 进阶技巧与完整手册（当前）
本篇概要

本文是 Claude Code Skills 系列的第 3 篇（完结篇），将深入讲解高级技巧、提供完整的快速参考手册，并汇总所有学习资源。阅读完本篇后，你将掌握 Skills 的全部核心知识，形成完整的知识体系。
适用系统 ：Windows 10/11
命令行工具 ：优先使用 CMD，复杂操作使用 PowerShell
预计阅读时间 ：25-35 分钟
前置要求：已阅读第 1、2 篇，掌握 Skills 基础和开发

第一部分：进阶技巧

1. 组合使用多个 Skills

1.1 完整的开发工作流

场景：从需求到部署的完整流程

创建工作流 Skill

目录结构：

复制代码

.claude\skills\feature-workflow\
└── SKILL.md

SKILL.md 内容：

markdown 复制代码

---
name: feature-workflow
description: 完整的功能开发流程
---

# Feature Development Workflow

完整的功能开发流程，包含规划、开发、测试、文档和部署。

## 工作流程

### 1. 需求分析阶段
使用 `/planning` Skill 分析需求：
- 理解用户需求
- 拆分任务
- 评估工作量

### 2. 代码实现阶段
遵循 `/coding-standards` Skill：
- 按照团队编码规范
- 实现核心功能
- 添加必要注释

### 3. 测试编写阶段
使用 `/test-generator` Skill：
- 生成单元测试
- 编写集成测试
- 确保测试覆盖率

### 4. 代码审查阶段
使用 `/code-review` Skill：
- 检查代码质量
- 发现潜在问题
- 提出改进建议

### 5. 文档生成阶段
使用 `/api-doc-generator` Skill：
- 生成 API 文档
- 更新 README
- 添加使用示例

### 6. 提交代码阶段
使用 `/commit-message` Skill：
- 生成规范的提交信息
- 遵循 Conventional Commits
- 关联 Issue

### 7. 部署测试阶段
使用 `/deploy-staging` Skill：
- 部署到测试环境
- 运行冒烟测试
- 验证功能正常

## 使用方法
/feature-workflow [feature-name]

## 示例
/feature-workflow user-authentication

1.2 Skills 协作模式

模式 1：顺序执行

markdown 复制代码

---
name: release-process
description: 发布流程
---

# Release Process

## 步骤 1：代码冻结
运行 `/code-freeze` 检查是否有未完成的工作

## 步骤 2：版本更新
运行 `/bump-version` 更新版本号

## 步骤 3：生成变更日志
运行 `/generate-changelog` 生成 CHANGELOG.md

## 步骤 4：构建发布包
运行 `/build-release` 构建生产版本

## 步骤 5：部署生产
运行 `/deploy-prod` 部署到生产环境

## 步骤 6：发布通知
运行 `/notify-release` 发送发布通知

模式 2：并行执行

markdown 复制代码

---
name: quality-check
description: 质量检查（并行）
---

# Quality Check

同时运行多个检查，提高效率。

## 并行任务
请同时执行以下检查：
1. `/lint-check` - 代码风格检查
2. `/security-scan` - 安全漏洞扫描
3. `/performance-test` - 性能测试
4. `/accessibility-check` - 可访问性检查

## 汇总结果
等待所有检查完成后，生成综合报告。

模式 3：条件分支

markdown 复制代码

---
name: smart-test
description: 智能测试
---

# Smart Test

根据代码变更智能选择测试策略。

## 检测变更
!git diff --name-only HEAD~1"

## 测试策略
- 如果只修改了文档 → 跳过测试
- 如果修改了前端代码 → 运行 `/test-frontend`
- 如果修改了后端代码 → 运行 `/test-backend`
- 如果修改了数据库 → 运行 `/test-migration`
- 如果修改了多个部分 → 运行 `/test-all`

1.3 实战案例：CI/CD 工作流

目录结构：

复制代码

.claude\skills\ci-cd-workflow\
├── SKILL.md
└── scripts\
    ├── run-tests.cmd
    └── deploy.ps1

SKILL.md：

markdown 复制代码

---
name: ci-cd-workflow
description: CI/CD 自动化流程
disable-model-invocation: true
user-invocable: true
---

# CI/CD Workflow

自动化的持续集成和部署流程。

## 触发条件
当代码推送到 Git 仓库时自动执行。

## CI 阶段（持续集成）

### 1. 代码检查
!git diff --name-only HEAD~1"
检查哪些文件被修改

### 2. 运行 Linter
!npm run lint"
或
!python -m pylint src\"

### 3. 运行测试
!scripts\run-tests.cmd"

### 4. 构建项目
!npm run build"
或
!python setup.py build"

### 5. 生成报告
- 测试覆盖率报告
- 代码质量报告
- 构建日志

## CD 阶段（持续部署）

### 6. 部署到测试环境
如果所有测试通过：
!powershell -File scripts\deploy.ps1 -Environment staging"

### 7. 运行冒烟测试
验证部署是否成功

### 8. 部署到生产环境（可选）
如果是 main 分支且测试通过：
!powershell -File scripts\deploy.ps1 -Environment production"

## 通知
发送部署结果通知到团队频道

2. 条件执行与动态配置

2.1 基于环境的条件执行

检测当前环境

markdown 复制代码

---
name: smart-deploy
description: 智能部署
---

# Smart Deploy

根据当前分支和环境自动选择部署目标。

## 检测当前分支
!git branch --show-current"

## 检测环境变量
当前环境：%NODE_ENV%

## 部署逻辑

### 如果是 main 分支
- 目标：生产环境
- 域名：https://app.example.com
- 需要：人工确认

### 如果是 develop 分支
- 目标：测试环境
- 域名：https://staging.example.com
- 自动部署

### 如果是 feature/* 分支
- 目标：开发环境
- 域名：https://dev.example.com
- 自动部署

## 执行部署
根据上述逻辑选择合适的部署命令。

2.2 基于项目类型的动态配置

markdown 复制代码

---
name: project-setup
description: 项目初始化
---

# Project Setup

根据项目类型自动配置开发环境。

## 检测项目类型

### 检查 Node.js 项目
!if exist package.json echo Node.js"

### 检查 Python 项目
!if exist requirements.txt echo Python"

### 检查 Java 项目
!if exist pom.xml echo Java"

### 检查 .NET 项目
!if exist *.csproj echo DotNet"

## 初始化步骤

### 如果是 Node.js 项目
1. 安装依赖：`npm install`
2. 配置 ESLint
3. 配置 Prettier
4. 设置 Git hooks

### 如果是 Python 项目
1. 创建虚拟环境：`python -m venv venv`
2. 激活虚拟环境：`venv\Scripts\activate`
3. 安装依赖：`pip install -r requirements.txt`
4. 配置 Black 和 Flake8

### 如果是 Java 项目
1. 检查 Maven/Gradle
2. 下载依赖
3. 配置 IDE

### 如果是 .NET 项目
1. 恢复 NuGet 包：`dotnet restore`
2. 构建项目：`dotnet build`
3. 配置 EditorConfig

## 通用配置
- 初始化 Git（如果未初始化）
- 创建 .gitignore
- 创建 README.md

2.3 基于用户输入的动态行为

markdown 复制代码

---
name: flexible-generator
description: 灵活的代码生成器
argument-hint: [type] [name] [options]
---

# Flexible Code Generator

根据用户输入动态生成不同类型的代码。

## 参数说明
- $0: 类型（component/service/model/test）
- $1: 名称
- $2+: 可选参数

## 生成逻辑

### 如果 $0 = "component"
生成组件代码：
- React 组件（默认）
- Vue 组件（如果 $2 = "vue"）
- Angular 组件（如果 $2 = "angular"）

### 如果 $0 = "service"
生成服务代码：
- RESTful API 服务
- GraphQL 服务（如果 $2 = "graphql"）
- gRPC 服务（如果 $2 = "grpc"）

### 如果 $0 = "model"
生成数据模型：
- TypeScript 接口
- Python 数据类
- Java POJO

### 如果 $0 = "test"
生成测试代码：
- 单元测试
- 集成测试（如果 $2 = "integration"）
- E2E 测试（如果 $2 = "e2e"）

## 使用示例
/flexible-generator component Button
/flexible-generator service UserAPI graphql
/flexible-generator model User
/flexible-generator test UserService integration

3. 链式调用与工作流

3.1 创建链式工作流

示例：完整的 PR 流程

markdown 复制代码

---
name: pr-workflow
description: Pull Request 完整流程
---

# Pull Request Workflow

从创建到合并的完整 PR 流程。

## 阶段 1：准备 PR
1. 运行 `/code-review` 自我审查
2. 运行 `/test-all` 确保测试通过
3. 运行 `/lint-fix` 修复代码风格问题

## 阶段 2：创建 PR
1. 运行 `/commit-message` 生成提交信息
2. 提交代码：`git commit`
3. 推送分支：`git push`
4. 运行 `/create-pr` 创建 Pull Request

## 阶段 3：PR 描述
1. 运行 `/pr-description` 生成 PR 描述
2. 添加相关标签
3. 指定审查者

## 阶段 4：CI 检查
等待 CI 流程完成：
- 代码风格检查
- 单元测试
- 集成测试
- 构建验证

## 阶段 5：代码审查
1. 通知审查者
2. 回应审查意见
3. 必要时运行 `/fix-review-comments`

## 阶段 6：合并 PR
1. 确保所有检查通过
2. 获得必要的批准
3. 运行 `/merge-pr` 合并代码
4. 删除特性分支

## 阶段 7：后续工作
1. 运行 `/update-changelog` 更新变更日志
2. 运行 `/deploy-staging` 部署到测试环境
3. 通知相关人员

3.2 错误处理与回滚

markdown 复制代码

---
name: safe-deploy
description: 安全部署（带回滚）
---

# Safe Deploy with Rollback

带有错误处理和自动回滚的安全部署流程。

## 部署前检查
1. 检查目标环境状态
2. 备份当前版本
3. 验证部署权限

## 部署步骤
1. 运行 `/build-release` 构建发布包
2. 运行健康检查
3. 如果健康检查失败 → 跳转到回滚流程

## 部署执行
1. 停止旧版本服务
2. 部署新版本
3. 启动新版本服务
4. 等待服务就绪

## 部署后验证
1. 运行冒烟测试
2. 检查关键指标
3. 监控错误日志

## 如果验证失败
### 自动回滚流程
1. 停止新版本服务
2. 恢复旧版本
3. 重启服务
4. 验证回滚成功
5. 发送告警通知

## 如果验证成功
1. 清理旧版本备份
2. 更新部署记录
3. 发送成功通知

3.3 并行任务协调

markdown 复制代码

---
name: parallel-tasks
description: 并行任务协调
---

# Parallel Tasks Coordinator

协调多个并行任务的执行和结果汇总。

## 任务定义
定义需要并行执行的任务列表：
- 任务 A：前端构建
- 任务 B：后端构建
- 任务 C：数据库迁移
- 任务 D：文档生成

## 并行执行
同时启动所有任务：
1. 启动 `/build-frontend` → 任务 A
2. 启动 `/build-backend` → 任务 B
3. 启动 `/migrate-db` → 任务 C
4. 启动 `/generate-docs` → 任务 D

## 进度监控
监控每个任务的执行状态：
- ✅ 任务 A：完成
- ⏳ 任务 B：进行中
- ⏳ 任务 C：进行中
- ✅ 任务 D：完成

## 结果汇总
等待所有任务完成后：
1. 收集每个任务的输出
2. 检查是否有失败的任务
3. 生成综合报告

## 错误处理
如果任何任务失败：
1. 记录失败原因
2. 取消依赖的后续任务
3. 清理中间产物
4. 发送失败通知

4. 模板系统

4.1 创建模板驱动的 Skill

目录结构

复制代码

.claude\skills\component-generator\
├── SKILL.md
└── templates\
    ├── react-component.tsx
    ├── vue-component.vue
    ├── component.test.ts
    └── component.stories.ts

SKILL.md

markdown 复制代码

---
name: component-generator
description: 生成组件代码
argument-hint: [component-name] [framework]
---

# Component Generator

基于模板生成组件代码。

## 支持的框架
- React（默认）
- Vue
- Angular

## 模板文件
- `templates/react-component.tsx`: React 组件模板
- `templates/vue-component.vue`: Vue 组件模板
- `templates/component.test.ts`: 测试模板
- `templates/component.stories.ts`: Storybook 模板

## 使用方法
/component-generator Button React

## 生成内容
1. 组件文件（根据框架选择模板）
2. 样式文件（CSS/SCSS）
3. 测试文件
4. Storybook 文件（可选）

## 模板变量替换
- {{COMPONENT_NAME}}: 组件名称
- {{COMPONENT_NAME_LOWER}}: 小写组件名
- {{COMPONENT_NAME_KEBAB}}: kebab-case 组件名
- {{AUTHOR}}: 作者名称
- {{DATE}}: 创建日期

React 组件模板（templates/react-component.tsx）

typescript 复制代码

import React from 'react';
import './{{COMPONENT_NAME_KEBAB}}.css';

interface {{COMPONENT_NAME}}Props {
  // TODO: 定义组件属性
}

/**
 * {{COMPONENT_NAME}} 组件
 * 
 * @author {{AUTHOR}}
 * @date {{DATE}}
 */
export const {{COMPONENT_NAME}}: React.FC<{{COMPONENT_NAME}}Props> = (props) => {
  return (
    <div className="{{COMPONENT_NAME_KEBAB}}">
      {/* TODO: 实现组件内容 */}
    </div>
  );
};

export default {{COMPONENT_NAME}};

测试模板（templates/component.test.ts）

typescript 复制代码

import { render, screen } from '@testing-library/react';
import { {{COMPONENT_NAME}} } from './{{COMPONENT_NAME}}';

describe('{{COMPONENT_NAME}}', () => {
  it('should render successfully', () => {
    render(<{{COMPONENT_NAME}} />);
    // TODO: 添加断言
  });

  it('should handle props correctly', () => {
    // TODO: 测试属性处理
  });

  it('should handle user interactions', () => {
    // TODO: 测试用户交互
  });
});

4.2 高级模板技巧

条件模板

markdown 复制代码

---
name: api-endpoint-generator
description: 生成 API 端点
argument-hint: [method] [path] [auth]
---

# API Endpoint Generator

## 参数
- $0: HTTP 方法（GET/POST/PUT/DELETE）
- $1: API 路径
- $2: 是否需要认证（yes/no）

## 模板选择
根据 HTTP 方法选择不同的模板：
- GET → 使用 `templates/get-endpoint.ts`
- POST → 使用 `templates/post-endpoint.ts`
- PUT → 使用 `templates/put-endpoint.ts`
- DELETE → 使用 `templates/delete-endpoint.ts`

## 认证处理
如果 $2 = "yes"：
- 添加认证中间件
- 添加权限检查
- 添加用户上下文

## 生成内容
1. 端点处理函数
2. 请求验证
3. 响应格式化
4. 错误处理
5. API 文档注释

多文件模板

markdown 复制代码

---
name: feature-scaffold
description: 功能模块脚手架
argument-hint: [feature-name]
---

# Feature Scaffold

生成完整的功能模块文件结构。

## 生成的文件结构

src/features/{{FEATURE_NAME}}/

├── index.ts # 导出文件

├── {{FEATURE_NAME}}.service.ts # 服务层

├── {{FEATURE_NAME}}.controller.ts # 控制器

├── {{FEATURE_NAME}}.model.ts # 数据模型

├── {{FEATURE_NAME}}.dto.ts # 数据传输对象

├── {{FEATURE_NAME}}.test.ts # 测试文件

└── README.md # 功能说明

复制代码

## 模板文件
- `templates/feature/service.ts`
- `templates/feature/controller.ts`
- `templates/feature/model.ts`
- `templates/feature/dto.ts`
- `templates/feature/test.ts`
- `templates/feature/README.md`

## 使用方法
/feature-scaffold user-management

5. 子代理与工具限制

5.1 使用子代理（Subagent）

什么是子代理

子代理是在隔离环境中运行的 Claude 实例，具有以下特点：

独立的上下文
可限制的工具访问
专注的任务执行

配置子代理

markdown 复制代码

---
name: safe-code-analysis
description: 安全的代码分析
context: fork
agent: general-purpose
allowed-tools:
  - readFile
  - readMultipleFiles
  - listDirectory
  - grepSearch
  - fileSearch
---

# Safe Code Analysis

在隔离环境中分析代码，不会修改任何文件。

## 分析任务
1. 扫描项目结构
2. 识别代码模式
3. 检测潜在问题
4. 生成分析报告

## 限制
- 只读访问
- 不能修改文件
- 不能执行命令
- 不能访问网络

## 输出
生成详细的分析报告，包括：
- 代码质量评分
- 潜在问题列表
- 改进建议
- 最佳实践对比

5.2 工具访问限制

只读模式

yaml 复制代码

---
name: code-explorer
description: 代码浏览器（只读）
allowed-tools:
  - readFile
  - readMultipleFiles
  - listDirectory
  - grepSearch
  - fileSearch
---

文件操作模式

yaml 复制代码

---
name: code-refactor
description: 代码重构
allowed-tools:
  - readFile
  - readMultipleFiles
  - listDirectory
  - grepSearch
  - fileSearch
  - strReplace
  - fsWrite
  - fsAppend
---

完全访问模式

yaml 复制代码

---
name: full-automation
description: 完全自动化
# 不设置 allowed-tools，允许访问所有工具
---

5.3 安全最佳实践

敏感操作的安全配置

markdown 复制代码

---
name: deploy-prod
description: 部署到生产环境
disable-model-invocation: true  # 禁止 AI 自动调用
user-invocable: true            # 只能手动调用
allowed-tools:
  - executePwsh                 # 只允许执行命令
---

# Deploy to Production

⚠️ **警告**：这是生产环境部署操作，请谨慎执行！

## 前置检查
1. 确认当前分支是 main
2. 确认所有测试通过
3. 确认有部署权限
4. 确认备份已完成

## 部署步骤
1. 构建生产版本
2. 运行预部署检查
3. 执行部署脚本
4. 验证部署成功
5. 更新部署记录

## 回滚计划
如果部署失败，立即执行回滚：
1. 停止新版本
2. 恢复旧版本
3. 验证服务正常
4. 记录失败原因

数据操作的安全配置

markdown 复制代码

---
name: db-migration
description: 数据库迁移
disable-model-invocation: true
user-invocable: true
---

# Database Migration

⚠️ **警告**：数据库操作不可逆，请务必先备份！

## 前置要求
- [ ] 已备份数据库
- [ ] 已在测试环境验证
- [ ] 已获得 DBA 批准
- [ ] 已通知相关团队

## 迁移步骤
1. 检查数据库连接
2. 验证迁移脚本
3. 创建数据库备份
4. 执行迁移脚本
5. 验证数据完整性
6. 更新迁移记录

## 回滚步骤
如果迁移失败：
1. 停止应用服务
2. 恢复数据库备份
3. 验证数据一致性
4. 重启应用服务
5. 记录失败原因

第二部分：快速参考

6. 命令速查表

6.1 Claude Code 基本命令

命令	说明	示例
`/skills`	列出所有可用的 Skills	`/skills`
`/skill-name`	手动调用指定 Skill	`/api-doc POST /users`
`/context`	查看当前上下文使用情况	`/context`
`/permissions`	管理工具权限	`/permissions`
`/plugin marketplace add`	添加插件市场	`/plugin marketplace add anthropics/skills`
`/plugin marketplace list`	列出市场中的插件	`/plugin marketplace list`
`/plugin install`	安装插件	`/plugin install document-skills@anthropic-agent-skills`
`/plugin list`	列出已安装的插件	`/plugin list`
`/plugin update`	更新插件	`/plugin update document-skills`
`/plugin uninstall`	卸载插件	`/plugin uninstall document-skills`

6.2 Windows 文件操作命令（CMD）

命令	说明	示例
`mkdir`	创建目录	`mkdir .claude\skills\my-skill`
`dir`	列出目录内容	`dir %USERPROFILE%\.claude\skills`
`type`	查看文件内容	`type SKILL.md`
`copy`	复制文件	`copy SKILL.md backup.md`
`xcopy`	复制目录	`xcopy /E /I source dest`
`del`	删除文件	`del SKILL.md`
`rmdir`	删除目录	`rmdir /S /Q my-skill`
`cd`	切换目录	`cd .claude\skills`
`echo`	显示文本或变量	`echo %USERPROFILE%`
`explorer`	打开文件资源管理器	`explorer .claude`

6.3 Git 常用命令

命令	说明	示例
`git clone`	克隆仓库	`git clone https://github.com/anthropics/skills.git`
`git pull`	拉取更新	`git pull`
`git status`	查看状态	`git status`
`git add`	添加文件	`git add .claude\skills\`
`git commit`	提交更改	`git commit -m "feat: add new skill"`
`git push`	推送到远程	`git push`
`git branch`	查看分支	`git branch --show-current`
`git diff`	查看差异	`git diff`
`git log`	查看提交历史	`git log --oneline -5`

6.4 环境变量

变量	说明	CMD 访问	PowerShell 访问
用户主目录	当前用户的主目录	`%USERPROFILE%`	`$env:USERPROFILE`
当前目录	当前工作目录	`%CD%`	`$PWD`
系统盘符	系统盘符（通常是 C:）	`%SystemDrive%`	`$env:SystemDrive`
临时目录	临时文件目录	`%TEMP%`	`$env:TEMP`
用户名	当前用户名	`%USERNAME%`	`$env:USERNAME`

7. 目录结构速查

7.1 个人级配置

复制代码

C:\Users\你的用户名\.claude\
└── skills\                             # 个人级 Skills 目录
    ├── code-review\                    # Skill 1
    │   ├── SKILL.md                    # 必需：Skill 配置文件
    │   ├── scripts\                    # 可选：脚本目录
    │   │   └── review.py
    │   └── templates\                  # 可选：模板目录
    │       └── report.md
    ├── api-doc\                        # Skill 2
    │   └── SKILL.md
    └── test-generator\                 # Skill 3
        └── SKILL.md

访问路径：

CMD: %USERPROFILE%\.claude\skills\
PowerShell: $env:USERPROFILE\.claude\skills\
完整路径: C:\Users\你的用户名\.claude\skills\

7.2 项目级配置

复制代码

D:\Projects\your-project\               # 项目根目录
├── .claude\                            # Claude Code 配置目录
│   └── skills\                         # 项目级 Skills 目录
│       ├── deploy-prod\                # Skill 1
│       │   ├── SKILL.md
│       │   └── scripts\
│       │       └── deploy.ps1
│       ├── coding-standards\           # Skill 2
│       │   ├── SKILL.md
│       │   └── references\
│       │       └── style-guide.md
│       └── pr-template\                # Skill 3
│           └── SKILL.md
├── src\                                # 项目源代码
├── package.json
├── .git\
└── README.md

访问路径：

相对路径: .claude\skills\
绝对路径: D:\Projects\your-project\.claude\skills\

7.3 Skill 内部结构

复制代码

.claude\skills\my-skill\                # Skill 根目录
├── SKILL.md                            # 必需：核心配置文件
├── README.md                           # 推荐：使用说明
├── scripts\                            # 可选：可执行脚本
│   ├── process.py                      # Python 脚本
│   ├── analyze.js                      # JavaScript 脚本
│   └── deploy.ps1                      # PowerShell 脚本
├── templates\                          # 可选：输出模板
│   ├── report-template.md              # Markdown 模板
│   ├── code-template.ts                # 代码模板
│   └── config-template.json            # 配置模板
└── references\                         # 可选：参考文档
    ├── api-spec.md                     # API 规范
    ├── database-schema.sql             # 数据库结构
    └── style-guide.md                  # 代码风格指南

7.4 多仓库管理结构

复制代码

C:\Users\你的用户名\
├── .claude\                            # 个人级配置
│   └── skills\                         # 已安装的 Skills
│       ├── document-skills\
│       ├── code-review\
│       └── api-generator\
└── claude-skills-repos\                # Skills 仓库存放目录
    ├── anthropics\                     # Anthropic 官方仓库
    │   └── skills\
    │       ├── document-skills\
    │       ├── code-review\
    │       └── test-generator\
    ├── superpowers\                    # Superpowers 仓库
    │   └── skills\
    │       ├── planning\
    │       ├── implementation\
    │       └── testing\
    └── jeffallan\                      # Jeffallan 仓库
        └── skills\
            ├── react-helper\
            ├── api-generator\
            └── db-migration\

8. Frontmatter 速查表

8.1 所有可用字段

yaml 复制代码

---
# 基本信息
name: my-skill                          # Skill 名称（小写、连字符，最多 64 字符）
description: 简短描述功能                # 功能描述（重要！用于触发判断）

# 参数配置
argument-hint: [arg1] [arg2]            # 参数提示

# 调用控制
disable-model-invocation: false         # 是否禁止 AI 自动调用（默认 false）
user-invocable: true                    # 是否在 / 菜单中显示（默认 true）

# 工具限制
allowed-tools:                          # 允许使用的工具列表（空 = 无限制）
  - readFile
  - strReplace

# 模型配置
model: claude-3-5-sonnet-20241022       # 指定使用的模型

# 子代理配置
context: inline                         # inline（默认）或 fork（子代理）
agent: general-purpose                  # 子代理类型（需配合 context: fork）
---

8.2 常用配置组合

配置 1：默认 Skill（双向调用）

yaml 复制代码

---
name: code-review
description: 代码审查
---

特点：

AI 可以自动调用
用户可以手动调用
无工具限制

配置 2：仅手动调用（敏感操作）

yaml 复制代码

---
name: deploy-prod
description: 部署到生产环境
disable-model-invocation: true
user-invocable: true
---

特点：

AI 不能自动调用
用户可以手动调用
适合敏感操作

配置 3：仅 AI 调用（背景知识）

yaml 复制代码

---
name: coding-standards
description: 编码规范
disable-model-invocation: false
user-invocable: false
---

特点：

AI 可以自动加载
不在菜单中显示
适合背景知识

配置 4：只读模式

yaml 复制代码

---
name: code-explorer
description: 代码浏览器
allowed-tools:
  - readFile
  - readMultipleFiles
  - listDirectory
  - grepSearch
  - fileSearch
---

特点：

只能读取文件
不能修改文件
适合分析任务

配置 5：子代理模式

yaml 复制代码

---
name: safe-analysis
description: 安全分析
context: fork
agent: general-purpose
allowed-tools:
  - readFile
  - grepSearch
---

特点：

在隔离环境运行
独立的上下文
受限的工具访问

9. 变量替换速查

9.1 参数变量

变量	说明	示例
`$ARGUMENTS`	所有参数（空格分隔）	用户输入 `/skill a b c` → `$ARGUMENTS` = `a b c`
`$0` 或 `$ARGUMENTS[0]`	第一个参数	用户输入 `/skill a b c` → `$0` = `a`
`$1` 或 `$ARGUMENTS[1]`	第二个参数	用户输入 `/skill a b c` → `$1` = `b`
`$2` 或 `$ARGUMENTS[2]`	第三个参数	用户输入 `/skill a b c` → `$2` = `c`

9.2 使用示例

示例 1：单个参数

markdown 复制代码

---
name: fix-issue
argument-hint: [issue-number]
---

修复 Issue #$ARGUMENTS

使用：/fix-issue 123
结果：修复 Issue #123

示例 2：多个参数

markdown 复制代码

---
name: migrate-component
argument-hint: [component] [from] [to]
---

将组件 $0 从 $1 迁移到 $2

使用：/migrate-component Button React Vue
结果：将组件 Button 从 React 迁移到 Vue

示例 3：可选参数

markdown 复制代码

---
name: deploy
argument-hint: [environment] [version]
---

部署到 $0 环境
版本：$1（如果未提供，使用最新版本）

使用 1 ：/deploy staging v1.2.3
结果：部署到 staging 环境，版本：v1.2.3

使用 2 ：/deploy production
结果：部署到 production 环境，版本：（如果未提供，使用最新版本）

9.3 命令注入变量

语法	说明	示例
`!command"`	执行命令并替换为输出	`!git branch --show-current"`

示例 1：获取当前分支

markdown 复制代码

当前分支：!git branch --show-current"

结果：当前分支：main

示例 2：获取文件列表

markdown 复制代码

修改的文件：
!git diff --name-only HEAD~1"

结果：

复制代码

修改的文件：
src/index.ts
src/utils.ts
README.md

示例 3：获取系统信息

markdown 复制代码

用户主目录：!echo %USERPROFILE%"
当前目录：!cd"

结果：

复制代码

用户主目录：C:\Users\张三
当前目录：D:\Projects\my-project

9.4 环境变量

变量	CMD 语法	PowerShell 语法	说明
用户主目录	`%USERPROFILE%`	`$env:USERPROFILE`	C:\Users\你的用户名
当前目录	`%CD%`	`$PWD`	当前工作目录
用户名	`%USERNAME%`	`$env:USERNAME`	当前用户名
临时目录	`%TEMP%`	`$env:TEMP`	临时文件目录

使用示例

markdown 复制代码

---
name: show-env
description: 显示环境信息
---

# 环境信息

用户：%USERNAME%
主目录：%USERPROFILE%
当前目录：%CD%
临时目录：%TEMP%

第三部分：学习资源

10. 官方资源

10.1 官方文档

📚 Anthropic 官方文档

网址：https://docs.anthropic.com/en/docs/claude-code/skills

内容包括：

Skills 概念介绍
配置指南
API 参考
最佳实践

推荐阅读顺序：

Getting Started（快速开始）
Skills Configuration（配置指南）
Best Practices（最佳实践）
API Reference（API 参考）

10.2 官方仓库

💻 Anthropic Skills 仓库

网址：https://github.com/anthropics/skills

包含内容：

官方维护的 Skills
使用示例
贡献指南
问题追踪

推荐 Skills：

document-skills：文档处理
code-review：代码审查
test-generator：测试生成

10.3 Agent Skills 标准

🎓 Agent Skills 开放标准

网址：https://github.com/anthropics/agent-skills

内容：

Skills 标准规范
跨工具兼容性
标准演进历史

适合人群：

想深入理解 Skills 机制
需要开发跨平台 Skills
参与标准制定

11. 社区资源

11.1 Superpowers ⭐⭐⭐⭐⭐

GitHub ：https://github.com/obra/superpowers
Stars：16,000+

核心理念 ：

强制 Claude 按照世界级高级工程师的标准流程工作。

包含的 Skills：

📋 需求分析与规划
🏗️ 架构设计
💻 代码实现
🧪 测试策略
📚 文档生成
🚀 部署流程

适合人群：

追求高质量代码
需要完整开发流程
希望 AI 遵循最佳实践

11.2 Jeffallan/claude-skills

GitHub：https://github.com/Jeffallan/claude-skills

特点：

65 个专业化 Skills
专为全栈开发者设计
技术栈覆盖：React、Vue、Node.js、Python、Database、DevOps

推荐 Skills：

React 组件生成器
API 端点生成器
数据库迁移助手

11.3 Awesome Claude Skills

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

内容：

精选的 Skills 列表
定期更新
社区驱动
包含使用教程

使用建议：

浏览精选列表
查看用户评价
参考使用教程

11.4 Skills 市场平台

🌐 SkillsMP

网址：https://skillsmp.com/zh

统计数据：

📦 Skills 总数：58,000+
🔍 支持 AI 智能搜索
📂 完善的分类体系
🌐 中文界面支持

使用技巧：

使用 AI 搜索功能描述需求
按分类浏览相关 Skills
查看用户评分和下载量
阅读使用文档和示例

分类体系：

开发工具
代码生成
测试工具
文档工具
DevOps
数据分析

11.5 中文教程

📖 CSDN 博客教程

网址：https://www.cnblogs.com/jiafeng1323/p/19561565

内容：

中文详细教程
实战案例
常见问题解答

适合人群：

中文用户
需要详细步骤
实战导向

12. 实践建议

12.1 学习路径

第一周：基础使用

目标：熟悉 Skills 基本概念和使用方法

任务清单：

推荐 Skills：

document-skills
code-review
test-generator

学习资源：

阅读第 1 篇：入门实战篇
观看官方视频教程
浏览官方文档

第二周：自定义 Skills

目标：创建自己的第一个 Skill

任务清单：

实战项目：

创建个人代码风格检查 Skill
创建 Git 提交信息生成 Skill
创建项目文档生成 Skill

学习资源：

阅读第 2 篇：开发进阶篇
参考官方 Skills 源码
查看社区示例

第三周：高级功能

目标：掌握高级特性和技巧

任务清单：

实战项目：

创建完整的开发工作流 Skill
创建带模板的代码生成器
创建安全的部署 Skill

学习资源：

阅读第 3 篇：精通参考篇
研究 Superpowers 源码
参与社区讨论

第四周：团队协作

目标：在团队中推广和使用 Skills

任务清单：

实战项目：

创建团队编码规范 Skill
创建 PR 模板 Skill
创建部署流程 Skill

学习资源：

参考企业最佳实践
学习团队协作案例
建立内部知识库

12.2 最佳实践建议

1. 从简单开始

❌ 不推荐：第一个 Skill 就尝试复杂功能

markdown 复制代码

---
name: super-skill
description: 做所有事情的万能 Skill
---

支持：
- 代码生成
- 测试编写
- 文档生成
- 部署
- 监控
- ...

✅ 推荐：从简单的单一功能开始

markdown 复制代码

---
name: commit-message
description: 生成 Git 提交信息
---

# Commit Message Generator

根据代码变更生成规范的提交信息。

## 步骤
1. 查看代码变更
2. 分析变更类型
3. 生成提交信息

2. 迭代改进

第一版：基本功能

markdown 复制代码

---
name: code-review
description: 代码审查
---

审查代码质量和潜在问题。

第二版：添加详细指令

markdown 复制代码

---
name: code-review
description: 代码审查
---

# Code Review

## 审查内容
1. 代码风格
2. 潜在 bug
3. 性能问题
4. 安全隐患

第三版：添加参数和模板

markdown 复制代码

---
name: code-review
description: 代码审查
argument-hint: [file-path]
---

# Code Review

审查文件：$ARGUMENTS

## 审查清单
- [ ] 代码风格
- [ ] 潜在 bug
- [ ] 性能问题
- [ ] 安全隐患

## 输出格式
使用 `templates/review-report.md` 模板

3. 记录和分享

创建 README.md：

markdown 复制代码

# Skill: code-review

## 用途
自动化代码审查，检查代码质量和潜在问题。

## 使用方法
/code-review [file-path]

## 示例
/code-review src/index.ts

## 审查内容
- 代码风格
- 潜在 bug
- 性能问题
- 安全隐患

## 输出
生成详细的审查报告，包括问题列表和改进建议。

## 依赖
无

## 作者
张三

## 更新日期
2025-01-20

4. 定期维护

维护清单：

更新流程：

cmd 复制代码

# 1. 更新仓库（CMD）
cd %USERPROFILE%\claude-skills-repos\anthropics
git pull

# 2. 检查变更
git log --oneline -10

# 3. 如果有更新，重新复制
xcopy /E /I /Y skills\document-skills %USERPROFILE%\.claude\skills\document-skills\

# 4. 重启 Claude Code 测试

12.3 常见陷阱

陷阱 1：Description 过于复杂

❌ 错误：

yaml 复制代码

description: 这是一个用于生成、审查、优化、测试和部署代码的综合工具，支持多种编程语言和框架，包括但不限于 JavaScript、TypeScript、Python、Java、C#...

✅ 正确：

yaml 复制代码

description: 代码生成和审查

陷阱 2：过度预判

❌ 错误：

markdown 复制代码

如果用户想要 A，则执行 X
如果用户想要 B，则执行 Y
如果用户想要 C，则执行 Z
如果用户没说清楚，则询问...
如果用户改变主意，则...

✅ 正确：

markdown 复制代码

执行以下步骤：
1. 分析需求
2. 实施方案
3. 验证结果

陷阱 3：忽略安全

❌ 错误：

markdown 复制代码

---
name: deploy
---

部署命令：!$ARGUMENTS"

✅ 正确：

markdown 复制代码

---
name: deploy
disable-model-invocation: true
---

# Deploy

⚠️ 警告：生产环境部署

## 前置检查
- 确认环境
- 验证权限
- 备份数据

## 部署步骤
1. 构建
2. 测试
3. 部署

第四部分：总结

13. 核心要点回顾

13.1 Skills 的本质

✅ Skills 是什么：

可重用的 AI 工作流模块
将指令、上下文和工具访问权限打包
支持版本控制和团队共享
遵循 Agent Skills 开放标准

✅ Skills 的价值：

提升开发效率
标准化工作流程
封装最佳实践
促进团队协作

13.2 配置级别

级别	路径	优先级	适用场景
企业级	`/etc/claude-code/`	最高	组织统一标准
个人级	`%USERPROFILE%\.claude\skills\`	高	个人偏好和工具
项目级	`.claude\skills\`	中	项目特定功能
插件级	插件管理	低	市场安装的 Skills

选择建议：

个人偏好 → 个人级
项目特定 → 项目级
团队标准 → 项目级（提交到 Git）
组织规范 → 企业级

13.3 文件结构

最小化结构（推荐新手）：

复制代码

.claude\skills\my-skill\
└── SKILL.md                # 只需要这一个文件

完整结构（推荐进阶）：

复制代码

.claude\skills\my-skill\
├── SKILL.md                # 核心配置文件
├── README.md               # 使用说明
├── scripts\                # 可执行脚本
├── templates\              # 输出模板
└── references\             # 参考文档

13.4 SKILL.md 格式

基本结构：

markdown 复制代码

---
# Frontmatter（YAML 配置）
name: my-skill
description: 简短描述
---

# Markdown 内容（指令和说明）

## Purpose
说明用途

## Instructions
执行步骤

## Examples
使用示例

关键字段：

description：最重要，用于触发判断
disable-model-invocation：控制 AI 是否自动调用
allowed-tools：限制工具访问权限

13.5 编写原则

✅ 黄金法则：

Description 简洁明确（触发器，不是文档）
专注单一功能（不要做万能 Skill）
避免过度预判（让 Claude 灵活处理）

✅ 安全原则：

敏感操作禁用自动调用
限制工具访问权限
不硬编码敏感信息
验证用户输入

✅ 性能原则：

简化 description
使用引用而非内联大量内容
按需加载不常用的 Skills

13.6 高级技巧

✅ 组合使用：

创建工作流 Skill 调用其他 Skills
顺序执行、并行执行、条件分支

✅ 动态配置：

使用 !command" 注入动态内容
根据环境变量调整行为
检测项目类型自动配置

✅ 模板系统：

使用 templates\ 目录存放模板
支持变量替换
多文件生成

✅ 子代理：

设置 context: fork 在隔离环境运行
配合 allowed-tools 限制权限
适合安全敏感的操作

14. 最常用配置推荐

14.1 个人开发者配置

推荐的个人级 Skills：

复制代码

C:\Users\你的用户名\.claude\skills\
├── code-review\            # 代码审查
├── commit-message\         # Git 提交信息生成
├── test-generator\         # 测试生成
├── api-doc\                # API 文档生成
└── refactor-helper\        # 重构辅助

安装方式：

cmd 复制代码

# 1. 克隆 Superpowers（CMD）
cd %USERPROFILE%
git clone https://github.com/obra/superpowers.git

# 2. 复制推荐的 Skills
xcopy /E /I superpowers\skills\code-review %USERPROFILE%\.claude\skills\code-review\
xcopy /E /I superpowers\skills\test-generator %USERPROFILE%\.claude\skills\test-generator\

# 3. 从官方仓库安装
git clone https://github.com/anthropics/skills.git anthropics-skills
xcopy /E /I anthropics-skills\skills\document-skills %USERPROFILE%\.claude\skills\document-skills\

14.2 团队项目配置

推荐的项目级 Skills：

复制代码

项目根目录\.claude\skills\
├── coding-standards\       # 团队编码规范
├── pr-template\            # Pull Request 模板
├── deploy-staging\         # 部署到测试环境
├── deploy-prod\            # 部署到生产环境
└── project-docs\           # 项目文档生成

创建团队编码规范 Skill：

cmd 复制代码

# 1. 创建目录（CMD）
mkdir .claude\skills\coding-standards
cd .claude\skills\coding-standards

# 2. 创建 SKILL.md
notepad SKILL.md

SKILL.md 内容：

markdown 复制代码

---
name: coding-standards
description: 团队编码规范
disable-model-invocation: false
user-invocable: false
---

# 团队编码规范

## 代码风格
- 使用 2 空格缩进
- 使用单引号
- 每行最多 80 字符
- 使用 ESLint 和 Prettier

## 命名规范
- 变量：camelCase
- 常量：UPPER_SNAKE_CASE
- 类：PascalCase
- 文件：kebab-case

## 注释规范
- 使用 JSDoc 格式
- 所有公共 API 必须有注释
- 复杂逻辑必须有说明

## 提交规范
- 遵循 Conventional Commits
- 格式：`type(scope): subject`
- 类型：feat, fix, docs, style, refactor, test, chore

## 测试要求
- 单元测试覆盖率 > 80%
- 所有公共 API 必须有测试
- 使用 Jest 测试框架

提交到 Git：

cmd 复制代码

# 提交 Skills 到版本控制（CMD）
git add .claude\skills\
git commit -m "feat: add team coding standards skill"
git push

14.3 全栈开发配置

推荐的 Skills 组合：

复制代码

.claude\skills\
├── 前端开发
│   ├── react-component\    # React 组件生成
│   ├── vue-component\      # Vue 组件生成
│   └── css-helper\         # CSS 辅助
├── 后端开发
│   ├── api-endpoint\       # API 端点生成
│   ├── db-migration\       # 数据库迁移
│   └── service-layer\      # 服务层生成
├── 测试
│   ├── unit-test\          # 单元测试
│   ├── integration-test\   # 集成测试
│   └── e2e-test\           # E2E 测试
└── DevOps
    ├── docker-config\      # Docker 配置
    ├── ci-cd\              # CI/CD 流程
    └── deploy\             # 部署脚本

14.4 快速启动配置

5 分钟快速配置：

cmd 复制代码

# 1. 添加官方插件市场
# 在 Claude Code 中执行：
/plugin marketplace add anthropics/skills

# 2. 安装推荐的 Skills
/plugin install document-skills@anthropic-agent-skills

# 3. 验证安装
What skills are available?

# 4. 测试 Skill
/document-skills

10 分钟完整配置：

cmd 复制代码

# 1. 克隆推荐仓库（CMD）
cd %USERPROFILE%
mkdir claude-skills-repos
cd claude-skills-repos

git clone https://github.com/anthropics/skills.git anthropics
git clone https://github.com/obra/superpowers.git superpowers

# 2. 安装推荐的 Skills
xcopy /E /I anthropics\skills\document-skills %USERPROFILE%\.claude\skills\document-skills\
xcopy /E /I anthropics\skills\code-review %USERPROFILE%\.claude\skills\code-review\
xcopy /E /I superpowers\skills\planning %USERPROFILE%\.claude\skills\planning\
xcopy /E /I superpowers\skills\testing %USERPROFILE%\.claude\skills\testing\

# 3. 重启 Claude Code

# 4. 验证安装
# 在 Claude Code 中执行：
What skills are available?

15. 下一步行动

15.1 立即行动清单

如果你是新手：

如果你已经入门：

如果你想进阶：

如果你在团队中：

15.2 持续学习建议

每周任务

第 1 周：

使用 3-5 个官方 Skills
记录使用体验
发现改进点

第 2 周：

创建 1-2 个简单 Skill
测试和优化
分享给同事

第 3 周：

学习高级特性
创建复杂 Skill
参与社区讨论

第 4 周：

总结最佳实践
建立团队标准
制定推广计划

每月任务

更新 Skills 仓库
检查新版本
清理不用的 Skills
优化性能
更新文档

持续改进

收集团队反馈
优化工作流程
分享经验教训
参与社区贡献
关注新特性

15.3 获取帮助

官方支持：

📧 官方支持：https://support.claude.com
📚 官方文档：https://docs.anthropic.com
💬 社区论坛：https://community.anthropic.com

社区资源：

GitHub Issues：在相关仓库提问
Stack Overflow：搜索 claude-code-skills 标签
Reddit：r/ClaudeAI 社区
Discord：Anthropic 官方服务器

中文资源：

CSDN 博客
知乎专栏
掘金社区
微信公众号

15.4 贡献社区

分享你的 Skills：

创建 GitHub 仓库
编写详细的 README
添加使用示例
提交到 Awesome Claude Skills
在社区分享

参与开源项目：

Fork 感兴趣的仓库
改进现有 Skills
提交 Pull Request
参与代码审查
帮助解答问题

撰写教程：

记录学习过程
分享实战经验
制作视频教程
翻译官方文档
组织线下活动

附录

附录 A：常见错误代码

A.1 错误代码表

错误代码	错误信息	原因	解决方案
SKILL_NOT_FOUND	Skill not found	Skill 未安装或路径错误	检查目录结构，重启 Claude Code
PERMISSION_DENIED	Permission denied	权限不足	检查 `/permissions` 设置
INVALID_FRONTMATTER	Invalid frontmatter	YAML 格式错误	验证 YAML 语法，检查缩进
TOOL_NOT_ALLOWED	Tool not allowed	工具未授权	添加到 `allowed-tools` 列表
ARGUMENT_MISSING	Argument missing	缺少必需参数	提供完整的参数
COMMAND_FAILED	Command execution failed	命令执行失败	检查命令语法和权限
FILE_NOT_FOUND	File not found	文件不存在	检查文件路径
SYNTAX_ERROR	Syntax error in SKILL.md	语法错误	检查 Markdown 和 YAML 语法

A.2 详细错误说明

错误 1：SKILL_NOT_FOUND

错误信息：

复制代码

Error: Skill 'my-skill' not found

可能原因：

Skill 目录不存在
SKILL.md 文件不存在
文件名不是 SKILL.md（必须大写）
未重启 Claude Code

解决步骤：

cmd 复制代码

# 1. 检查目录是否存在（CMD）
dir %USERPROFILE%\.claude\skills\my-skill

# 2. 检查 SKILL.md 是否存在
dir %USERPROFILE%\.claude\skills\my-skill\SKILL.md

# 3. 如果文件名错误，重命名
ren %USERPROFILE%\.claude\skills\my-skill\skill.md SKILL.md

# 4. 重启 Claude Code

错误 2：INVALID_FRONTMATTER

错误信息：

复制代码

Error: Invalid frontmatter in SKILL.md

可能原因：

YAML 语法错误
缩进不正确
缺少 --- 分隔符
字段值格式错误

错误示例：

yaml 复制代码

---
name: my-skill
description: 我的 Skill
allowed-tools:
- readFile  # 错误：缩进不正确
  - strReplace
---

正确示例：

yaml 复制代码

---
name: my-skill
description: 我的 Skill
allowed-tools:
  - readFile
  - strReplace
---

错误 3：TOOL_NOT_ALLOWED

错误信息：

复制代码

Error: Tool 'fsWrite' is not allowed for this skill

原因：

Skill 配置了 allowed-tools，但尝试使用的工具不在列表中。

解决方案：

yaml 复制代码

---
name: my-skill
allowed-tools:
  - readFile
  - strReplace
  - fsWrite  # 添加需要的工具
---

附录 B：调试技巧

B.1 基本调试命令

复制代码

# 查看所有可用 Skills
What skills are available?

# 查看 Skills 列表
/skills

# 查看上下文使用情况
/context

# 查看权限设置
/permissions

# 手动触发 Skill
/skill-name test-argument

B.2 检查 Skill 配置

查看 SKILL.md 内容：

cmd 复制代码

# CMD
type %USERPROFILE%\.claude\skills\my-skill\SKILL.md

验证 YAML 语法：

复制 frontmatter 部分
访问 https://www.yamllint.com/
粘贴并验证

B.3 调试工作流

步骤 1：确认 Skill 已加载

复制代码

What skills are available?

如果看不到你的 Skill：

检查目录结构
检查 SKILL.md 文件名（必须大写）
重启 Claude Code

步骤 2：测试手动调用

复制代码

/my-skill test

如果无法调用：

检查 user-invocable 是否为 true
检查 Skill 名称是否正确

步骤 3：测试自动触发

说一句会触发 Skill 的话，例如：

复制代码

请帮我审查这段代码

如果没有触发：

检查 disable-model-invocation 是否为 false
优化 description 使其更明确
检查是否超出字符预算

步骤 4：检查工具权限

如果 Skill 执行时报错：

复制代码

/permissions

检查是否允许 Skill 使用必要的工具。

B.4 常见问题排查

问题 1：Skill 不触发

排查步骤：

确认 Skill 已加载：What skills are available?
检查 description：是否简洁明确？
检查 disable-model-invocation：是否为 false？
尝试手动调用：/skill-name

问题 2：参数传递失败

排查步骤：

检查 argument-hint 配置
测试参数替换：在 SKILL.md 中使用 $ARGUMENTS
验证参数数量：$0, $1, $2 是否正确

测试示例：

markdown 复制代码

---
name: test-args
argument-hint: [arg1] [arg2]
---

参数 1: $0
参数 2: $1
所有参数: $ARGUMENTS

调用：/test-args hello world

问题 3：命令注入失败

排查步骤：

检查命令语法：!command"
测试命令是否可执行：在 CMD 中手动运行
检查命令输出：是否有错误？

测试示例：

markdown 复制代码

---
name: test-command
---

当前分支：!git branch --show-current"

附录 C：性能优化清单

C.1 优化 Description

使用简洁的关键词
避免冗长的描述
专注核心功能
不超过 50 字符

优化前：

yaml 复制代码

description: 这是一个用于生成、审查、优化、测试和部署代码的综合工具，支持多种编程语言和框架，包括但不限于 JavaScript、TypeScript、Python、Java、C#、Go、Rust 等

优化后：

yaml 复制代码

description: 代码生成和审查

C.2 优化 Skill 内容

将大型文档移到 references\ 目录
使用引用而非内联
删除不必要的示例
简化指令

优化前：

markdown 复制代码

---
name: api-guide
---

# API Guide

[10000 行 API 文档内容...]

优化后：

markdown 复制代码

---
name: api-guide
---

# API Guide

核心指令...

## 详细文档
需要时查看 `references/api-spec.md`

C.3 管理 Skills 数量

删除不常用的 Skills
合并相似的 Skills
标记不常用 Skills 为手动调用
定期清理

检查 Skills 数量：

cmd 复制代码

# CMD
dir /B %USERPROFILE%\.claude\skills | find /C /V ""

建议数量：

个人使用：10-20 个
团队项目：5-15 个
总计：不超过 30 个

C.4 监控上下文使用

复制代码

/context

检查项：

Skills 占用的字符数
是否有 Skills 被排除
是否需要增加预算

增加字符预算：

cmd 复制代码

# CMD - 临时设置
set SLASH_COMMAND_TOOL_CHAR_BUDGET=32000

# PowerShell - 永久设置（需要管理员权限）
[System.Environment]::SetEnvironmentVariable('SLASH_COMMAND_TOOL_CHAR_BUDGET', '32000', 'User')

C.5 优化工具访问

为只读操作限制工具
使用 allowed-tools 明确权限
避免不必要的工具访问

示例：

yaml 复制代码

---
name: code-explorer
allowed-tools:
  - readFile
  - readMultipleFiles
  - listDirectory
  - grepSearch
  - fileSearch
---

C.6 性能检查清单

每月检查：

Skills 数量是否合理？
Description 是否简洁？
是否有未使用的 Skills？
上下文使用是否正常？
是否需要优化内容？

优化建议：

保持 Skills 数量在 30 个以内
Description 不超过 50 字符
大型文档使用引用
定期清理不用的 Skills

相关链接：