10.3 自定義工具開發

Claude Code 提供了靈活的擴充套件機制，允許您開發自定義工具來滿足特定需求。透過自定義工具，您可以擴充套件 Claude 的功能，整合外部服務，自動化工作流，提高開發效率。

自定義工具的方式

Claude Code 支援兩種主要的自定義工具開發方式：外掛工具和技能工具。

1. 外掛工具

外掛工具是一種功能強大的擴充套件方式，允許您建立複雜的、可分享的工具。

优势 :

可分享和分發 : 外掛可以打包並分享給團隊成員或社群
支援複雜功能 : 可以實現複雜的業務邏輯和工作流
可整合外部服務 : 可以與各種外部服務和 API 整合
完整的生命週期管理 : 支援安裝、更新、解除安裝等操作

适用场景 :

團隊共享工具和工作流
複雜的業務邏輯實現
外部服務整合
需要頻繁使用的工具

2. 技能工具

技能工具是一種輕量級的擴充套件方式，適合快速建立簡單的功能。

优势 :

簡單易用 : 無需複雜的開發和配置
快速建立 : 可以在短時間內建立並使用
靈活配置 : 支援透過配置檔案自定義行為
低學習成本 : 無需學習複雜的開發框架

适用场景 :

個人工作流自動化
簡單任務的快速實現
快速原型驗證
臨時工具的建立

创建插件工具

插件结构

一個典型的 Claude Code 外掛具有以下結構：

    bash


    my-plugin/
    ├── plugin.json          # 插件配置文件
    ├── commands/            # 自定义命令目录
    │   └── my-command.md    # 自定义命令定义
    ├── skills/              # 自定义技能目录
    │   └── my-skill/        # 技能目录
    │       └── SKILL.md     # 技能定义文件
    ├── tools/               # 自定义工具目录
    │   └── my-tool.ts       # 工具实现代码
    ├── assets/              # 静态资源目录
    │   └── logo.png         # 插件图标
    └── README.md            # 插件文档

### plugin.json 配置

plugin.json 是外掛的核心配置檔案，定義了外掛的基本資訊和功能。

    json


    {
      "name": "my-plugin",
      "version": "1.0.0",
      "description": "My custom plugin for Claude Code",
      "author": "John Doe",
      "license": "MIT",
      "homepage": "https://github.com/johndoe/my-plugin",
      "commands": [
        {
          "name": "my-command",
          "description": "My custom command",
          "usage": "/my-command [options]",
          "aliases": ["mc"]
        }
      ],
      "skills": [
        {
          "name": "my-skill",
          "description": "A custom skill for specific tasks",
          "category": "development"
        }
      ],
      "tools": [
        {
          "name": "my-tool",
          "description": "A custom tool for advanced operations",
          "type": "command-line"
        }
      ],
      "dependencies": {
        "axios": "^1.0.0",
        "lodash": "^4.0.0"
      }
    }

### 创建自定义命令

自定義命令允許您建立新的 Claude 命令，擴充套件其功能。

**命令定义文件 (my-command.md)** :

    markdown


    # My Custom Command

    This is a custom command for my plugin.

    ## Usage

    ```bash

    /my-command [options] [arguments]

## Options

Option	Description	Default
`--help`	Show help message	false
`--verbose`	Enable verbose output	false
`--output <file>`	Output file path	stdout
`--timeout <ms>`	Timeout in milliseconds	5000

Examples

bash


# Basic usage
/my-command

# Verbose output
/my-command --verbose

# Save output to file
/my-command --output result.txt

# With timeout
/my-command --timeout 10000

Implementation

typescript


import axios from 'axios';

export async function run(options: any) {
  if (options.help) {
    return showHelp();
  }

  try {
    const result = await axios.get('https://api.example.com/data');

    if (options.verbose) {
      console.log('Request successful:', result.data);
    }

    return result.data;
  } catch (error) {
    console.error('Error:', error.message);
    throw error;
  }
}

建立自定義技能

技能是一種輕量級的擴充套件方式，適合定義特定任務的處理流程。

技能定義檔案 (SKILL.md) :

yaml


---
name: my-skill
description: A custom skill for specific tasks
category: development
author: John Doe
version: 1.0.0
---

# My Skill

## Instructions

1. **Analyze the input**: Understand the user's request and extract key information
2. **Process the data**: Perform necessary transformations and calculations
3. **Generate output**: Create the final result based on the processed data
4. **Review and refine**: Check the output for quality and accuracy

## Examples

### Example 1: Simple task

**Input**: "Convert this JSON to CSV"
**Output**: "Here's the CSV version of your data..."

### Example 2: Complex task

**Input**: "Analyze this code and suggest improvements"
**Output**: "I've analyzed your code. Here are my suggestions..."

## Constraints

- Do not share sensitive information
- Keep responses concise and focused
- Follow best practices for the target language
- Provide clear explanations for all recommendations

## Tools to Use

- **Read**: To read code files
- **Grep**: To search for specific patterns
- **Edit**: To make code changes
- **Bash**: To run tests and validations

## Success Criteria

- The output meets the user's requirements
- The solution is efficient and optimal
- The explanation is clear and understandable
- The code follows best practices

建立自定義工具

自定義工具允許您建立功能強大的擴充套件，實現複雜的業務邏輯。

工具實現檔案 (my-tool.ts) :

typescript


import { Tool } from '@claude-code/plugin-api';

export class MyTool implements Tool {
  name = 'my-tool';
  description = 'A custom tool for advanced operations';

  async run(args: string[], options: any) {
    // 解析引數
    const [inputFile, outputFile] = args;

    // 執行操作
    const result = await this.processFile(inputFile);

    // 儲存結果
    if (outputFile) {
      await this.saveResult(outputFile, result);
    }

    return result;
  }

  private async processFile(filePath: string) {
    // 實現檔案處理邏輯
    const content = await this.readFile(filePath);
    const processed = this.transformContent(content);
    return processed;
  }

  private async readFile(filePath: string) {
    // 實現檔案讀取邏輯
    const fs = require('fs').promises;
    return await fs.readFile(filePath, 'utf8');
  }

  private transformContent(content: string) {
    // 實現內容轉換邏輯
    return content.toUpperCase();
  }

  private async saveResult(filePath: string, content: string) {
    // 實現結果儲存邏輯
    const fs = require('fs').promises;
    await fs.writeFile(filePath, content, 'utf8');
  }
}

技能工具開發

技能檔案結構

技能檔案採用 YAML 格式，包含後設資料和技能定義。

yaml


---
name: data-analyzer
description: Analyze and visualize data
author: Jane Smith
version: 1.0.0
category: data-science
---

# Data Analyzer Skill

## Purpose

This skill helps users analyze and visualize data from various sources.

## Capabilities

- Import data from CSV, JSON, and Excel files
- Clean and preprocess data
- Perform statistical analysis
- Generate visualizations (charts, graphs)
- Export results to various formats

## Workflow

1. **Data Import**: Read data from input files
2. **Data Cleaning**: Handle missing values, remove duplicates
3. **Analysis**: Perform descriptive and inferential statistics
4. **Visualization**: Create charts and graphs
5. **Export**: Save results to files

## Tools to Use

- **Read**: To read data files
- **Bash**: To run data processing commands
- **Write**: To save results
- **MCP**: To integrate with data analysis services

## Examples

### Example 1: Basic data analysis

**User Request**: "Analyze this CSV file and show me the summary statistics"
**Action**: Read the CSV file, perform statistical analysis, show summary

### Example 2: Data visualization

**User Request**: "Create a bar chart from this JSON data"
**Action**: Read the JSON data, generate bar chart, display results

## Best Practices

- Always validate input data
- Provide clear explanations for results
- Use appropriate visualization types
- Optimize performance for large datasets
- Handle errors gracefully

外掛釋出和分發

打包外掛

bash


# 打包外掛
claude plugin package my-plugin

# 生成外掛包
my-plugin-1.0.0.claude-plugin

釋出外掛

bash


# 釋出到 Claude 外掛市場
claude plugin publish my-plugin-1.0.0.claude-plugin

安裝外掛

bash


# 從本地檔案安裝
claude plugin install my-plugin-1.0.0.claude-plugin

# 從市場安裝
claude plugin install my-plugin

除錯和測試

除錯外掛

bash


# 啟動除錯模式
claude plugin debug my-plugin

# 檢視日誌
claude plugin logs my-plugin

測試外掛

bash


# 執行單元測試
claude plugin test my-plugin

# 執行整合測試
claude plugin test --integration my-plugin

效能最佳化

程式碼最佳化

使用非同步操作提高響應速度
快取頻繁使用的資料
避免不必要的計算
使用高效的演算法和資料結構

資源管理

及時釋放資源
限制併發請求數量
最佳化記憶體使用
壓縮靜態資源

安全考慮

輸入驗證

對所有使用者輸入進行驗證
防止 SQL 注入和 XSS 攻擊
限制檔案訪問範圍
驗證外部 API 響應

許可權管理

最小許可權原則
細粒度的許可權控制
安全的配置管理
審計和日誌記錄

未來發展

趨勢

更強大的外掛 API
更好的開發工具和除錯支援
更豐富的外掛市場
更好的效能和擴充套件性

建議

關注官方文件和更新
參與社群討論和貢獻
學習最佳實踐
持續改進和最佳化

透過自定義工具開發，您可以充分發揮 Claude Code 的潛力，建立適合自己和團隊需求的工具和工作流。 git push

團隊成員安裝 : git pull

技能自動可用

bash


## 高階功能
### 工具鏈
建立工具鏈完成複雜任務：

yaml

name: data-pipeline description: Complete data processing pipeline from extraction to analysis

Data Pipeline

Instructions

Extract data from source
Transform and clean
Load to destination
Generate report

條件邏輯

在技能中新增條件邏輯：

Instructions

If the file is CSV:

Use pandas to read
Process with pandas If the file is JSON:
Use json module
Process with json

bash


### 錯誤處理
新增錯誤處理指導：

markdown

Error Handling

If file not found:

Check file path
Suggest similar files
Ask for confirmation

If format invalid:

Identify format issue
Suggest fixes
Provide example

維護和更新

版本管理

使用語義化版本：

bash


### 更新日誌
維護 CHANGELOG.md：

markdown

[1.2.3] - 2024-01-15

Added

New feature X

Fixed

Bug Y

文件更新

保持文件同步：

Documentation

SKILL.md: Main documentation
README.md: User guide
API.md: API reference

10.3 自定義工具開發 ​

自定義工具的方式 ​

1. 外掛工具 ​

2. 技能工具 ​

创建插件工具 ​

插件结构 ​

Examples ​

Implementation ​

建立自定義技能 ​

建立自定義工具 ​

技能工具開發 ​

技能檔案結構 ​

外掛釋出和分發 ​

打包外掛 ​

釋出外掛 ​

安裝外掛 ​

除錯和測試 ​

除錯外掛 ​

測試外掛 ​

效能最佳化 ​

程式碼最佳化 ​

資源管理 ​

安全考慮 ​

輸入驗證 ​

許可權管理 ​

未來發展 ​

趨勢 ​

建議 ​

技能自動可用 ​

name: data-pipeline description: Complete data processing pipeline from extraction to analysis ​

Data Pipeline ​

Instructions ​

條件邏輯 ​

Instructions ​

Error Handling ​

維護和更新 ​

版本管理 ​

[1.2.3] - 2024-01-15 ​

Added ​

Fixed ​

文件更新 ​

Documentation ​

10.3 自定義工具開發

自定義工具的方式

1. 外掛工具

2. 技能工具

创建插件工具

插件结构

Examples

Implementation

建立自定義技能

建立自定義工具

技能工具開發

技能檔案結構

外掛釋出和分發

打包外掛

釋出外掛

安裝外掛

除錯和測試

除錯外掛

測試外掛

效能最佳化

程式碼最佳化

資源管理

安全考慮

輸入驗證

許可權管理

未來發展

趨勢

建議

技能自動可用

name: data-pipeline description: Complete data processing pipeline from extraction to analysis

Data Pipeline

Instructions

條件邏輯

Instructions

Error Handling

維護和更新

版本管理

[1.2.3] - 2024-01-15

Added

Fixed

文件更新

Documentation