130 lines
5.2 KiB
Markdown
130 lines
5.2 KiB
Markdown
# 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 # 描述工具组件及依赖
|
||
```
|
||
|
||
### 核心组件
|
||
|
||
1. **Prompt 引擎**：解析prompt文件，注入上下文变量，调用Claude Code执行。
|
||
2. **脚本执行器**：运行Node.js脚本，提供统一的API用于文件操作、Git操作、命令执行等。
|
||
3. **上下文管理器**：维护项目状态（如当前模块、依赖关系、待办任务），为AI提供连贯的上下文。
|
||
4. **自举循环**：一个内置的工作流，用于更新工具自身——检测新需求，生成prompt，执行脚本，验证变更。
|
||
|
||
## 快速开始
|
||
|
||
### 前提条件
|
||
- Node.js 18+
|
||
- Claude Code CLI 已安装并配置
|
||
- Git
|
||
|
||
### 初始化新项目
|
||
```bash
|
||
# 使用MetaCraft初始化一个项目（假设已安装meta-cli）
|
||
npx meta-cli init my-project
|
||
```
|
||
|
||
### 开发一个功能
|
||
1. 在 `prompts/` 下创建一个新的prompt文件，描述功能需求。
|
||
2. 运行 `node scripts/run-prompt.js prompts/my-feature.md`，让AI生成代码草案。
|
||
3. 审查生成的代码，运行测试，提交更改。
|
||
|
||
### 参与MetaCraft自举开发
|
||
1. 查看 `meta/todo.md` 获取待开发任务。
|
||
2. 选择任务，在 `prompts/` 中编写或更新prompt。
|
||
3. 执行 `node scripts/bootstrap.js` 启动自举循环，AI将协助实现该任务。
|
||
4. 提交Pull Request。
|
||
|
||
## 工作流示例
|
||
|
||
假设要添加一个REST API端点：
|
||
|
||
1. **任务描述**：创建 `prompts/add-rest-endpoint.md`，描述端点路径、方法、参数、返回类型。
|
||
2. **上下文注入**：工具自动注入现有项目结构、相关模块的代码片段。
|
||
3. **AI执行**：Claude Code读取prompt，生成或修改控制器、路由、模型文件。
|
||
4. **脚本验证**：运行 `node scripts/validate.js` 检查语法、运行单元测试。
|
||
5. **文档更新**：AI同时更新API文档，记录新端点。
|
||
|
||
## 贡献指南
|
||
|
||
MetaCraft 是一个自举项目，欢迎通过以下方式参与：
|
||
|
||
1. **报告问题**：在GitHub Issues中描述问题或建议。
|
||
2. **提交prompt**：改进现有prompt或添加新prompt模板。
|
||
3. **增强脚本**：优化自动化脚本，提高可靠性。
|
||
4. **文档完善**：补充使用案例、最佳实践。
|
||
|
||
请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细流程。
|
||
|
||
## 路线图
|
||
|
||
### 短期（v0.1）
|
||
- [ ] 基础prompt引擎和脚本执行器
|
||
- [ ] 简单的自举循环原型
|
||
- [ ] 初始化项目模板
|
||
- [ ] 基础文档
|
||
|
||
### 中期（v0.5）
|
||
- [ ] 上下文管理器，支持多模块项目
|
||
- [ ] 集成测试框架
|
||
- [ ] 插件系统，支持自定义脚本和prompt类型
|
||
- [ ] 可视化任务看板
|
||
|
||
### 长期（v1.0）
|
||
- [ ] 完整的自举闭环，工具能独立完成大部分自身开发任务
|
||
- [ ] 多AI后端支持（Claude, GPT, 本地模型等）
|
||
- [ ] 云协作功能，团队共享prompt库和上下文
|
||
- [ ] 领域特定扩展（Web, 移动, 嵌入式等）
|
||
|
||
## 许可证
|
||
|
||
MIT
|
||
|
||
## 致谢
|
||
|
||
本项目受启发于“元编程”、“自举”理念，以及Claude Code等AI辅助开发工具的出现。我们相信，AI与人类协同的软件开发模式将重塑未来的开发工作流。 |