agentup

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

原始内容

# AgentUp

![Version](https://img.shields.io/badge/version-1.5.0-blue)
![Languages](https://img.shields.io/badge/languages-Go%20%7C%20Node.js%20%7C%20Rust%20%7C%20PHP%20%7C%20Mobile-green)
![Platforms](https://img.shields.io/badge/platforms-Claude%20%7C%20Cursor%20%7C%20Windsurf%20%7C%20Antigravity-purple)
![Python](https://img.shields.io/badge/python-3.x-yellow)
![License](https://img.shields.io/badge/license-MIT-orange)

**AI skills that make your coding assistant write production-grade code.**

AgentUp injects curated knowledge — design patterns, package recommendations, architecture guidelines, and best practices — directly into your AI coding environment. One command, instant upgrade.

[![PayPal](https://img.shields.io/badge/PayPal-Support%20this%20project-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/thinhntq)

---

## Quick Start

```bash
npx @agentup/cli init
```

Pick your platform and languages interactively, or pass flags directly:

```bash
npx @agentup/cli init --platform claude --lang go
npx @agentup/cli init --platform cursor --lang nodejs
npx @agentup/cli init --platform windsurf --lang go,nodejs
npx @agentup/cli init --platform antigravity --lang rust
npx @agentup/cli init --platform cursor --lang php
npx @agentup/cli init --platform claude --lang rust --no-frontend
```

**Supported platforms:** `claude` · `cursor` · `windsurf` · `antigravity`

**Supported languages:** `go` · `nodejs` · `rust` · `php` · `mobile` · `python` _(coming soon)_ · `database` _(coming soon)_

**Frontend skill** (UI/UX) is installed by default alongside any language skill.

---

## What Gets Installed

Running `agentup init` copies skill files into your project:

```
your-project/
└── .claude/skills/          # (or .cursor/skills/, .windsurf/skills/)
    ├── go/
    │   ├── data/            # 13 CSV knowledge databases
    │   ├── scripts/         # BM25 search engine (Python, zero deps)
    │   └── templates/
    ├── nodejs/
    │   ├── data/            # 14 CSV knowledge databases
    │   └── scripts/
    ├── rust/
    │   ├── data/            # 14 CSV knowledge databases
    │   └── scripts/
    ├── php/
    │   ├── data/            # 21 CSV knowledge databases
    │   └── scripts/
    ├── mobile/
    │   ├── data/            # 22 CSV knowledge databases
    │   └── scripts/
    └── frontend/
        ├── data/            # UI/UX knowledge databases
        └── scripts/
```

It also appends the skill workflow to your AI config file (`CLAUDE.md`, `.cursorrules`, `.windsurfrules`), so your AI assistant automatically uses it.

---

## Skills

### Go Backend

13 searchable knowledge domains for production Go code.

| Domain        | Coverage                                                              |
| ------------- | --------------------------------------------------------------------- |
| `pattern`     | Functional Options, Table-Driven, Middleware, Pipeline, Repository... |
| `package`     | Package recommendations by use case                                   |
| `error`       | errors.Is, fmt.Errorf %w, sentinel errors, custom types               |
| `concurrency` | Goroutines, channels, worker pools, context cancellation              |
| `perf`        | Allocations, profiling, sync.Pool, connection pooling                 |
| `test`        | Table-driven, httptest, fuzzing, benchmarks, mocking                  |
| `interface`   | Interface design, composition, contracts                              |
| `arch`        | Project structure, Clean Architecture, DDD                            |
| `idiom`       | Go conventions, naming, style                                         |
| `anti`        | Common anti-patterns to avoid                                         |
| `tooling`     | go vet, golangci-lint, pprof, dlv                                     |
| `module`      | Go modules, versioning, workspaces                                    |

**10 stack guidelines:** `web-gin` · `web-echo` · `web-fiber` · `web-stdlib` · `grpc` · `cli` · `database` · `microservice` · `cloud-native` · `data-pipeline`

**Architecture generator:** multi-domain search that produces complete project architecture, package choices, error strategy, and folder structure.

---

### Node.js / TypeScript

14 searchable knowledge domains for production Node.js/TypeScript code.

| Domain       | Coverage                                                  |
| ------------ | --------------------------------------------------------- |
| `pattern`    | Factory, Strategy, Middleware, Decorator, Observer...     |
| `package`    | Package recommendations by use case                       |
| `error`      | Custom error classes, Result types, error boundaries      |
| `async`      | Promises, async/await, concurrency patterns               |
| `typescript` | Generics, discriminated unions, utility types, decorators |
| `perf`       | Event loop, memory leaks, clustering, caching             |
| `test`       | Vitest, mocking, integration tests, snapshot tests        |
| `arch`       | Modular monolith, Clean Architecture, feature folders     |
| `idiom`      | Node.js conventions, ESM, barrel exports                  |
| `anti`       | Callback hell, blocking I/O, memory leaks                 |
| `tooling`    | ESLint, Prettier, tsx, esbuild, turborepo                 |
| `module`     | npm workspaces, monorepo, versioning                      |

**12 stack guidelines:** `web-express` · `web-fastify` · `web-nestjs` · `web-hono` · `web-nextjs` · `web-remix` · `orm-prisma` · `orm-drizzle` · `database` · `graphql` · `auth` · `realtime`

---

### Rust

14 searchable knowledge domains for production Rust code.

| Domain        | Coverage                                               |
| ------------- | ------------------------------------------------------ |
| `pattern`     | Builder, Newtype, Typestate, RAII, Iterator adaptor... |
| `crate`       | Crate recommendations by use case                      |
| `error`       | thiserror, anyhow, custom error types, Result chaining |
| `concurrency` | Tokio tasks, channels, Mutex, RwLock, rayon            |
| `trait`       | Trait objects, blanket impls, associated types         |
| `perf`        | Zero-cost abstractions, SIMD, allocator, profiling     |
| `test`        | Unit, integration, property-based, cargo-nextest       |
| `arch`        | Domain-driven design, hexagonal, workspace layout      |
| `idiom`       | Ownership, borrowing, lifetimes, idiomatic patterns    |
| `anti`        | Clone overuse, unwrap in prod, blocking async          |
| `tooling`     | clippy, rustfmt, cargo-audit, flamegraph               |
| `module`      | Workspace, feature flags, crate versioning             |
| `unsafe`      | Raw pointers, FFI, unsafe blocks, soundness            |

**11 stack guidelines:** `web-axum` · `web-actix` · `web-warp` · `web-rocket` · `grpc` · `database` · `cli` · `auth` · `async-runtime` · `wasm` · `embedded`

---

### PHP

12 searchable knowledge domains for production PHP code.

| Domain       | Coverage                                               |
| ------------ | ------------------------------------------------------ |
| `pattern`    | Repository, Factory, Observer, Strategy, Middleware... |
| `package`    | Composer package recommendations by use case           |
| `error`      | Custom exceptions, handlers, logging, API errors       |
| `perf`       | OPcache, indexing, eager loading, caching              |
| `test`       | PHPUnit, Pest, factories, mocking, feature tests       |
| `security`   | OWASP top 10, SQL injection, XSS, CSRF, auth           |
| `interface`  | SOLID, type safety, enums, readonly, PSR               |
| `arch`       | MVC, DDD, Hexagonal, CQRS, Modular Monolith            |
| `idiom`      | PHP 8+, match, arrow functions, strict types           |
| `anti`       | God controller, N+1, mass assignment, no validation    |
| `tooling`    | PHPStan, Pint, Rector, Xdebug, Horizon                 |
| `dependency` | Composer, PSR-4, versioning, security audit            |

**8 stack guidelines:** `laravel` · `symfony` · `codeigniter` · `slim` · `api-platform` · `livewire` · `database` · `queue`

---

### Mobile

12 searchable knowledge domains for production mobile code.

| Domain       | Coverage                                                        |
| ------------ | --------------------------------------------------------------- |
| `pattern`    | MVVM, BLoC, Clean Architecture, Repository, MVI, VIPER, Redux   |
| `package`    | Package recommendations by use case (250+ mobile packages)      |
| `error`      | Either types, crash reporting, offline queues, error boundaries |
| `perf`       | Widget rebuilds, list optimization, memory, battery, app size   |
| `test`       | Widget tests, BLoC tests, golden tests, integration, coverage   |
| `security`   | Secure storage, certificate pinning, obfuscation, auth          |
| `interface`  | Responsive layout, accessibility, Material 3, dark mode         |
| `arch`       | Clean Architecture, feature-first, DDD, offline-first, monorepo |
| `idiom`      | Dart null safety, extensions, pattern matching, async/await     |
| `anti`       | Massive widgets, setState abuse, memory leaks, deep nesting     |
| `tooling`    | Flutter DevTools, Fastlane, FVM, Mason, Xcode Instruments       |
| `dependency` | pubspec.yaml, CocoaPods, Gradle, monorepo, version management   |

**9 stack guidelines:** `flutter` · `react-native` · `swiftui` · `jetpack-compose` · `kotlin-multiplatform` · `capacitor` · `expo` · `native-ios` · `native-android`

---

### UI/UX Frontend

Installed by default with any language skill. Covers design systems, component patterns, accessibility, and framework-specific best practices.

**13 stack guidelines:** `react` · `nextjs` · `vue` · `nuxtjs` · `svelte` · `astro` · `react-native` · `flutter` · `swiftui` · `jetpack-compose` · `shadcn` · `nuxt-ui` · `html-tailwind`

---

### Coming Soon

| Skill        | Description                                                                     |
| ------------ | ------------------------------------------------------------------------------- |
| **Python**   | Django, FastAPI, Flask, async patterns, type hints, testing, packaging          |
| **Database** | SQL optimization, schema design, migrations, indexing, PostgreSQL, MySQL, Redis |

---

## How It Works

```
Your question → AI coding assistant
                      ↓
              Reads skill workflow from CLAUDE.md / .cursorrules
                      ↓
              Runs: python3 .claude/skills/go/scripts/search.py "query" --domain pattern
                      ↓
              BM25 search engine ranks results from CSV databases
                      ↓
              AI applies the best patterns, packages, and architecture to your code
```

1. **CSV Databases** — Curated, production-tested knowledge in structured CSV files
2. **BM25 Search Engine** — Fast, relevant search with zero Python dependencies
3. **Domain Auto-Detection** — Automatically routes queries to the most relevant domain
4. **Architecture Generator** — Combines multi-domain search with reasoning rules for new projects

---

## Manual Search

Skills can also be used directly from the terminal:

```bash
# Go — domain search
python3 .claude/skills/go/scripts/search.py "worker pool" --domain concurrency
python3 .claude/skills/go/scripts/search.py "error wrapping context" --domain error
python3 .claude/skills/go/scripts/search.py "middleware auth" --stack web-gin

# Go — architecture generator
python3 .claude/skills/go/scripts/search.py "rest api postgres jwt" --arch-system -p "MyAPI"

# Node.js
python3 .claude/skills/nodejs/scripts/search.py "discriminated union" --domain typescript
python3 .claude/skills/nodejs/scripts/search.py "loader action" --stack web-remix

# Rust
python3 .claude/skills/rust/scripts/search.py "typestate pattern" --domain pattern
python3 .claude/skills/rust/scripts/search.py "middleware extractor" --stack web-axum

# PHP
python3 .claude/skills/php/scripts/search.py "prevent sql injection" --domain security
python3 .claude/skills/php/scripts/search.py "eager load relationship" --stack laravel

# Mobile
python3 .claude/skills/mobile/scripts/search.py "mvvm bloc clean architecture" --domain pattern
python3 .claude/skills/mobile/scripts/search.py "state management viewmodel" --stack flutter
python3 .claude/skills/mobile/scripts/search.py "e-commerce cart checkout" --arch-system -p "ShopApp"

# Auto-detect domain (no flag needed)
python3 .claude/skills/go/scripts/search.py "goroutine channel pipeline"
```

---

## Repository Structure

```
agentup/
├── skills/
│   ├── go/
│   │   ├── data/                # 13 CSV knowledge databases
│   │   │   ├── patterns.csv
│   │   │   ├── packages.csv
│   │   │   ├── concurrency.csv
│   │   │   ├── ...
│   │   │   └── stacks/          # 10 stack CSVs
│   │   ├── scripts/
│   │   │   ├── search.py        # CLI entry point + BM25 engine
│   │   │   ├── core.py          # Search core
│   │   │   └── arch_system.py   # Architecture generator
│   │   └── templates/
│   ├── nodejs/
│   │   ├── data/                # 14 CSV knowledge databases
│   │   └── scripts/
│   ├── rust/
│   │   ├── data/                # 14 CSV knowledge databases
│   │   └── scripts/
│   ├── php/
│   │   ├── data/                # 21 CSV knowledge databases
│   │   └── scripts/
│   ├── mobile/
│   │   ├── data/                # 22 CSV knowledge databases (12 domains + 9 stacks + reasoning)
│   │   ├── scripts/             # BM25 search + architecture generator
│   │   └── templates/
│   └── frontend/
│       ├── data/
│       └── scripts/
└── cli/                         # npm CLI installer (@agentup/cli)
    └── src/
        ├── index.ts
        └── commands/init.ts
```

---

## Prerequisites

- **Python 3.x** — for running skills (no external dependencies)
- **Node.js 18+** — for the CLI installer only

---

## Contributing

Contributions welcome! When adding or editing CSV entries:

- All code examples must compile / run correctly
- Package/crate names must exist on the official registry
- CSV format: proper quoting, UTF-8, LF line endings
- Follow the existing schema for the file you're editing

---

## License

MIT

AgentUp

AI skills that make your coding assistant write production-grade code.

AgentUp injects curated knowledge — design patterns, package recommendations, architecture guidelines, and best practices — directly into your AI coding environment. One command, instant upgrade.

Quick Start

npx @agentup/cli init

Pick your platform and languages interactively, or pass flags directly:

npx @agentup/cli init --platform claude --lang go
npx @agentup/cli init --platform cursor --lang nodejs
npx @agentup/cli init --platform windsurf --lang go,nodejs
npx @agentup/cli init --platform antigravity --lang rust
npx @agentup/cli init --platform cursor --lang php
npx @agentup/cli init --platform claude --lang rust --no-frontend

Supported platforms: claude · cursor · windsurf · antigravity

Supported languages: go · nodejs · rust · php · mobile · python (coming soon) · database (coming soon)

Frontend skill (UI/UX) is installed by default alongside any language skill.

What Gets Installed

Running agentup init copies skill files into your project:

your-project/
└── .claude/skills/          # (or .cursor/skills/, .windsurf/skills/)
    ├── go/
    │   ├── data/            # 13 CSV knowledge databases
    │   ├── scripts/         # BM25 search engine (Python, zero deps)
    │   └── templates/
    ├── nodejs/
    │   ├── data/            # 14 CSV knowledge databases
    │   └── scripts/
    ├── rust/
    │   ├── data/            # 14 CSV knowledge databases
    │   └── scripts/
    ├── php/
    │   ├── data/            # 21 CSV knowledge databases
    │   └── scripts/
    ├── mobile/
    │   ├── data/            # 22 CSV knowledge databases
    │   └── scripts/
    └── frontend/
        ├── data/            # UI/UX knowledge databases
        └── scripts/

It also appends the skill workflow to your AI config file (CLAUDE.md, .cursorrules, .windsurfrules), so your AI assistant automatically uses it.

Skills

Go Backend

13 searchable knowledge domains for production Go code.

Domain	Coverage
`pattern`	Functional Options, Table-Driven, Middleware, Pipeline, Repository...
`package`	Package recommendations by use case
`error`	errors.Is, fmt.Errorf %w, sentinel errors, custom types
`concurrency`	Goroutines, channels, worker pools, context cancellation
`perf`	Allocations, profiling, sync.Pool, connection pooling
`test`	Table-driven, httptest, fuzzing, benchmarks, mocking
`interface`	Interface design, composition, contracts
`arch`	Project structure, Clean Architecture, DDD
`idiom`	Go conventions, naming, style
`anti`	Common anti-patterns to avoid
`tooling`	go vet, golangci-lint, pprof, dlv
`module`	Go modules, versioning, workspaces

10 stack guidelines: web-gin · web-echo · web-fiber · web-stdlib · grpc · cli · database · microservice · cloud-native · data-pipeline

Architecture generator: multi-domain search that produces complete project architecture, package choices, error strategy, and folder structure.

Node.js / TypeScript

14 searchable knowledge domains for production Node.js/TypeScript code.

Domain	Coverage
`pattern`	Factory, Strategy, Middleware, Decorator, Observer...
`package`	Package recommendations by use case
`error`	Custom error classes, Result types, error boundaries
`async`	Promises, async/await, concurrency patterns
`typescript`	Generics, discriminated unions, utility types, decorators
`perf`	Event loop, memory leaks, clustering, caching
`test`	Vitest, mocking, integration tests, snapshot tests
`arch`	Modular monolith, Clean Architecture, feature folders
`idiom`	Node.js conventions, ESM, barrel exports
`anti`	Callback hell, blocking I/O, memory leaks
`tooling`	ESLint, Prettier, tsx, esbuild, turborepo
`module`	npm workspaces, monorepo, versioning

12 stack guidelines: web-express · web-fastify · web-nestjs · web-hono · web-nextjs · web-remix · orm-prisma · orm-drizzle · database · graphql · auth · realtime

Rust

14 searchable knowledge domains for production Rust code.

Domain	Coverage
`pattern`	Builder, Newtype, Typestate, RAII, Iterator adaptor...
`crate`	Crate recommendations by use case
`error`	thiserror, anyhow, custom error types, Result chaining
`concurrency`	Tokio tasks, channels, Mutex, RwLock, rayon
`trait`	Trait objects, blanket impls, associated types
`perf`	Zero-cost abstractions, SIMD, allocator, profiling
`test`	Unit, integration, property-based, cargo-nextest
`arch`	Domain-driven design, hexagonal, workspace layout
`idiom`	Ownership, borrowing, lifetimes, idiomatic patterns
`anti`	Clone overuse, unwrap in prod, blocking async
`tooling`	clippy, rustfmt, cargo-audit, flamegraph
`module`	Workspace, feature flags, crate versioning
`unsafe`	Raw pointers, FFI, unsafe blocks, soundness

11 stack guidelines: web-axum · web-actix · web-warp · web-rocket · grpc · database · cli · auth · async-runtime · wasm · embedded

PHP

12 searchable knowledge domains for production PHP code.

Domain	Coverage
`pattern`	Repository, Factory, Observer, Strategy, Middleware...
`package`	Composer package recommendations by use case
`error`	Custom exceptions, handlers, logging, API errors
`perf`	OPcache, indexing, eager loading, caching
`test`	PHPUnit, Pest, factories, mocking, feature tests
`security`	OWASP top 10, SQL injection, XSS, CSRF, auth
`interface`	SOLID, type safety, enums, readonly, PSR
`arch`	MVC, DDD, Hexagonal, CQRS, Modular Monolith
`idiom`	PHP 8+, match, arrow functions, strict types
`anti`	God controller, N+1, mass assignment, no validation
`tooling`	PHPStan, Pint, Rector, Xdebug, Horizon
`dependency`	Composer, PSR-4, versioning, security audit

8 stack guidelines: laravel · symfony · codeigniter · slim · api-platform · livewire · database · queue

Mobile

12 searchable knowledge domains for production mobile code.

Domain	Coverage
`pattern`	MVVM, BLoC, Clean Architecture, Repository, MVI, VIPER, Redux
`package`	Package recommendations by use case (250+ mobile packages)
`error`	Either types, crash reporting, offline queues, error boundaries
`perf`	Widget rebuilds, list optimization, memory, battery, app size
`test`	Widget tests, BLoC tests, golden tests, integration, coverage
`security`	Secure storage, certificate pinning, obfuscation, auth
`interface`	Responsive layout, accessibility, Material 3, dark mode
`arch`	Clean Architecture, feature-first, DDD, offline-first, monorepo
`idiom`	Dart null safety, extensions, pattern matching, async/await
`anti`	Massive widgets, setState abuse, memory leaks, deep nesting
`tooling`	Flutter DevTools, Fastlane, FVM, Mason, Xcode Instruments
`dependency`	pubspec.yaml, CocoaPods, Gradle, monorepo, version management

9 stack guidelines: flutter · react-native · swiftui · jetpack-compose · kotlin-multiplatform · capacitor · expo · native-ios · native-android

UI/UX Frontend

Installed by default with any language skill. Covers design systems, component patterns, accessibility, and framework-specific best practices.

13 stack guidelines: react · nextjs · vue · nuxtjs · svelte · astro · react-native · flutter · swiftui · jetpack-compose · shadcn · nuxt-ui · html-tailwind

Coming Soon

Skill	Description
Python	Django, FastAPI, Flask, async patterns, type hints, testing, packaging
Database	SQL optimization, schema design, migrations, indexing, PostgreSQL, MySQL, Redis

How It Works

Your question → AI coding assistant
                      ↓
              Reads skill workflow from CLAUDE.md / .cursorrules
                      ↓
              Runs: python3 .claude/skills/go/scripts/search.py "query" --domain pattern
                      ↓
              BM25 search engine ranks results from CSV databases
                      ↓
              AI applies the best patterns, packages, and architecture to your code

CSV Databases — Curated, production-tested knowledge in structured CSV files
BM25 Search Engine — Fast, relevant search with zero Python dependencies
Domain Auto-Detection — Automatically routes queries to the most relevant domain
Architecture Generator — Combines multi-domain search with reasoning rules for new projects

Manual Search

Skills can also be used directly from the terminal:

# Go — domain search
python3 .claude/skills/go/scripts/search.py "worker pool" --domain concurrency
python3 .claude/skills/go/scripts/search.py "error wrapping context" --domain error
python3 .claude/skills/go/scripts/search.py "middleware auth" --stack web-gin

# Go — architecture generator
python3 .claude/skills/go/scripts/search.py "rest api postgres jwt" --arch-system -p "MyAPI"

# Node.js
python3 .claude/skills/nodejs/scripts/search.py "discriminated union" --domain typescript
python3 .claude/skills/nodejs/scripts/search.py "loader action" --stack web-remix

# Rust
python3 .claude/skills/rust/scripts/search.py "typestate pattern" --domain pattern
python3 .claude/skills/rust/scripts/search.py "middleware extractor" --stack web-axum

# PHP
python3 .claude/skills/php/scripts/search.py "prevent sql injection" --domain security
python3 .claude/skills/php/scripts/search.py "eager load relationship" --stack laravel

# Mobile
python3 .claude/skills/mobile/scripts/search.py "mvvm bloc clean architecture" --domain pattern
python3 .claude/skills/mobile/scripts/search.py "state management viewmodel" --stack flutter
python3 .claude/skills/mobile/scripts/search.py "e-commerce cart checkout" --arch-system -p "ShopApp"

# Auto-detect domain (no flag needed)
python3 .claude/skills/go/scripts/search.py "goroutine channel pipeline"

Repository Structure

agentup/
├── skills/
│   ├── go/
│   │   ├── data/                # 13 CSV knowledge databases
│   │   │   ├── patterns.csv
│   │   │   ├── packages.csv
│   │   │   ├── concurrency.csv
│   │   │   ├── ...
│   │   │   └── stacks/          # 10 stack CSVs
│   │   ├── scripts/
│   │   │   ├── search.py        # CLI entry point + BM25 engine
│   │   │   ├── core.py          # Search core
│   │   │   └── arch_system.py   # Architecture generator
│   │   └── templates/
│   ├── nodejs/
│   │   ├── data/                # 14 CSV knowledge databases
│   │   └── scripts/
│   ├── rust/
│   │   ├── data/                # 14 CSV knowledge databases
│   │   └── scripts/
│   ├── php/
│   │   ├── data/                # 21 CSV knowledge databases
│   │   └── scripts/
│   ├── mobile/
│   │   ├── data/                # 22 CSV knowledge databases (12 domains + 9 stacks + reasoning)
│   │   ├── scripts/             # BM25 search + architecture generator
│   │   └── templates/
│   └── frontend/
│       ├── data/
│       └── scripts/
└── cli/                         # npm CLI installer (@agentup/cli)
    └── src/
        ├── index.ts
        └── commands/init.ts

Prerequisites

Python 3.x — for running skills (no external dependencies)
Node.js 18+ — for the CLI installer only

Contributing

Contributions welcome! When adding or editing CSV entries:

All code examples must compile / run correctly
Package/crate names must exist on the official registry
CSV format: proper quoting, UTF-8, LF line endings
Follow the existing schema for the file you're editing

License

MIT