{"id":30170001,"url":"https://github.com/lbtlm/claude-autopilot","last_synced_at":"2025-08-11T20:20:16.652Z","repository":{"id":306594925,"uuid":"1022723176","full_name":"lbtlm/claude-autopilot","owner":"lbtlm","description":"🛩️ Claude Autopilot 2.1 - 智能开发环境配置工具，让Claude接管您的项目配置过程","archived":false,"fork":false,"pushed_at":"2025-08-03T11:25:26.000Z","size":713,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-03T13:11:56.642Z","etag":null,"topics":["ai","automation","bash","claude","claude-code","claudecode","development-tools","devops","gloabal","global","global-rules","go","javascript","project-management","python","shell-scripts","vuejs"],"latest_commit_sha":null,"homepage":"https://github.com/lbtlm/claude-autopilot","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lbtlm.png","metadata":{"files":{"readme":"README-EN.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-19T17:26:11.000Z","updated_at":"2025-08-03T11:25:30.000Z","dependencies_parsed_at":"2025-07-26T18:29:39.791Z","dependency_job_id":"f764a247-0c0e-4524-a8a8-51bf8f777e8d","html_url":"https://github.com/lbtlm/claude-autopilot","commit_stats":null,"previous_names":["lbtlm/claude-autopilot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lbtlm/claude-autopilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lbtlm%2Fclaude-autopilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lbtlm%2Fclaude-autopilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lbtlm%2Fclaude-autopilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lbtlm%2Fclaude-autopilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lbtlm","download_url":"https://codeload.github.com/lbtlm/claude-autopilot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lbtlm%2Fclaude-autopilot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269949632,"owners_count":24501998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","bash","claude","claude-code","claudecode","development-tools","devops","gloabal","global","global-rules","go","javascript","project-management","python","shell-scripts","vuejs"],"created_at":"2025-08-11T20:20:12.569Z","updated_at":"2025-08-11T20:20:16.639Z","avatar_url":"https://github.com/lbtlm.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Autopilot 2.1 - Intelligent Development Environment Configuration Tool\n\n**🌐 Language Versions**\n- [简体中文](README.md) | [繁體中文](README-TW.md) | [English](README-EN.md)\n\n\u003e 🛩️ Let Claude Drive Your Development - One-click AI collaborative development environment setup, supporting multiple project types with automated intelligent configuration\n\n## 📋 Project Overview\n\nClaude Autopilot 2.1 is an open-source intelligent development environment configuration tool designed for modern developers. Through simple command-line operations, let Claude automatically drive your project configuration process, setting up perfect AI collaborative development environments for your projects, supporting multiple programming languages and frameworks.\n\n### ✨ Core Features\n\n- 🛩️ **Autopilot Configuration** - Let Claude take control of project setup, hands-free experience\n- 🤖 **Intelligent Detection** - Automatically identify project types and tech stacks\n- 🌍 **Open Source Friendly** - Support deployment anywhere, no hardcoded dependencies\n- 📚 **Multi-Language Support** - Support Go, JavaScript, Python, Bash and more\n- 🔧 **Out-of-the-Box** - No complex configuration needed, ready to use\n\n## 📋 System Requirements\n\n### 🛠️ Required Dependencies\n\n#### 1. **Claude Code CLI** (Required)\nClaude Autopilot 2.1 relies on Claude Code CLI for intelligent development:\n\n```bash\n# Install Claude Code CLI\n# Method 1: Official installation script\ncurl -fsSL https://claude.ai/install.sh | sh\n\n# Method 2: Package manager (if supported)\n# npm install -g @anthropic/claude-code  # Example, follow official docs\n# pip install claude-code              # Example, follow official docs\n\n# Verify installation\nclaude --version\n```\n\n#### 2. **MCP (Model Context Protocol) Servers** (Optional but Recommended)\nFor the best intelligent development experience, we recommend installing the following MCP servers:\n\n**🧠 Core Intelligence Toolkit:**\n\n```bash\n# 1. Sequential Thinking - Complex task decomposition and analysis\nnpm install -g @mcp/sequential-thinking\n\n# 2. Context7 - Dynamic technical documentation retrieval\nnpm install -g @mcp/context7\n\n# 3. Memory - Development experience memory and reuse\nnpm install -g @mcp/memory\n\n# 4. Puppeteer - Web project automation testing (optional)\nnpm install -g @mcp/puppeteer\n```\n\n**📦 MCP Server Configuration (in Claude Code):**\n\nCreate or update `~/.claude/mcp-servers.json`:\n\n```json\n{\n  \"servers\": {\n    \"sequential-thinking\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mcp/sequential-thinking\"]\n    },\n    \"context7\": {\n      \"command\": \"npx\", \n      \"args\": [\"@mcp/context7\"]\n    },\n    \"memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mcp/memory\"]\n    },\n    \"puppeteer\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mcp/puppeteer\"]\n    }\n  }\n}\n```\n\n**⚠️ Note**: MCP server package names and configuration methods should follow official documentation. The above are examples only.\n\n#### 3. **System Tools**\n```bash\n# Ubuntu/Debian\nsudo apt update\nsudo apt install git make curl shellcheck\n\n# macOS\nbrew install git make curl shellcheck\n\n# CentOS/RHEL\nsudo yum install git make curl\n# ShellCheck needs separate installation: https://github.com/koalaman/shellcheck\n```\n\n### ✅ Installation Verification\n\nRun the following commands to verify your environment:\n\n```bash\n# Check required tools\nclaude --version          # Claude Code CLI\ngit --version             # Git version control\nmake --version            # Make build tool\nshellcheck --version      # Shell code checker (optional)\n\n# Check optional tools\nnode --version            # Node.js (needed for MCP servers)\nnpm --version             # npm package manager\n```\n\n---\n\n## 🚀 Quick Start\n\n### 1. Clone and Install\n\n#### 🐧 Linux / macOS Users\n\n```bash\n# Clone project\ngit clone https://github.com/lbtlm/claude-autopilot.git\ncd claude-autopilot\n\n# Set script execution permissions (automatic)\nmake dev-setup\n```\n\n#### 🪟 Windows Users\n\n**Recommended - Use WSL (Windows Subsystem for Linux):**\n\n```bash\n# 1. Install WSL2 (if not installed)\n# Run in PowerShell as administrator:\nwsl --install\n\n# 2. Execute in WSL\ngit clone https://github.com/lbtlm/claude-autopilot.git\ncd claude-autopilot\nmake dev-setup\n```\n\n**Alternative - Use Git Bash:**\n\n```bash\n# 1. Install Git for Windows (includes Git Bash)\n# 2. Execute in Git Bash\ngit clone https://github.com/lbtlm/claude-autopilot.git\ncd claude-autopilot\n\n# Manually set execution permissions (Git Bash environment)\nchmod +x scripts/*.sh\nchmod +x lib/*.sh\n```\n\n**Notes:**\n- ⚠️ Does not support pure Windows Command Prompt or PowerShell\n- ✅ Recommend using WSL2 for best compatibility\n- ⚡ Git Bash works but some features may be limited\n\n### 2. Basic Usage\n\n**🎯 Recommended Method - Using Makefile (Simplest):**\n\n```bash\n# Interactive configuration (beginner-friendly)\nmake setup\n\n# Quick configure current directory\nmake quick-setup\n\n# Configure specific project\nmake quick-setup PROJECT=/path/to/your/project\n\n# Configure new project with specified type\nmake inject-type PROJECT=/path/to/new/project TYPE=gin-microservice\n```\n\n**⚡ Direct Script Usage (Advanced Users):**\n\n```bash\n# Interactive configuration\n./scripts/setup.sh\n\n# Quick configuration\n./scripts/quick-setup.sh [project_path] [project_type]\n```\n\n## 📖 Detailed Usage Guide\n\n### 🎯 Core Usage Methods\n\nClaude Autopilot 2.1 provides three usage methods, from simple to advanced:\n\n#### Method 1: Makefile Commands (⭐ Recommended)\n\n**Simplest usage method, one-click completion:**\n\n```bash\n# View all available commands\nmake help\n\n# 🚀 Quick start (recommended for beginners)\nmake setup                                           # Interactive configuration\nmake quick-setup                                     # Quick configure current directory\n\n# 🎯 Advanced features\nmake inject PROJECT=/path/to/project                 # Auto-detect project type\nmake inject-type PROJECT=/path/to/new TYPE=vue3      # Specify project type\nmake inject-batch PROJECTS_DIR=/path/to/projects     # Batch configuration\n\n# 🔧 Development tools\nmake lint                                            # Code quality check\nmake test                                            # Run tests\nmake dev-setup                                       # Setup development environment\n```\n\n#### Method 2: Direct Script Usage\n\n**For advanced users who need more control:**\n\n```bash\n# Core scripts\n./scripts/setup.sh                                  # Interactive configuration\n./scripts/quick-setup.sh                            # Quick configuration\n./bin/claude-autopilot [project_path] [project_type]        # Core injection script\n\n# Specialized tools\n./scripts/quality-check/health-check.sh             # Health check\n./scripts/project-management/new_project.sh         # New project creation\n```\n\n#### Method 3: System Installation (Optional)\n\n**For global use after system installation:**\n\n```bash\n# Install to system\nsudo make install\n\n# Global usage\nce-inject /path/to/project                          # Direct usage\nsetup.sh                                            # Global interactive configuration\n```\n\n### 🏷️ Supported Project Types\n\n| Project Type | Description | Tech Stack |\n|-------------|-------------|------------|\n| `gin-microservice` | Go Microservice | Go + Gin + Database |\n| `gin-vue3` | Full-stack App | Go + Gin + Vue3 |\n| `vue3-frontend` | Vue3 Frontend | Vue3 + TypeScript + Vite |\n| `react-frontend` | React Frontend | React + TypeScript |\n| `nextjs-frontend` | Next.js App | Next.js + React |\n| `nodejs-general` | Node.js App | Node.js + Express |\n| `python-web` | Python Web | FastAPI/Flask/Django |\n| `python-desktop` | Python Desktop | tkinter/PyQt |\n| `bash-scripts` | Bash Scripts | Shell Scripts |\n| `java-maven` | Java Maven | Java + Maven |\n| `java-gradle` | Java Gradle | Java + Gradle |\n| `rust-project` | Rust Project | Rust + Cargo |\n| `php-project` | PHP Project | PHP + Composer |\n\n### 🎯 Usage Scenarios\n\n#### Scenario 1: New Project Creation\n\n```bash\n# 🎯 Using Makefile (recommended)\nmake setup                                            # Interactive creation\nmake inject-type PROJECT=my-vue3-app TYPE=vue3       # Direct creation\n\n# ⚡ Using scripts\n./scripts/setup.sh                                   # Interactive menu\nmkdir my-vue3-app \u0026\u0026 ./scripts/quick-setup.sh my-vue3-app vue3-frontend\n```\n\n#### Scenario 2: Existing Project Configuration\n\n```bash\n# 🎯 Using Makefile (recommended)\nmake inject PROJECT=/path/to/existing/project        # Auto-detect type\n\n# ⚡ Using scripts\ncd /path/to/existing/project\n./scripts/quick-setup.sh .\n```\n\n#### Scenario 3: Batch Multi-Project Configuration\n\n```bash\n# 🎯 Using Makefile (recommended)\nmake inject-batch PROJECTS_DIR=/path/to/projects     # One-click batch configuration\n\n# ⚡ Using scripts\nfor project in /path/to/projects/*; do\n    ./scripts/quick-setup.sh \"$project\"\ndone\n```\n\n### 🏥 Project Health Check\n\nUse the health check feature to assess project status:\n\n```bash\n# 🎯 Using Makefile (recommended)\nmake health-check                                     # Check current project\n\n# ⚡ Using scripts\n./scripts/setup.sh                                   # Interactive menu option 4\n./scripts/quality-check/health-check.sh /path/to/project    # Direct check\n```\n\n## 🔧 After Configuration\n\nAfter configuration, your project will contain:\n\n### 📁 New Files and Directories\n\n```\nyour-project/\n├── .claude/                 # Claude Code configuration\n│   ├── project.json        # Project configuration file\n│   └── commands/           # Smart command links\n├── CLAUDE.md              # AI collaboration guide\n├── project_process/       # Development process records\n├── project_docs/          # Project documentation\n├── .vscode/              # VSCode configuration\n├── .editorconfig         # Editor configuration\n└── Makefile             # Build commands\n```\n\n### 🎯 Available Smart Commands\n\nAfter configuration, you can use the following smart commands in Claude Code:\n\n## 🚀 **Core Development Commands** - Daily Development Essentials\n\n### 1. 🔧 Smart Feature Development `/smart-feature-dev` or Chinese `/智能功能开发`\n\n**Quickly start new feature development with complete workflow from design to implementation**\n\n```bash\n# Basic usage\n/smart-feature-dev user authentication system\n/智能功能开发 用户登录功能\n\n# Detailed usage\n/smart-feature-dev Create a Vue3 user management interface with CRUD operations\n/smart-feature-dev Implement JWT authentication API endpoints with login, register, refresh token\n```\n\n**Key Features:**\n\n- ✨ Automatically analyze requirements and break down tasks\n- 🏗️ Generate code structure following project architecture\n- 🧪 Create related test files\n- 📝 Update project documentation\n\n---\n\n### 2. 🐛 Smart Bug Fix `/smart-bugfix` or Chinese `/智能Bug修复`\n\n**Quickly diagnose and fix code issues, supporting multiple programming languages**\n\n```bash\n# Basic usage\n/smart-bugfix Page loading slowly\n/智能Bug修复 API返回500错误\n\n# Detailed usage\n/smart-bugfix Vue component rendering error, console shows Cannot read property of undefined\n/smart-bugfix Database connection timeout, queries taking over 30 seconds\n```\n\n**Key Features:**\n\n- 🔍 Intelligent code analysis and issue location\n- 🛠️ Provide multiple fix solutions\n- 📊 Performance optimization suggestions\n- 🧪 Verify fix effectiveness\n\n---\n\n### 3. 🔄 Smart Code Refactor `/smart-code-refactor` or Chinese `/智能代码重构`\n\n**Code refactoring and optimization based on best practices**\n\n```bash\n# Basic usage\n/smart-code-refactor optimize database queries\n/智能代码重构 优化数据库查询\n\n# Detailed usage\n/smart-code-refactor Convert class components to function components using Hooks\n/smart-code-refactor Optimize API endpoints, implement caching and pagination\n```\n\n**Key Features:**\n\n- 🎯 Follow code best practices\n- ⚡ Performance optimization suggestions\n- 🧹 Code cleanup and standardization\n- 📚 Architecture improvement recommendations\n\n---\n\n## 🛠️ **Project Management Commands** - Project Maintenance Tools\n\n### 4. 🔄 Load Global Context `/load-global-context` or Chinese `/加载全局上下文`\n\n**Reload Claude Autopilot environment and project context**\n\n```bash\n# Basic usage\n/load-global-context\n/加载全局上下文\n\n# Force refresh mode\n/load-global-context --force-refresh\n/加载全局上下文 --force-refresh\n```\n\n**Use Cases:**\n\n- 🔧 After updating project configuration\n- 🚨 When commands are not recognized\n- 📝 After modifying project type\n- 🔄 After environment changes\n\n---\n\n### 5. 📊 Project Status Analysis `/project-status-analysis` or Chinese `/项目状态分析`\n\n**Comprehensive analysis of project health and technical debt**\n\n```bash\n# Basic usage\n/project-status-analysis\n/项目状态分析\n\n# Detailed analysis\n/project-status-analysis --detailed\n/项目状态分析 --with-suggestions\n```\n\n**Analysis Content:**\n\n- 🏗️ Project architecture compliance\n- 📦 Dependency versions and security\n- 🧪 Test coverage analysis\n- 📝 Documentation completeness check\n- 🚀 Performance bottleneck identification\n\n---\n\n### 6. 🧹 Project Cleanup `/cleanup-project` or Chinese `/清理残余文件`\n\n**Intelligent project file cleanup, compliant with GNU coding standards**\n\n```bash\n# Complete interactive cleanup\n/cleanup-project\n/清理残余文件\n\n# Automatic mode (skip confirmations)\n/cleanup-project --auto\n\n# Preview mode (show only, don't execute)\n/cleanup-project --dry-run\n\n# Deep cleanup mode\n/cleanup-project --deep\n```\n\n**Cleanup Content:**\n\n- 🗑️ Temporary files and cache\n- 📁 Non-standard directory structures\n- 🔄 Duplicate and redundant files\n- 🏗️ Files not compliant with project architecture\n- 💾 Backup old files (safe cleanup)\n\n---\n\n### 7. 📤 Commit to GitHub `/commit-github` or Chinese `/提交github`\n\n**Smart Git commit with standard commit messages**\n\n```bash\n# Basic usage\n/commit-github\n/提交github\n\n# Specify commit type\n/commit-github --type feat\n/commit-github --type fix\n```\n\n**Key Features:**\n\n- 📝 Automatically analyze code changes\n- 🎯 Generate Conventional Commits compliant messages\n- 🔍 Code quality checks\n- 🚀 Automatic push to remote repository\n\n---\n\n## 💡 **Usage Tips**\n\n### 🎯 **Quick Start**\n\n1. **New Project Development**: Use `/smart-feature-dev` to quickly create features\n2. **Problem Solving**: Use `/smart-bugfix` when encountering bugs\n3. **Code Optimization**: Regularly use `/smart-code-refactor` to improve code quality\n4. **Project Maintenance**: Use `/project-status-analysis` and `/cleanup-project` to keep project healthy\n\n### 🔄 **Command Combination Usage**\n\n```bash\n# Complete development workflow example\n1. /project-status-analysis          # Analyze current project status\n2. /smart-feature-dev new feature    # Develop new feature\n3. /smart-code-refactor optimize     # Refactor and optimize\n4. /cleanup-project                  # Clean temporary files\n5. /commit-github                    # Commit code\n```\n\n### 📝 **Best Practices**\n\n- ✅ Describe requirements in detail for more accurate results\n- ✅ Regularly use project maintenance commands\n- ✅ Combine multiple commands for complex tasks\n- ✅ Use parameter options to customize command behavior\n\n### 🚀 Start Using\n\n1. **Launch Claude Code**:\n   ```bash\n   cd your-project\n   claude code\n   ```\n\n2. **Directly describe requirements**:\n   - \"Help me create user login functionality\"\n   - \"Optimize database query performance\"\n   - \"Add unit tests\"\n\n3. **Enjoy intelligent development experience**!\n\n## 📁 Project Structure Details\n\n### 🏗️ Core Directory Structure\n\n```\nclaude-autopilot/\n├── 📁 scripts/                    # Core scripts directory (main entry)\n│   ├── 🚀 setup.sh               # Interactive configuration script (beginner recommended)\n│   ├── ⚡ quick-setup.sh          # Quick configuration script (experienced users)\n│   ├── 🔧 ce-inject.sh           # Core injection script (core engine)\n│   ├── 📁 project-management/    # Project management tools\n│   ├── 📁 quality-check/         # Quality check tools\n│   └── 📁 autopilot/                 # Autopilot 2.1 intelligent system\n│\n├── 📁 share/claude-autopilot/             # Intelligent context engine\n│   ├── 📁 project-types/         # Project type templates (key configuration)\n│   │   ├── gin-microservice.md   # Go microservice configuration\n│   │   ├── vue3-frontend.md      # Vue3 frontend configuration\n│   │   ├── react-frontend.md     # React frontend configuration\n│   │   ├── python-web.md         # Python Web configuration\n│   │   └── ... (more project types)\n│   │\n│   ├── 📁 commands/              # Smart command definitions\n│   ├── 📁 utils/                 # Utility function library\n│   ├── 📁 templates/             # File templates\n│   └── command-aliases.json      # Command alias configuration\n│\n├── 🔧 Makefile                   # Unified build interface (recommended entry)\n├── 📖 README.md                  # Project documentation (this file)\n├── 📋 CLAUDE.md                  # Claude Code configuration guide\n└── 📄 VERSION                    # Version information\n```\n\n### 🎯 Core Component Description\n\n#### 1. **scripts/ - Script Entry Directory**\n- **setup.sh** - Interactive configuration, suitable for beginners, provides friendly menu interface\n- **quick-setup.sh** - Quick configuration, suitable for experienced users, direct command line usage\n- **ce-inject.sh** - Core injection engine, implementation of all configuration logic\n\n#### 2. **share/claude-autopilot/ - Intelligent Engine Core**\n- **project-types/** - Configuration templates and best practices for various project types\n- **commands/** - Smart command links, supporting Chinese and English commands\n- **utils/** - Core utility functions, providing reusable functional modules\n\n#### 3. **Makefile - Unified Interface**\n- Provides unified entry point for all functions\n- Automatically handles script permissions and dependencies\n- Supports various usage scenarios from simple to advanced\n\n### 🎨 Usage Entry Hierarchy\n\n```\n🏁 Entry Hierarchy (from simple to advanced)\n\n1️⃣ Makefile Interface (recommended, simplest)\n   make setup                    # Beginner-friendly interactive configuration\n   make quick-setup              # One-click quick configuration\n   make inject PROJECT=/path     # Advanced batch configuration\n\n2️⃣ Direct Script Calls (more control)\n   ./scripts/setup.sh            # Interactive menu\n   ./scripts/quick-setup.sh      # Quick configuration\n   ./bin/claude-autopilot        # Direct engine call\n\n3️⃣ System Installation (global usage)\n   sudo make install             # Install to system\n   ce-inject /path/to/project    # Global command usage\n```\n\n### 💡 Design Philosophy\n\n- **🎯 Simplicity First** - Novice users prioritize simple Makefile interface\n- **🔧 Flexible Configuration** - Advanced users can call scripts directly for more control\n- **🧠 Intelligent Perception** - Automatically detect project types and tech stacks\n- **🌍 Open Source Friendly** - No hardcoded paths, support deployment in any environment\n\n## 🛠️ Advanced Configuration\n\n### Custom Project Types\n\nIf you need to support new project types:\n\n1. Create new configuration files in the `share/claude-autopilot/project-types/` directory\n2. Refer to existing configuration file formats (recommend copying similar project types for modification)\n3. Re-run configuration scripts\n\n#### 🔨 Creating Custom Project Type Example\n\n```bash\n# 1. Create new project type configuration\ncp share/claude-autopilot/project-types/gin-microservice.md \\\n   share/claude-autopilot/project-types/my-custom-type.md\n\n# 2. Edit configuration file, modify project description and templates\nvim share/claude-autopilot/project-types/my-custom-type.md\n\n# 3. Test new configuration\n./scripts/quick-setup.sh /path/to/test/project my-custom-type\n```\n\n### Environment Variable Configuration\n\nYou can customize configuration through environment variables:\n\n```bash\n# Custom installation path\nexport CE_INSTALL_PATH=\"/custom/path\"\n\n# Default project type\nexport CE_DEFAULT_PROJECT_TYPE=\"gin-microservice\"\n\n# Enable debug mode\nexport CE_DEBUG=true\n\n# Custom template directory\nexport CE_TEMPLATE_DIR=\"/custom/templates\"\n```\n\n## 🤝 Contribution Guide\n\nWelcome code contributions! Please follow these steps:\n\n1. Fork this repository\n2. Create feature branch: `git checkout -b feature/amazing-feature`\n3. Commit changes: `git commit -m 'Add amazing feature'`\n4. Push branch: `git push origin feature/amazing-feature`\n5. Submit Pull Request\n\n### Development Environment Setup\n\n```bash\n# Configure development environment for this project\n./scripts/quick-setup.sh . bash-scripts\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## 🆘 Troubleshooting\n\n### 🪟 Windows Compatibility Issues\n\n#### **Q: \"chmod: command not found\" error when running scripts on Windows**\n\n**Symptoms**: Scripts show `chmod: command not found` or permission-related errors\n\n**Solutions**:\n\n1. **Recommended - Use WSL2 (Best Experience)**:\n   ```bash\n   # After installing WSL2, run in Ubuntu environment\n   wsl\n   cd /mnt/c/path/to/claude-autopilot\n   make dev-setup\n   ```\n\n2. **Alternative - Use Git Bash**:\n   ```bash\n   # Manually set permissions in Git Bash\n   find scripts/ -name \"*.sh\" -exec chmod +x {} \\;\n   find share/claude-autopilot/utils/ -name \"*.sh\" -exec chmod +x {} \\;\n   ```\n\n3. **Git Configuration Optimization (One-time Setup)**:\n   ```bash\n   # Run in project directory\n   git config core.filemode false\n   git update-index --chmod=+x scripts/setup.sh\n   git update-index --chmod=+x scripts/quick-setup.sh\n   git update-index --chmod=+x scripts/ce-inject.sh\n   ```\n\n#### **Q: Scripts cannot run in PowerShell**\n\n**Symptoms**: Scripts cannot execute in Windows PowerShell or Command Prompt\n\n**Solution**: Pure Windows environments are not supported, please use one of the following:\n- ✅ **WSL2** (recommended): Fully compatible Linux environment\n- ✅ **Git Bash**: Basic functionality available\n- ❌ **PowerShell/CMD**: Not supported\n\n### 🐧 Linux/macOS Common Issues\n\n**Q: Scripts don't have execution permissions**\n```bash\n# Automatically set all script permissions\nmake dev-setup\n\n# Or set manually\nchmod +x scripts/*.sh\nchmod +x lib/*.sh\n```\n\n**Q: Cannot find ce-inject script**\n```bash\n# Ensure project is completely cloned\ngit clone --recurse-submodules https://github.com/lbtlm/claude-autopilot.git\n\n# Check if script exists\nls -la scripts/ce-inject.sh\n```\n\n**Q: Project type detection failed**\n```bash\n# Manually specify project type\n./scripts/quick-setup.sh /path/to/project your-project-type\n\n# View supported project types\nls share/claude-autopilot/project-types/\n```\n\n### 🔧 General Problem Solving\n\n**Q: Makefile commands don't work**\n```bash\n# Check if make is installed\nwhich make\n\n# Install make on Ubuntu/Debian\nsudo apt install build-essential\n\n# Install make on macOS\nxcode-select --install\n```\n\n**Q: Script execution permission issues persist**\n```bash\n# Force reset all permissions\nfind . -name \"*.sh\" -exec chmod +x {} \\;\n\n# Check filesystem mount options (WSL users)\nmount | grep \"your-drive\"\n```\n\n**Q: Claude Code cannot recognize after project configuration**\n```bash\n# Check if configuration files are correctly generated\nls -la .claude/\n\n# Verify CLAUDE.md file\ncat CLAUDE.md | head -20\n\n# Re-run configuration\nmake quick-setup\n```\n\n### Get Help\n\n- 📖 View help: `./scripts/setup.sh --help`\n- 🐛 Report issues: [GitHub Issues](https://github.com/lbtlm/claude-autopilot/issues)\n- 💬 Discussion: [GitHub Discussions](https://github.com/lbtlm/claude-autopilot/discussions)\n\n---\n\n## 🌐 Platform Compatibility\n\n### 📊 Compatibility Matrix\n\n| Platform Environment | Compatibility | Feature Completeness | Recommendation Level | Notes |\n|---------------------|---------------|---------------------|----------------------|-------|\n| 🐧 **Linux (Ubuntu/Debian/CentOS)** | ✅ Full Support | 100% | ⭐⭐⭐⭐⭐ | Native support, best performance |\n| 🍎 **macOS** | ✅ Full Support | 100% | ⭐⭐⭐⭐⭐ | Native support, excellent experience |\n| 🪟 **Windows + WSL2** | ✅ Full Support | 95% | ⭐⭐⭐⭐⭐ | Recommended solution, near-native experience |\n| 🪟 **Windows + Git Bash** | ⚠️ Basic Support | 80% | ⭐⭐⭐ | Usable, some features limited |\n| 🪟 **Windows PowerShell** | ❌ Not Supported | 0% | ❌ | Bash scripts cannot run |\n| 🪟 **Windows Command Prompt** | ❌ Not Supported | 0% | ❌ | Bash scripts cannot run |\n\n### 🎯 Windows User Recommendations\n\n#### **Best Practice - WSL2 Environment**\n```bash\n# 1. Enable WSL feature (PowerShell administrator)\nEnable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux\n\n# 2. Install WSL2 and Ubuntu\nwsl --install -d Ubuntu\n\n# 3. Use in WSL2 (fully compatible)\nwsl\ncd /mnt/c/your/project/path\ngit clone https://github.com/lbtlm/claude-autopilot.git\ncd claude-autopilot\nmake dev-setup\n```\n\n#### **Alternative - Git Bash**\n```bash\n# Limited functionality but basically usable\n# Note: Some advanced features may not work\nchmod +x scripts/*.sh\n./scripts/setup.sh\n```\n\n### ⚡ Performance Comparison\n\n| Environment | Startup Speed | Execution Efficiency | Stability | Development Experience |\n|------------|---------------|---------------------|-----------|----------------------|\n| Linux Native | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 |\n| macOS Native | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 |\n| WSL2 | 🚀🚀🚀🚀 | 🚀🚀🚀🚀 | 🚀🚀🚀🚀 | 🚀🚀🚀🚀🚀 |\n| Git Bash | 🚀🚀🚀 | 🚀🚀🚀 | 🚀🚀🚀 | 🚀🚀🚀 |\n\n---\n\n## 🌟 Future Plans\n\n### 📈 Project Roadmap\n\n- ✅ **v2.0 - Core Features** (Previous Version)\n  - Multi-project type support (18 mainstream tech stacks)\n  - Smart command system (Chinese-English bilingual)\n  - Cross-platform compatibility (Linux/macOS/Windows WSL)\n\n- ✅ **v2.1 - Enhanced Templates** (Current Version)\n  - Improved documentation (multi-language support)\n  - Enhanced Windows compatibility\n  - Optimized smart command system\n  - MIT license and open-source preparation\n\n- 🚧 **v2.2 - Extended Templates** (In Development)\n  - More frontend framework support (Svelte, Angular, Vue2)\n  - Mobile development templates (React Native, Flutter)\n  - Microservice architecture templates (Docker Compose, Kubernetes)\n  - Data science templates (Jupyter, MLOps)\n\n- 🎯 **v2.3 - Intelligence Enhancement** (Planned)\n  - AI-driven project structure optimization\n  - Automatic dependency management and version checking\n  - Integrated CI/CD pipeline generation\n  - Automated code quality checking\n\n- 🔮 **v3.0 - Community Driven** (Long-term Planning)\n  - Community custom template marketplace\n  - Plugin system architecture\n  - Team collaboration template sharing\n  - Enterprise project management integration\n\n### 🤝 Contributing\n\nWe welcome community contributions of new project templates! If you want to add new project type support:\n\n1. **Template Contribution Process**:\n   ```bash\n   # 1. Fork this project\n   git clone https://github.com/lbtlm/claude-autopilot.git\n   \n   # 2. Create new project type template\n   cp share/claude-autopilot/project-types/gin-microservice.md \\\n      share/claude-autopilot/project-types/your-new-type.md\n   \n   # 3. Adjust template content according to your tech stack\n   vim share/claude-autopilot/project-types/your-new-type.md\n   \n   # 4. Submit Pull Request\n   ```\n\n2. **Template Standards**:\n   - Use Markdown format\n   - Include complete project structure description\n   - Provide tech stack-specific best practices\n   - Include appropriate dependencies and tool configurations\n\n3. **Priority Support Tech Stacks**:\n   - 🎯 **High Demand**: Svelte, Angular, Flutter, React Native\n   - 🔧 **Frameworks**: Spring Boot, Laravel, Ruby on Rails\n   - 📊 **Data**: TensorFlow, PyTorch, Apache Spark\n   - ☁️ **Cloud Native**: Serverless, AWS CDK, Terraform\n   - 🎮 **Others**: Unity, Unreal Engine, Electron\n\n---\n\n**Make AI development smarter, more efficient, and more reliable!** ✨\n\n*Open source under MIT license, contributions and improvements welcome.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flbtlm%2Fclaude-autopilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flbtlm%2Fclaude-autopilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flbtlm%2Fclaude-autopilot/lists"}