预光标:为AI代理优化的项目生成器
前光标 这是一个自动化的scaffolding系统,它按照既定的方法生成项目,该方法针对在Cursor IDE中与AI代理合作进行优化。
______________________________________________________________________
🚀 快速启动
要求
- Python 3.8+
- Git
项目结构
pre-cursor/
├── README.md # Documentación principal
├── init_project.py # Generador principal
├── src/pre_cursor/ # Código fuente
├── templates/ # Plantillas de proyecto
├── docs/ # Documentación técnica
├── docs/guides/ # Guías de usuario
├── config/ # Archivos de configuración
├── scripts/ # Scripts de desarrollo
├── tests/ # Pruebas unitarias
└── examples/ # Ejemplos y demos安装和使用
# Clonar el repositorio
git clone
cd pre_cursor
# Instalar en modo desarrollo
pip install -e ".[dev]"
# CLI mejorado (recomendado)
pre-cursor create MiNuevoProyecto
pre-cursor create mi-api --type "Python Web App (FastAPI)"
pre-cursor template --type "Python Library"
pre-cursor list-types
# CLI legacy (compatible)
python3 init_project.py MiNuevoProyecto
python3 init_project.py --config mi_config.json✨ 主要特征
🎯 项目自动生成
- 模板系统 具有混合占位符处理的全功能
- 11种项目类型 支持(Python、C++、Node.js、TD_MCP等)
- 实际依赖 没有占位符的Python函数和代码
- 灵活配置 支持JSON和YAML
🤖 自动光标管理器
- 自动检测 项目结构问题
- 自动校正 文件错位和重复
- 与IDE光标的集成 连续监测
- 测试主管 用于测试的LLM验证
- 触发系统 用于外部激活和自动监控
- 自动执行器 用于直接文件系统修复
- 计划中的守护者 不断打开IDE
- 反馈回路完成 检测与校正之间
🎯 光标前做什么?
前光标已取消 自动化项目生成器 que:
- 创建完整的项目 遵循既定的方法
- 自动生成文档 (README,BITACORA,教程)
- 配置目录结构 优化开发
- 监督和纠正 IDE光标自动问题
- 验证测试和文件 使用人工智能
它是如何工作的?
from init_project import ProjectGenerator
# Crear generador
generator = ProjectGenerator()
# Generar proyecto completo
generator.generate_project("MiProyecto")______________________________________________________________________
🎯 改进的CLI
Pre-Cursor包括一个现代化和专业的命令行界面,具有以下功能:
✨ CLI特征
- 专业子命令:
create,template,generate,list-types,info - 自动完成:完全支持bash/zsh
- 丰富的界面:桌子、面板和颜色以获得更好的体验
- 互动模式:逐步引导配置
- 试运行:模拟而不创建文件
- 灵活配置:支持JSON和YAML
🚀 主要命令
管理主管
# Verificar estado del supervisor
pre-cursor supervisor status /path/to/project
pre-cursor supervisor status -p # Usar directorio actual
# Iniciar supervisión (verificación única)
pre-cursor supervisor start /path/to/project
pre-cursor supervisor start -p # Usar directorio actual
# Iniciar supervisión continua (daemon)
pre-cursor supervisor start -p --daemon --interval 600
# Configurar supervisor
pre-cursor supervisor config -p --interval 300 --auto-fix true
# Corregir problemas detectados
pre-cursor supervisor fix -p --fix
# Ver logs del supervisor
pre-cursor supervisor logs -p
# Detener supervisión
pre-cursor supervisor stop -p
# Test Supervisor especializado
pre-cursor supervisor test-supervisor -p
pre-cursor supervisor test-supervisor -p --daemon --interval 180
# Validar tests con LLM
pre-cursor supervisor validate-tests -p
pre-cursor supervisor validate-tests -p --cleanup
# Sistema de triggers y monitoreo automático
pre-cursor supervisor trigger-monitor -p --daemon --interval 300
pre-cursor supervisor create-trigger -p
pre-cursor supervisor trigger-status -p
# Integración bidireccional completa
pre-cursor supervisor start-bidirectional -p
pre-cursor supervisor instructions -p
pre-cursor supervisor apply -p
pre-cursor supervisor metrics -p创建项目
# Crear proyecto básico
pre-cursor create mi-proyecto
# Crear con tipo específico
pre-cursor create mi-api --type "Python Web App (FastAPI)"
# Modo interactivo
pre-cursor create mi-proyecto --interactive
# En ruta específica
pre-cursor create mi-proyecto --path /ruta/personalizada
# Crear proyecto openFrameworks
pre-cursor create-of mi-proyecto-of
# Crear proyecto openFrameworks con addons
pre-cursor create-of mi-proyecto-of -a ofxGui -a ofxOsc
# Modo interactivo para openFrameworks
pre-cursor create-of -i
# Listar addons disponibles
pre-cursor create-of --list-addons
# Especificar ruta de openFrameworks
pre-cursor create-of mi-proyecto-of --of-path /ruta/openframeworks模板和配置
# Crear plantilla
pre-cursor template --type "Python Library"
# Crear plantilla YAML
pre-cursor template --type "TD_MCP Project" --format yaml --output mi_config.yaml
# Generar desde configuración
pre-cursor generate mi_config.json
# Simular generación
pre-cursor generate config.yaml --dry-run文件管理
# Procesar documentación temporal
pre-cursor docs process -p # Procesar directorio actual
pre-cursor docs process -p --dry-run # Simular sin cambios
pre-cursor docs process /path/to/project --verbose
# Reorganizar documentación
pre-cursor docs organize -p # Reorganizar directorio actual
# Gestión de cron jobs
pre-cursor docs cron status -p # Verificar estado
pre-cursor docs cron install -p # Instalar (cada 6 horas)
pre-cursor docs cron install -p --interval 12 # Instalar (cada 12 horas)
pre-cursor docs cron remove -p # Eliminar信息和帮助
# Listar tipos disponibles
pre-cursor list-types
# Información del proyecto
pre-cursor info --examples
# Ayuda general
pre-cursor --help
# Ayuda de comando específico
pre-cursor create --help
pre-cursor docs --help🔧 配置自动完成
# Activar autocompletado
source completion.sh
# Ahora puedes usar TAB para autocompletar
pre-cursor # Verá: create template generate list-types info
pre-cursor create # Verá opciones del comando create______________________________________________________________________
📁 项目结构
pre_cursor/
├── README.md # Este archivo
├── BITACORA.md # Log de desarrollo
├── METODOLOGIA_DESARROLLO.md # Metodología establecida
├── init_project.py # Script principal
├── config.py # Configuración
├── pyproject.toml # Configuración del proyecto
├── requirements-dev.txt # Dependencias de desarrollo
├── templates/ # Plantillas de archivos
│ ├── README.md.tpl
│ ├── README_td_mcp.md.tpl # Plantilla específica TD_MCP
│ ├── BITACORA.md.tpl
│ ├── roadmap_v1.md.tpl
│ ├── requirements.txt.tpl
│ ├── requirements_td_mcp.txt.tpl
│ ├── TUTORIAL.md.tpl
│ ├── modulo_principal.py.tpl
│ ├── modulo_principal_td_mcp.py.tpl
│ ├── config_td_mcp.py.tpl
│ ├── config_td_mcp.json.tpl
│ └── [otras plantillas...]
├── src/ # Código fuente del generador
│ ├── config_loader.py # Cargador de configuraciones
│ └── validator.py # Validador de parámetros
├── tests/ # Pruebas
│ ├── README.md
│ ├── test_config_loader.py
│ ├── test_init_project.py
│ ├── test_integration.py
│ └── test_validator.py
├── docs/ # Documentación
├── examples/ # Ejemplos de configuración
│ ├── config_fastapi.yaml
│ └── config_python_library.json
└── structure/ # Estructura base (vacío)______________________________________________________________________
🎯 主要特征
✅ 实施
- 模板系统:带有占位符的可定制模板
- 自动生成:完整的项目生成脚本
- git初始化:自动配置存储库
- 多种类型:支持不同类型的项目
- 文件:完整的文件系统
- 方法论:遵循既定方法
- 验证:输入参数的鲁棒验证
- 配置:支持JSON/YAML配置文件
- TD_MCP集成:针对TD_MCP项目的支持
- openFrameworks集成:与官方OpenFrameworks项目生成器的集成
- 自动化主管:自动检测和纠正问题
- 测试主管:使用LLM验证和清洁测试
- 双向整合:完整的持续监测系统
- 后台守护进程:在没有用户干预的情况下继续执行
- 触发系统:外部激活和自动监测
- 自动执行器:直接文件系统修复
- 游标代理CLI:执行智能提示
- 反馈处理器:自动结果处理
- 文件管理:文件处理和重组
- Cron Jobs para Docs:文件处理自动化
🔄 发展中
- 自动测试:发电机测试套件
- 附加模板:更多项目类型
- 高级配置:更多个性化选项
______________________________________________________________________
🧪 测试
按照指示 tests/README.md 运行测试。
# Ejecutar tests
python3 -m pytest tests/
# Ejecutar con cobertura
python3 -m pytest tests/ --cov=src/
# Verificar generación
python3 init_project.py ProyectoTest______________________________________________________________________
📚 文件
______________________________________________________________________
🔧 支持的项目类型
- Python库:标准Python库
- Python命令行界面工具:命令行工具
- Python Web应用程序(Flask):带有Flask的Web应用程序
- Python Web应用程序(Django):带有Django的Web应用程序
- Python Web应用程序(FastAPI):带有Fastapi的Web应用程序
- Python数据科学:数据科学项目
- Python机器学习/人工智能:机器学习和人工智能项目
- C++项目:C项目++
- Node.js项目:node.js中的项目
- TD_MCP项目:TouchDesigner的MCP项目
- openFrameworks项目:与C互动多媒体项目++
- 另一个:自定义设置
______________________________________________________________________
🚀 通用开发方法
前光标实现 标准化开发方法 可适用于任何项目:
📋 基本原则
- 连续文件:bitacora.md实时更新
- 主动测试:在创建新测试之前评估现有测试
- 模块化组织:清晰的目录结构
- 结构化教程:与日期、课程和摘要一致的格式
🎯 对开发商的好处
- 保证一致性:每个项目遵循相同的方法
- 单一入口点:创建完整项目的单个指令
- 歧义减少:结构化和可预测的信息
- 自动上下文:自动生成的文档
- 逃逸:为增长做好准备的结构
🤖 用于人工智能代理
"Clona el repositorio pre_cursor y ejecuta
python3 init_project.py para crear un nuevo proyecto llamado
'MiNuevaApp' con la descripción 'Una aplicación para
visualización de datos'."______________________________________________________________________
📚 文件
文件结构
docs/-项目技术文件docs/guides/-逐步用户指南docs/CURSOR_SUPERVISOR.md-全自动监督员指南docs/INVESTIGACION_CURSOR_CLI.md-研究与开发docs/METODOLOGIA_DESARROLLO.md-既定方法
可用指南
docs/guides/QUICKSTART.md-快速启动和基本使用docs/guides/GUIA_PASO_A_PASO.md-详细的逐步指导
配置文件
config/-项目配置文件examples/-使用和配置示例scripts/-安装和开发脚本
______________________________________________________________________
🤝 争议
- 叉项目
- 为您的功能创建分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'WIP: Add some AmazingFeature') - 推拉拉马(
git push origin feature/AmazingFeature) - 打开拉动请求
______________________________________________________________________
📄 许可证
这个项目在麻省理工学院的许可下-查看文件 许可证 关于细节。
______________________________________________________________________
👨💻 作者
阿西兹·阿尔卡拉兹·巴克斯特
- Gemini 2.5修订版,Cursor Pro集成开发环境
- 基于以前项目中建立的方法
______________________________________________________________________
📞 联系方式
对于问题或建议,请在存储库中创建问题。
______________________________________________________________________
创建日期: 2024-12-19\ 最新更新: 2024-12-19\ 埃斯塔多:第三阶段完成-测试主管和实施双向集成
