claude-tools

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# claude-tools

A comprehensive Claude Code plugin with specialized skills, workflow commands, intelligent hooks, and 46 AI agents for Python/FastAPI development, Brazilian financial integrations, and productivity automation.

## Installation

```bash
# Add the marketplace
/plugin marketplace add rafaelkamimura/claude-tools

# Install the plugin
/plugin install claude-tools@claude-tools
```

## Contents

### Skills (5 Domain Expertise Areas)

| Skill | Description | Auto-Triggers |
|-------|-------------|---------------|
| **fastapi-clean-architecture** | Clean Architecture patterns for FastAPI with 3-layer design, DI, repository pattern | `fastapi`, `clean architecture` |
| **brazilian-financial-integration** | Boleto, PIX payments, parcelamento, CPF/CNPJ validation, Banco do Brasil API | `boleto`, `pix`, `brazilian payment` |
| **async-testing-expert** | pytest patterns for async Python testing, fixtures, mocking, 387-test reference | `pytest`, `async test` |
| **multi-system-sso-authentication** | Enterprise SSO with JWT RS256, multi-provider support, session management | `sso`, `authentication`, `jwt` |
| **skill-developer** | Meta-skill for creating and managing Claude Code skills | `create skill`, `skill development` |

### Utility Skills

- **mariadb-database-explorer** - Schema exploration and documentation generation
- **gitlab-cli-troubleshooter** - GitLab CLI configuration and diagnostics
- **mcp-setup-wizard** - Model Context Protocol server configuration

### Commands (32 Workflow Automation)

#### Task Management
- `/task-init` - Intelligent task initialization with codebase exploration
- `/brainstorm` - Deep thinking sessions for implementation ideas
- `/todo-worktree` - Todo implementation program
- `/dev-docs` - Strategic plan creation
- `/dev-docs-update` - Documentation updates before context compaction

#### Code Quality
- `/review-code` - Pre-commit code review
- `/test-suite` - Test suite runner
- `/security-scan` - Security vulnerability scanning
- `/perf-check` - Performance analysis
- `/tech-debt` - Technical debt tracking
- `/debug-assistant` - Intelligent debugging helper

#### Git & Deployment
- `/commit` - Smart git commit with conventional commits
- `/deploy` - Smart deployment manager
- `/rollback` - Emergency rollback procedures

#### Documentation
- `/read-specs` - Specification reader and task decomposer
- `/write-documentation` - Documentation writer
- `/mr-draft` - Merge request draft generator
- `/handoff` - Team handoff assistant

#### Azure DevOps Integration
- `/fetch-azure-task` - Fetch Azure DevOps work items
- `/update-azure-task` - Update work items
- `/close-azure-task` - Close work items

#### Utilities
- `/standup` - Daily status generator
- `/env-sync` - Environment manager
- `/deps-update` - Dependency manager
- `/sync-config` - Sync configuration to GitHub
- `/create-skill` - Skill creation workflow
- `/bslist` - Brainstorm list viewer

### Agents (46 Specialized AI Subagents)

#### Architecture & Design
`backend-architect`, `code-architecture-reviewer`, `cloud-architect`, `graphql-architect`, `documentation-architect`, `plan-reviewer`

#### Development
`code-refactor-master`, `code-reviewer`, `frontend-developer`, `python-pro`, `golang-pro`, `typescript-expert`, `rust-pro`, `php-developer`, `laravel-vue-developer`, `nextjs-app-router-developer`, `drupal-developer`, `directus-developer`, `legacy-modernizer`

#### Quality & Testing
`test-automator`, `frontend-qa-tester`, `database-optimizer`, `performance-engineer`, `security-auditor`, `debugger`, `devops-troubleshooter`

#### Data & AI
`data-scientist`, `data-engineer`, `ml-engineer`, `ai-engineer`

#### Financial & Crypto
`payment-integration`, `arbitrage-bot`, `crypto-analyst`, `crypto-trader`, `crypto-risk-manager`, `defi-strategist`, `quant-analyst`

#### Specialized
`game-developer`, `mobile-developer`, `blockchain-developer`, `accessibility-specialist`, `api-documenter`, `web-research-specialist`, `ui-ux-designer`, `refactor-planner`

### Hooks (Intelligent Automation)

This plugin includes a TypeScript-based hook system for automatic skill activation:

- **UserPromptSubmit Hook** - Analyzes prompts and suggests relevant skills based on keywords and intent patterns
- **PostToolUse Hook** - Tracks edited files and caches build commands for affected repositories

**Requirements**: Node.js and npm/npx for hook execution.

## Skill Activation System

The plugin includes `skill-rules.json` which defines automatic triggers for skills:

```json
{
  "skills": {
    "fastapi-clean-architecture": {
      "type": "domain",
      "enforcement": "suggest",
      "priority": "high",
      "promptTriggers": {
        "keywords": ["fastapi", "clean architecture", "repository pattern"],
        "intentPatterns": ["build.*api", "create.*endpoint"]
      }
    }
  }
}
```

When you type a prompt containing trigger keywords, the hook system will suggest activating the relevant skill.

## Configuration

After installation, skills and commands are available immediately. To customize:

1. **Modify skill triggers**: Edit `skills/skill-rules.json`
2. **Customize commands**: Edit individual command files in `commands/`
3. **Add new agents**: Add markdown files to `agents/`

## Requirements

- Claude Code CLI
- Node.js 18+ (for hooks)
- npm or npx

## License

MIT

## Author

Rafael Kamimura

## Version

1.0.0

claude-tools

A comprehensive Claude Code plugin with specialized skills, workflow commands, intelligent hooks, and 46 AI agents for Python/FastAPI development, Brazilian financial integrations, and productivity automation.

Installation

# Add the marketplace
/plugin marketplace add rafaelkamimura/claude-tools

# Install the plugin
/plugin install claude-tools@claude-tools

Skills (5 Domain Expertise Areas)

Skill	Description	Auto-Triggers
fastapi-clean-architecture	Clean Architecture patterns for FastAPI with 3-layer design, DI, repository pattern	`fastapi`, `clean architecture`
brazilian-financial-integration	Boleto, PIX payments, parcelamento, CPF/CNPJ validation, Banco do Brasil API	`boleto`, `pix`, `brazilian payment`
async-testing-expert	pytest patterns for async Python testing, fixtures, mocking, 387-test reference	`pytest`, `async test`
multi-system-sso-authentication	Enterprise SSO with JWT RS256, multi-provider support, session management	`sso`, `authentication`, `jwt`
skill-developer	Meta-skill for creating and managing Claude Code skills	`create skill`, `skill development`

Utility Skills

mariadb-database-explorer - Schema exploration and documentation generation
gitlab-cli-troubleshooter - GitLab CLI configuration and diagnostics
mcp-setup-wizard - Model Context Protocol server configuration

Commands (32 Workflow Automation)

Task Management

/task-init - Intelligent task initialization with codebase exploration
/brainstorm - Deep thinking sessions for implementation ideas
/todo-worktree - Todo implementation program
/dev-docs - Strategic plan creation
/dev-docs-update - Documentation updates before context compaction

Code Quality

/review-code - Pre-commit code review
/test-suite - Test suite runner
/security-scan - Security vulnerability scanning
/perf-check - Performance analysis
/tech-debt - Technical debt tracking
/debug-assistant - Intelligent debugging helper

Git & Deployment

/commit - Smart git commit with conventional commits
/deploy - Smart deployment manager
/rollback - Emergency rollback procedures

Documentation

/read-specs - Specification reader and task decomposer
/write-documentation - Documentation writer
/mr-draft - Merge request draft generator
/handoff - Team handoff assistant

Azure DevOps Integration

/fetch-azure-task - Fetch Azure DevOps work items
/update-azure-task - Update work items
/close-azure-task - Close work items

Utilities

/standup - Daily status generator
/env-sync - Environment manager
/deps-update - Dependency manager
/sync-config - Sync configuration to GitHub
/create-skill - Skill creation workflow
/bslist - Brainstorm list viewer

Agents (46 Specialized AI Subagents)

Architecture & Design

backend-architect, code-architecture-reviewer, cloud-architect, graphql-architect, documentation-architect, plan-reviewer

Development

code-refactor-master, code-reviewer, frontend-developer, python-pro, golang-pro, typescript-expert, rust-pro, php-developer, laravel-vue-developer, nextjs-app-router-developer, drupal-developer, directus-developer, legacy-modernizer

Quality & Testing

test-automator, frontend-qa-tester, database-optimizer, performance-engineer, security-auditor, debugger, devops-troubleshooter

Data & AI

data-scientist, data-engineer, ml-engineer, ai-engineer

Financial & Crypto

payment-integration, arbitrage-bot, crypto-analyst, crypto-trader, crypto-risk-manager, defi-strategist, quant-analyst

Specialized

game-developer, mobile-developer, blockchain-developer, accessibility-specialist, api-documenter, web-research-specialist, ui-ux-designer, refactor-planner

Hooks (Intelligent Automation)

This plugin includes a TypeScript-based hook system for automatic skill activation:

UserPromptSubmit Hook - Analyzes prompts and suggests relevant skills based on keywords and intent patterns
PostToolUse Hook - Tracks edited files and caches build commands for affected repositories

Requirements: Node.js and npm/npx for hook execution.

Skill Activation System

The plugin includes skill-rules.json which defines automatic triggers for skills:

{
  "skills": {
    "fastapi-clean-architecture": {
      "type": "domain",
      "enforcement": "suggest",
      "priority": "high",
      "promptTriggers": {
        "keywords": ["fastapi", "clean architecture", "repository pattern"],
        "intentPatterns": ["build.*api", "create.*endpoint"]
      }
    }
  }
}

When you type a prompt containing trigger keywords, the hook system will suggest activating the relevant skill.

Configuration

After installation, skills and commands are available immediately. To customize:

Modify skill triggers: Edit skills/skill-rules.json
Customize commands: Edit individual command files in commands/
Add new agents: Add markdown files to agents/

Requirements

Claude Code CLI
Node.js 18+ (for hooks)
npm or npx

License

MIT

Author

Rafael Kamimura

Version

1.0.0