5.2 KiB
5.2 KiB
MetaCraft: AI-Powered Meta-Development Tool
愿景
MetaCraft 是一个基于AI大语言模型的元开发工具,旨在辅助任意大型项目的开发。其核心思想是:将软件开发过程转化为一系列可组合、可执行的prompt、脚本和文档,并通过Claude Code与AI智能体协作,实现项目的迭代构建。
更特别的是,MetaCraft 项目本身也使用这套工具进行开发,形成“自举”(bootstrapping)的闭环,从而验证和优化工具链的有效性。
核心概念
1. 开发即对话 (Development as Conversation)
- 每个开发任务都可以表示为一个prompt,描述目标、约束和上下文。
- AI(通过Claude Code)理解prompt,并生成或修改代码、文档、脚本。
- 开发者与AI的对话历史成为项目演进的可追溯记录。
2. 可执行的知识 (Executable Knowledge)
- Node.js 脚本 用于自动化重复操作(如文件生成、测试运行、依赖安装)。
- Markdown 文档 记录设计决策、架构说明、使用指南,同时也可作为AI的上下文输入。
- Claude Code 执行 作为与AI交互的桥梁,执行prompt并获取结果。
3. 自举 (Bootstrapping)
- MetaCraft 工具链本身通过MetaCraft定义的工作流进行开发。
- 任何新功能首先被描述为prompt和脚本,然后由AI协助实现,并最终用于增强工具链。
- 这种自举确保工具始终贴近实际开发需求,并能自我改进。
架构概述
MetaCraft/
├── prompts/ # 任务prompt库
│ ├── project-init.md
│ ├── feature-add.md
│ ├── bug-fix.md
│ └── refactor.md
├── scripts/ # Node.js 自动化脚本
│ ├── generate.js
│ ├── validate.js
│ ├── deploy.js
│ └── bootstrap.js # 自举脚本
├── docs/ # 项目文档
│ ├── ARCHITECTURE.md
│ ├── WORKFLOW.md
│ └── SELF-HOSTING.md
├── templates/ # 代码/文件模板
│ └── ...
├── config/ # 配置文件
│ └── default.json
└── meta/ # 工具自身的元数据
└── manifest.json # 描述工具组件及依赖
核心组件
- Prompt 引擎:解析prompt文件,注入上下文变量,调用Claude Code执行。
- 脚本执行器:运行Node.js脚本,提供统一的API用于文件操作、Git操作、命令执行等。
- 上下文管理器:维护项目状态(如当前模块、依赖关系、待办任务),为AI提供连贯的上下文。
- 自举循环:一个内置的工作流,用于更新工具自身——检测新需求,生成prompt,执行脚本,验证变更。
快速开始
前提条件
- Node.js 18+
- Claude Code CLI 已安装并配置
- Git
初始化新项目
# 使用MetaCraft初始化一个项目(假设已安装meta-cli)
npx meta-cli init my-project
开发一个功能
- 在
prompts/下创建一个新的prompt文件,描述功能需求。 - 运行
node scripts/run-prompt.js prompts/my-feature.md,让AI生成代码草案。 - 审查生成的代码,运行测试,提交更改。
参与MetaCraft自举开发
- 查看
meta/todo.md获取待开发任务。 - 选择任务,在
prompts/中编写或更新prompt。 - 执行
node scripts/bootstrap.js启动自举循环,AI将协助实现该任务。 - 提交Pull Request。
工作流示例
假设要添加一个REST API端点:
- 任务描述:创建
prompts/add-rest-endpoint.md,描述端点路径、方法、参数、返回类型。 - 上下文注入:工具自动注入现有项目结构、相关模块的代码片段。
- AI执行:Claude Code读取prompt,生成或修改控制器、路由、模型文件。
- 脚本验证:运行
node scripts/validate.js检查语法、运行单元测试。 - 文档更新:AI同时更新API文档,记录新端点。
贡献指南
MetaCraft 是一个自举项目,欢迎通过以下方式参与:
- 报告问题:在GitHub Issues中描述问题或建议。
- 提交prompt:改进现有prompt或添加新prompt模板。
- 增强脚本:优化自动化脚本,提高可靠性。
- 文档完善:补充使用案例、最佳实践。
请阅读 CONTRIBUTING.md 了解详细流程。
路线图
短期(v0.1)
- 基础prompt引擎和脚本执行器
- 简单的自举循环原型
- 初始化项目模板
- 基础文档
中期(v0.5)
- 上下文管理器,支持多模块项目
- 集成测试框架
- 插件系统,支持自定义脚本和prompt类型
- 可视化任务看板
长期(v1.0)
- 完整的自举闭环,工具能独立完成大部分自身开发任务
- 多AI后端支持(Claude, GPT, 本地模型等)
- 云协作功能,团队共享prompt库和上下文
- 领域特定扩展(Web, 移动, 嵌入式等)
许可证
MIT
致谢
本项目受启发于“元编程”、“自举”理念,以及Claude Code等AI辅助开发工具的出现。我们相信,AI与人类协同的软件开发模式将重塑未来的开发工作流。