Magery Skill CLI

English | 中文

English

Overview

Magery Skill CLI is a full-stack development methodology integration CLI tool that combines OpenSpec spec-driven development and Superpowers skills ecosystem. It provides smart technology stack recommendations, automated PRD generation, architecture diagram visualization, and a comprehensive skills marketplace.

Features

• 🚀 Technology Stack Recommendation: Smart tech stack suggestions for TypeScript, Python, and more
• 📝 PRD Generator: Automated product requirement document generation
• 🏗️ Architecture Diagram Generator: Mermaid-based system architecture visualization
• 📦 Skills Manager: Skills marketplace integration and management
• 👥 Multi-Role Decision Layer: Collaboration between tech director, PM, architects, designers, and DBAs
• 🔌 Cross-Platform Adapters: Support for 40+ AI IDE platforms including Claude Code, Cursor, Codex, and Trae

Installation

npm install -g magery-skill-cli

Quick Start

# Initialize a new Magery project
magery init

# Get technology stack recommendations
magery stack --language TypeScript --size medium

# Generate a PRD
magery prd --requirements "Build an e-commerce platform"

# Generate architecture diagram
magery architecture --preset nextjs

# Browse and manage skills
magery skills browse

# Execute development workflows
magery workflow list

Usage Instructions

1. Project Initialization

Initialize a new Magery project in your current directory:

magery init

This creates the following project structure:

.
├── openspec/           # OpenSpec specification files
│   ├── specs/         # Main specification directory
│   └── changes/       # Change tracking
├── skills/            # Project-specific skills
├── docs/              # Documentation
└── .magery/           # Magery configuration

2. Technology Stack Recommendations

Get smart tech stack suggestions based on your requirements:

# Get recommendations for a new project
magery stack --language TypeScript --size medium

# Available options:
# --language: TypeScript, Python, Go, Rust, Java
# --size: small, medium, large, enterprise
# --category: web, mobile, desktop, api, ml

3. PRD Generation

Generate automated product requirement documents:

# Generate PRD from requirements
magery prd --requirements "Build an e-commerce platform"

# Generate with specific template
magery prd --template api --requirements "REST API for inventory management"

# Interactive PRD generation
magery prd --interactive

4. Architecture Diagram Generation

Create Mermaid-based architecture diagrams:

# Generate from preset
magery architecture --preset nextjs

# Generate from custom spec
magery architecture --spec ./openspec/specs/architecture.md

# Available presets:
# nextjs, nuxt, express, fastapi, nestjs, remix, astro

5. Skills Management

Browse and manage skills from the marketplace:

# Browse available skills
magery skills browse

# Install a skill
magery skills install <skill-name>

# List installed skills
magery skills list

# Update a skill
magery skills update <skill-name>

# Remove a skill
magery skills remove <skill-name>

6. Workflow Execution

Execute development workflows:

# List available workflows
magery workflow list

# Execute a workflow
magery workflow run <workflow-name>

# Available workflows:
# spec-driven: OpenSpec-based development workflow
# skills-first: Skills marketplace development
# fullstack: Complete fullstack development

7. Cross-Platform Integration

Connect with various AI IDE platforms:

# Connect to an IDE
magery connect --platform claude-code

# Sync skills
magery sync --platform cursor

# Available platforms:
# claude-code, cursor, codex, trainee, and 40+ more

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Lint code
npm run lint

Project Structure

magery-skill-cli/
├── src/
│   ├── commands/          # CLI command implementations
│   ├── domain/            # Domain layer - entities and value objects
│   ├── use_cases/         # Use cases - application business logic
│   ├── adapters/          # Adapters - external integrations
│   └── workflows/         # Workflow engines
├── tests/                 # Test suite
├── skills/                # Built-in skills
└── docs/                  # Documentation

Documentation

• Quick Start Guide
• Command Reference

License

ISC

中文

概述

Magery Skill CLI 是一个全栈开发方法论集成 CLI 工具，它结合了 OpenSpec 规范驱动开发和 Superpowers 技能生态系统。提供智能技术栈推荐、自动PRD生成、架构图可视化以及全面的技能市场。

功能特点

• 🚀 技术栈推荐：为 TypeScript、Python 等提供智能技术栈建议
• 📝 PRD 生成器：自动化产品需求文档生成
• 🏗️ 架构图生成器：基于 Mermaid 的系统架构可视化
• 📦 技能管理器：技能市场集成与管理
• 👥 多角色决策层：技术总监、PM、架构师、设计师和 DBA 之间的协作
• 🔌 跨平台适配器：支持 40+ AI IDE 平台，包括 Claude Code、Cursor、Codex 和 Trae

安装

npm install -g magery-skill-cli

快速开始

# 初始化新的 Magery 项目
magery init

# 获取技术栈推荐
magery stack --language TypeScript --size medium

# 生成 PRD
magery prd --requirements "构建一个电商平台"

# 生成架构图
magery architecture --preset nextjs

# 浏览和管理技能
magery skills browse

# 执行开发工作流
magery workflow list

使用说明

1. 项目初始化

在当前目录初始化新的 Magery 项目：

magery init

这将创建以下项目结构：

.
├── openspec/           # OpenSpec 规范文件
│   ├── specs/         # 主规范目录
│   └── changes/       # 变更追踪
├── skills/            # 项目特定技能
├── docs/              # 文档
└── .magery/           # Magery 配置

2. 技术栈推荐

根据您的需求获取智能技术栈建议：

# 获取新项目推荐
magery stack --language TypeScript --size medium

# 可用选项：
# --language: TypeScript, Python, Go, Rust, Java
# --size: small, medium, large, enterprise
# --category: web, mobile, desktop, api, ml

3. PRD 生成

生成自动化产品需求文档：

# 从需求生成 PRD
magery prd --requirements "构建一个电商平台"

# 使用特定模板生成
magery prd --template api --requirements "库存管理的 REST API"

# 交互式 PRD 生成
magery prd --interactive

4. 架构图生成

创建基于 Mermaid 的架构图：

# 从预设生成
magery architecture --preset nextjs

# 从自定义规范生成
magery architecture --spec ./openspec/specs/architecture.md

# 可用预设：
# nextjs, nuxt, express, fastapi, nestjs, remix, astro

5. 技能管理

浏览和管理技能市场的技能：

# 浏览可用技能
magery skills browse

# 安装技能
magery skills install <技能名称>

# 列出已安装的技能
magery skills list

# 更新技能
magery skills update <技能名称>

# 移除技能
magery skills remove <技能名称>

6. 工作流执行

执行开发工作流：

# 列出可用工作流
magery workflow list

# 执行工作流
magery workflow run <工作流名称>

# 可用工作流：
# spec-driven: 基于 OpenSpec 的开发工作流
# skills-first: 技能优先开发
# fullstack: 完整全栈开发

7. 跨平台集成

连接各种 AI IDE 平台：

# 连接到 IDE
magery connect --platform claude-code

# 同步技能
magery sync --platform cursor

# 可用平台：
# claude-code, cursor, codex, trainee 等 40+ 个

开发指南

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

# 代码检查
npm run lint

项目结构

magery-skill-cli/
├── src/
│   ├── commands/          # CLI 命令实现
│   ├── domain/            # 领域层 - 实体和值对象
│   ├── use_cases/         # 用例 - 应用业务逻辑
│   ├── adapters/          # 适配器 - 外部集成
│   └── workflows/         # 工作流引擎
├── tests/                 # 测试套件
├── skills/                # 内置技能
└── docs/                  # 文档

文档

• 快速入门指南
• 命令参考

许可证

ISC