使用 Claude Code 进行工作流程自動化

Claude 脚本目录

在專案根目录中建立一个 .claude 目录，用于存储自定义脚本和組態：

Claude Code 会自動检测并使用此目录进行自定义自動化。

基本工作流程組態

在 .claude 目录中建立一个 config.json 檔案：

{
  "projectName": "MyAwesomeProject",
  "description": "A React application for financial management",
  "workflows": {
    "component": {
      "templatePath": "./templates/component.tsx",
      "outputPath": "src/components/{name}/{name}.tsx"
    },
    "test": {
      "templatePath": "./templates/test.tsx",
      "outputPath": "src/components/{name}/__tests__/{name}.test.tsx"
    }
  }
}

此組態定义了用于元件和測試建立的基于模板的工作流程。

脚本结构

在 .claude/scripts 目录中建立一个 JavaScript 檔案：

// .claude/scripts/create-feature.js

module.exports = async (claude, args) => {
  const { featureName } = args;

  // Create feature directory
  await claude.exec(`mkdir -p src/features/${featureName}`);

  // Create component files
  await claude.generateFile(
    `src/features/${featureName}/${featureName}Page.tsx`,
    `Create a React component for the ${featureName} feature page`
  );

  // Create service files
  await claude.generateFile(
    `src/features/${featureName}/${featureName}Service.ts`,
    `Create a service for the ${featureName} feature that handles data fetching and processing`
  );

  // Update route configuration
  await claude.modifyFile(
    'src/routes.tsx',
    `Add a route for the ${featureName} feature page`
  );

  return `${featureName} feature created successfully!`;
};

執行自定义脚本

使用 claude run 命令执行您的自定义脚本：

这将使用提供的參數执行您的脚本，为使用者組態功能建立所有必要的檔案。

建立模板

在 .claude/templates 目录中建立模板檔案：

// .claude/templates/component.tsx

import React from 'react';

interface {{name}}Props {
  // Add props here
}

export const {{name}} = ({ ...props }: {{name}}Props) => {
  return (
    <div className="{{kebabCase name}}-component">
      {/* Component content */}
    </div>
  );
};

export default {{name}};

模板使用 handlebars 风格的语法，带有像 $name 这样的變數，在生成期间会被取代。

使用模板

使用 claude generate 命令从模板生成檔案：

这将在 src/components/UserProfile/UserProfile.tsx 根据您的模板建立一个新元件。

CI/CD 集成

将 Claude Code 自動化集成到您的 CI/CD 管道中：

# .github/workflows/claude-checks.yml

name: Claude Code Checks

on:
  pull_request:
    branches: [ main ]

jobs:
  code-quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install Claude CLI
        run: npm install -g @anthropic/claude-cli
      - name: Run Claude Code Review
        run: claude run code-review --reporter=github

基于事件的自動化

設定基于專案事件触发的自動化：

// .claude/config.json

{
  // ... other config
  "events": {
    "onComponentCreate": "generate-tests",
    "onModelChange": "update-migrations",
    "onApiChange": "update-documentation"
  }
}

此組態告诉 Claude Code 在特定事件发生时自動執行某些脚本。