🚀 一键生成 AI Agent 配置文件

自动生成 AGENTS.md、CLAUDE.md、.cursorrules、MCP Server 配置、Skill 文件，让 Claude Code、Cursor、Copilot 等 AI 编程助手立即理解你的项目。

✨ 特性

• 🔍 智能分析 — 自动检测语言、框架、依赖、构建命令
• 📊 代码质量 — 分析代码质量，检测质量工具和配置
• 🔄 增量更新 — 保留手写内容，只更新生成区间
• 🛡️ 隐私安全 — 纯本地分析，自动过滤敏感环境变量
• 🌐 多语言支持 — Python、JavaScript、TypeScript、Go、Rust、Java、Ruby、PHP

📦 安装

pip install repoize

🎯 快速开始

# 一键扫描 + 生成所有配置文件
repoize init

# 查看项目分析报告（含代码质量分析）
repoize analyze

# 选择性生成配置文件
repoize generate --type agents --type claude --type cursorrules

# 检查项目 Agent 就绪度
repoize check

# 增量更新配置
repoize update

📋 支持的配置文件

📊 代码质量分析

Repoize 不仅生成配置文件，还能分析项目的代码质量：

代码质量: 优秀 (100/100)

代码统计:
  文件数: 39
  总行数: 3,668
  代码行: 2,929
  质量工具: pytest, ruff
  质量配置: pyproject.toml

🔧 高级用法

# 输出 JSON 格式的分析结果
repoize analyze --format json --output analysis.json

# 校验 JSON 输出是否符合 Schema
repoize validate analysis.json

# 跳过环境变量扫描
repoize analyze --no-env

# 强制覆盖已有文件
repoize init --force

📁 示例输出

运行 repoize analyze 后的输出示例：

┌───────────────────────────── 📊 项目健康度报告 ─────────────────────────────┐
│ my-project                                                                  │
└─────────────────────────────────────────────────────────────────────────────┘

语言: Python (主)
语言画像: Python
框架: fastapi, sqlalchemy

Agent 就绪度: 完备 (100/100)
代码质量: 优秀 (85/100)

┌─────────────────────────────────────┬───────────┬──────────────────────┐
│ 配置文件                            │   状态    │ 说明                 │
├─────────────────────────────────────┼───────────┼──────────────────────┤
│ AGENTS.md                           │ ✅ 已配置 │ 通用 Agent 指令      │
│ CLAUDE.md                           │ ❌ 未配置 │ Claude Code 专属指令 │
│ .cursorrules                        │ ❌ 未配置 │ Cursor AI 规则       │
└─────────────────────────────────────┴───────────┴──────────────────────┘

🛠️ 开发

# 克隆仓库
git clone https://github.com/LQDC3417/repoize.git
cd repoize

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 代码检查
ruff check src/ tests/
ruff format --check src/ tests/

📄 License

MIT License - 详见 LICENSE 文件

🚀 Make Any Project AI Agent Friendly

Auto-generate AGENTS.md, CLAUDE.md, .cursorrules, MCP Server config, and Skill files to help Claude Code, Cursor, Copilot and other AI coding assistants understand your project instantly.

✨ Features

• 🔍 Smart Analysis — Auto-detect languages, frameworks, dependencies, and build commands
• 📊 Code Quality — Analyze code quality, detect quality tools and configurations
• 🔄 Incremental Updates — Preserve handwritten content, only update generated sections
• 🛡️ Privacy Safe — Pure local analysis, auto-filter sensitive environment variables
• 🌐 Multi-language — Python, JavaScript, TypeScript, Go, Rust, Java, Ruby, PHP

📦 Installation

pip install repoize

🎯 Quick Start

# Scan + generate all config files
repoize init

# View project analysis report (with code quality)
repoize analyze

# Generate specific config files
repoize generate --type agents --type claude --type cursorrules

# Check project agent readiness
repoize check

# Incremental update
repoize update

📋 Supported Config Files

📄 License

MIT License - see LICENSE for details