claude-skill-effect-ts

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

原始内容

# Effect-TS Plugin for Claude Code

A comprehensive Claude Code plugin for Effect-TS development. Provides skills, commands, and agents to help you write idiomatic Effect-TS code.

## Installation

```bash
/plugin marketplace add andrueandersoncs/claude-skill-effect-ts
/plugin install effect-ts@effect-ts
```

## Features

### Skills (22 domains)

The plugin includes skills covering all major Effect-TS domains:

| Skill | Description |
|-------|-------------|
| effect-core | Core Effect types and operations |
| error-management | Typed errors, error handling patterns |
| resource-management | Scope, acquireRelease, resource safety |
| requirements-management | Services, Layers, dependency injection |
| configuration | ConfigProvider, environment variables |
| concurrency | Fibers, concurrent operations |
| scheduling | Schedule combinators, retry policies |
| schema | Schema definition, validation, encoding/decoding |
| data-types | Option, Either, Chunk, HashMap, etc. |
| batching-caching | Request batching, caching strategies |
| observability | Logging, metrics, tracing |
| streams | Stream processing, transformations |
| sinks | Stream consumers and collectors |
| pattern-matching | Match API for exhaustive matching |
| runtime | Runtime configuration and execution |
| platform | Platform-specific APIs (Node, Browser, Bun) |
| testing | TestClock, TestRandom, test utilities |
| code-style | Idiomatic Effect-TS style guidelines |
| state-management | Ref, SynchronizedRef, state patterns |
| traits | Equal, Hash, Order, and other traits |
| effect-ai | AI/LLM integration with Effect |
| api-docs | Look up Effect API documentation via WebFetch |

### Commands

| Command | Description |
|---------|-------------|
| `/effect-check <file>` | Run parallel compliance checks across all rule categories |
| `/effect-review [path]` | Review code for Effect-TS violations (spawns reviewer agent) |
| `/docs <API>` | Look up Effect API documentation |
| `/with-style` | Enforce idiomatic Effect code style |

### Agents

| Agent | Description |
|-------|-------------|
| effect-reviewer | Review ALL TypeScript code for Effect compliance violations |
| effect-migrator | Migrate existing code to Effect-TS patterns |
| category-checker | Check code against a single rule category (used by /effect-check) |

### Rule Categories (effect-agent/)

The plugin bundles structured rule categories for systematic compliance checking:

**Builtin Categories:**
- `async` - Async & Promises (no async/await mixing)
- `conditionals` - Conditional Statements (use Match, not if/else)
- `discriminated-unions` - Tagged union patterns
- `errors` - Error Handling (typed errors, Effect.fail)
- `imperative` - Imperative code patterns to avoid
- `native-apis` - Native API replacements
- `schema` - Schema-first data modeling
- `services` - Services & Layers for testability
- `testing` - Testing best practices

**Custom Categories:**
- `code-style` - Code style & hygiene rules

## Usage

### Parallel Compliance Checking

Run all rule categories as checks in parallel against a file:

```
/effect-check src/services/UserService.ts
```

This spawns one agent per category (10 categories = 10 parallel checks), then aggregates results into a unified report.

### Code Review

Review code for Effect compliance violations:

```
/effect-review src/services/
/effect-review src/handlers/api.ts
```

### API Documentation

Look up Effect API documentation:

```
/docs Effect.retry
/docs Stream.map
/docs Schema.Class
```

## License

MIT License - see [LICENSE](https://github.com/andrueandersoncs/claude-skill-effect-ts/tree/HEAD/LICENSE) for details.

## Author

Andrue Anderson ([@andrueandersoncs](https://github.com/andrueandersoncs))

Effect-TS Plugin for Claude Code

A comprehensive Claude Code plugin for Effect-TS development. Provides skills, commands, and agents to help you write idiomatic Effect-TS code.

Installation

/plugin marketplace add andrueandersoncs/claude-skill-effect-ts
/plugin install effect-ts@effect-ts

Features

Skills (22 domains)

The plugin includes skills covering all major Effect-TS domains:

Skill	Description
effect-core	Core Effect types and operations
error-management	Typed errors, error handling patterns
resource-management	Scope, acquireRelease, resource safety
requirements-management	Services, Layers, dependency injection
configuration	ConfigProvider, environment variables
concurrency	Fibers, concurrent operations
scheduling	Schedule combinators, retry policies
schema	Schema definition, validation, encoding/decoding
data-types	Option, Either, Chunk, HashMap, etc.
batching-caching	Request batching, caching strategies
observability	Logging, metrics, tracing
streams	Stream processing, transformations
sinks	Stream consumers and collectors
pattern-matching	Match API for exhaustive matching
runtime	Runtime configuration and execution
platform	Platform-specific APIs (Node, Browser, Bun)
testing	TestClock, TestRandom, test utilities
code-style	Idiomatic Effect-TS style guidelines
state-management	Ref, SynchronizedRef, state patterns
traits	Equal, Hash, Order, and other traits
effect-ai	AI/LLM integration with Effect
api-docs	Look up Effect API documentation via WebFetch

Commands

Command	Description
`/effect-check <file>`	Run parallel compliance checks across all rule categories
`/effect-review [path]`	Review code for Effect-TS violations (spawns reviewer agent)
`/docs <API>`	Look up Effect API documentation
`/with-style`	Enforce idiomatic Effect code style

Agents

Agent	Description
effect-reviewer	Review ALL TypeScript code for Effect compliance violations
effect-migrator	Migrate existing code to Effect-TS patterns
category-checker	Check code against a single rule category (used by /effect-check)

Rule Categories (effect-agent/)

The plugin bundles structured rule categories for systematic compliance checking:

Builtin Categories:

async - Async & Promises (no async/await mixing)
conditionals - Conditional Statements (use Match, not if/else)
discriminated-unions - Tagged union patterns
errors - Error Handling (typed errors, Effect.fail)
imperative - Imperative code patterns to avoid
native-apis - Native API replacements
schema - Schema-first data modeling
services - Services & Layers for testability
testing - Testing best practices

Custom Categories:

code-style - Code style & hygiene rules

Usage

Parallel Compliance Checking

Run all rule categories as checks in parallel against a file:

/effect-check src/services/UserService.ts

This spawns one agent per category (10 categories = 10 parallel checks), then aggregates results into a unified report.

Code Review

Review code for Effect compliance violations:

/effect-review src/services/
/effect-review src/handlers/api.ts

API Documentation

Look up Effect API documentation:

/docs Effect.retry
/docs Stream.map
/docs Schema.Class

License

MIT License - see LICENSE for details.

Author

Andrue Anderson (@andrueandersoncs)