claude-dev-kit

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

原始内容

# Claude Dev Kit

A comprehensive, Claude-native developer environment toolkit.

Optimizes your machine for Claude Code development: shell, editor, git, templates, quality gates, and more.

## Two Ways to Install

| Method | Best For | Experience |
|--------|----------|------------|
| **Claude Code Plugin** | Claude Code users | Interactive, conversational setup |
| **Standalone Script** | Anyone | Traditional CLI installer |

Both methods configure the same things - choose based on your preference.

---

## Option 1: Claude Code Plugin (Interactive)

If you have Claude Code, install as a plugin for the full interactive experience:

```bash
# Step 1: Add the marketplace (run inside Claude Code)
/plugin marketplace add auge2u/claude-dev-kit

# Step 2: Install the plugin
/plugin install claude-dev-kit@claude-dev-kit
```

Then use the skills:

```bash
# Ask Claude to set up your environment
"Set up my dev environment"

# Or invoke skills directly
Skill: setup-claude-dev-kit
Skill: setup-cdk-shell
```

**What you get:**
- Claude walks you through options
- Asks about your preferences
- Adapts to your existing setup
- Explains what it's doing

**Other plugin commands:**
```bash
/plugin                              # Interactive plugin browser
/plugin marketplace list             # List installed marketplaces
/plugin marketplace remove claude-dev-kit  # Remove marketplace
```

---

## Option 2: Standalone Script (No Claude Required)

Run directly without Claude Code:

```bash
# One-liner (interactive)
curl -fsSL https://raw.githubusercontent.com/auge2u/claude-dev-kit/main/install.sh | bash

# Or clone first
git clone https://github.com/auge2u/claude-dev-kit.git
cd claude-dev-kit
./install.sh
```

**Fastest install** - no prompts, smart defaults:

```bash
./install.sh --feeling-lucky
```

### Script Options

| Flag | Description |
|------|-------------|
| `--feeling-lucky` | Auto-configure everything with smart defaults |
| `--bundle <name>` | Choose bundle: `minimal`, `standard`, `full` |
| `--non-interactive` | Skip all prompts, use defaults |
| `--help` | Show help |

---

## What Gets Installed

### Bundles

| Bundle | Components | Use Case |
|--------|------------|----------|
| **minimal** | shell | Quick setup, just the essentials |
| **standard** | shell, editor, git, templates | Most developers (default) |
| **full** | all components | Complete optimization |

### Components

| Component | What it does |
|-----------|--------------|
| **Shell** | Zsh, Oh My Zsh, Powerlevel10k, MesloLGS fonts, aliases |
| **Editor** | VS Code/Cursor settings, extensions (GitLens, Error Lens, Prettier) |
| **Git** | Pre-commit hooks, commit templates, PR templates, conventions |
| **Templates** | CLAUDE.md templates, `.claude/` directory scaffolds |
| **Quality** | Linting setup, CI workflows, code review checklists |
| **Memory** | Context management, session export, project memory |

## Installation Modes

The installer detects your environment and adapts:

| Mode | When | Behavior |
|------|------|----------|
| **Greenfield** | Fresh machine, minimal config | Opinionated defaults, fast setup |
| **Adaptation** | Existing setup detected | Respects your config, backs up before changes |

## Updating

```bash
# With Claude Code
claude "update-claude-dev-kit"

# Or re-run install script (idempotent - safe to run multiple times)
./install.sh
```

## Documentation

- [Skills Reference](https://github.com/auge2u/claude-dev-kit/blob/HEAD/skills/README.md) - All available skills
- [Testing Guide](https://github.com/auge2u/claude-dev-kit/blob/HEAD/docs/TESTING.md) - How to test components
- [Troubleshooting](https://github.com/auge2u/claude-dev-kit/blob/HEAD/docs/TROUBLESHOOTING.md) - Common issues and fixes
- [Contributing](https://github.com/auge2u/claude-dev-kit/blob/HEAD/CONTRIBUTING.md) - How to contribute
- [Changelog](https://github.com/auge2u/claude-dev-kit/blob/HEAD/CHANGELOG.md) - Version history

## Requirements

**Required:**
- macOS 12+ or Ubuntu 22.04+
- git, curl

**Optional:**
- [Claude Code](https://claude.ai/code) - For the interactive plugin experience
- VS Code or Cursor - For editor component

## License

MIT

Claude Dev Kit

A comprehensive, Claude-native developer environment toolkit.

Optimizes your machine for Claude Code development: shell, editor, git, templates, quality gates, and more.

Two Ways to Install

Method	Best For	Experience
Claude Code Plugin	Claude Code users	Interactive, conversational setup
Standalone Script	Anyone	Traditional CLI installer

Both methods configure the same things - choose based on your preference.

Option 1: Claude Code Plugin (Interactive)

If you have Claude Code, install as a plugin for the full interactive experience:

# Step 1: Add the marketplace (run inside Claude Code)
/plugin marketplace add auge2u/claude-dev-kit

# Step 2: Install the plugin
/plugin install claude-dev-kit@claude-dev-kit

Then use the skills:

# Ask Claude to set up your environment
"Set up my dev environment"

# Or invoke skills directly
Skill: setup-claude-dev-kit
Skill: setup-cdk-shell

What you get:

Claude walks you through options
Asks about your preferences
Adapts to your existing setup
Explains what it's doing

Other plugin commands:

/plugin                              # Interactive plugin browser
/plugin marketplace list             # List installed marketplaces
/plugin marketplace remove claude-dev-kit  # Remove marketplace

Option 2: Standalone Script (No Claude Required)

Run directly without Claude Code:

# One-liner (interactive)
curl -fsSL https://raw.githubusercontent.com/auge2u/claude-dev-kit/main/install.sh | bash

# Or clone first
git clone https://github.com/auge2u/claude-dev-kit.git
cd claude-dev-kit
./install.sh

Fastest install - no prompts, smart defaults:

./install.sh --feeling-lucky

Script Options

Flag	Description
`--feeling-lucky`	Auto-configure everything with smart defaults
`--bundle <name>`	Choose bundle: `minimal`, `standard`, `full`
`--non-interactive`	Skip all prompts, use defaults
`--help`	Show help

What Gets Installed

Bundles

Bundle	Components	Use Case
minimal	shell	Quick setup, just the essentials
standard	shell, editor, git, templates	Most developers (default)
full	all components	Complete optimization

Components

Component	What it does
Shell	Zsh, Oh My Zsh, Powerlevel10k, MesloLGS fonts, aliases
Editor	VS Code/Cursor settings, extensions (GitLens, Error Lens, Prettier)
Git	Pre-commit hooks, commit templates, PR templates, conventions
Templates	CLAUDE.md templates, `.claude/` directory scaffolds
Quality	Linting setup, CI workflows, code review checklists
Memory	Context management, session export, project memory

Installation Modes

The installer detects your environment and adapts:

Mode	When	Behavior
Greenfield	Fresh machine, minimal config	Opinionated defaults, fast setup
Adaptation	Existing setup detected	Respects your config, backs up before changes

Updating

# With Claude Code
claude "update-claude-dev-kit"

# Or re-run install script (idempotent - safe to run multiple times)
./install.sh

Documentation

Skills Reference - All available skills
Testing Guide - How to test components
Troubleshooting - Common issues and fixes
Contributing - How to contribute
Changelog - Version history

Requirements

Required:

macOS 12+ or Ubuntu 22.04+
git, curl

Optional:

Claude Code - For the interactive plugin experience
VS Code or Cursor - For editor component

License

MIT