# 快速开始

本指南将帮助你快速上手 MetaCraft，包括安装、运行第一个 prompt，以及参与自举开发。

## 安装

### 1. 克隆仓库
```bash
git clone https://github.com/your-username/metacraft.git
cd metacraft
```

### 2. 安装依赖
```bash
npm install
```

### 3. 安装 Claude Code CLI
确保已安装 Claude Code CLI 并配置好 API 密钥。请参考 [Claude Code 官方文档](https://claude.com/claude-code)。

验证安装：
```bash
claude --version
```

## 运行第一个 Prompt

### 步骤
1. **查看示例 prompt**：打开 `prompts/example.md`，这是一个简单的任务：创建欢迎脚本。
2. **执行 prompt**：
   ```bash
   npm run prompt -- prompts/example.md
   ```
   或者直接使用 Node.js：
   ```bash
   node scripts/run-prompt.js prompts/example.md
   ```
3. **与 AI 交互**：脚本会调用 Claude Code，AI 将生成 `welcome.js` 文件。按照提示操作。
4. **验证结果**：检查生成的 `welcome.js` 文件，并运行它：
   ```bash
   node welcome.js
   ```

## 自举开发流程

MetaCraft 的核心是自举（bootstrapping）——使用工具自身来开发工具。

### 1. 查看待办任务
```bash
cat meta/todo.md
```
或者运行自举循环查看：
```bash
npm start
```

### 2. 选择一个任务
例如“实现prompt引擎”。找到或创建对应的 prompt 文件（`prompts/implement-prompt-engine.md`）。

### 3. 编写 Prompt
Prompt 应清晰描述任务目标、上下文、输出要求。参考已有示例。

### 4. 执行自举循环
```bash
npm start
```
选择任务编号，工具将自动执行对应 prompt，并调用 AI 生成代码。

### 5. 验证与提交
- 运行测试（待实现）。
- 确保构建通过。
- 提交更改到 Git。

### 6. 更新任务状态
自举循环会询问是否标记任务为完成。确认后，`meta/todo.md` 中对应任务将被勾选。

## 项目结构速查

```
metacraft/
├── prompts/          # 任务prompt库
│   └── example.md   # 示例prompt
├── scripts/         # 核心脚本
│   ├── run-prompt.js # 执行prompt
│   └── bootstrap.js  # 自举循环
├── docs/            # 文档
│   ├── ARCHITECTURE.md
│   └── GETTING_STARTED.md
├── meta/            # 元数据
│   └── todo.md      # 待办任务
├── config/          # 配置（暂无）
├── templates/       # 模板（暂无）
└── package.json
```

## 常见问题

### Claude Code 命令未找到
确保已正确安装 Claude Code CLI，并且 `claude` 命令在 PATH 中。

### 执行 prompt 时卡住
可能是 Claude Code 需要交互式输入。尝试手动运行：
```bash
claude --file prompts/example.md
```

### 如何添加新任务？
1. 在 `meta/todo.md` 中添加一行 `- [ ] 任务描述`。
2. 在 `prompts/` 中创建对应的 prompt 文件（可选）。如果不存在，自举循环会提示创建。

### 如何修改脚本行为？
直接编辑 `scripts/` 下的文件。修改后，可以运行 `npm test` 验证（测试待实现）。

## 下一步

- 阅读 [ARCHITECTURE.md](ARCHITECTURE.md) 了解设计细节。
- 尝试修改 `prompts/example.md` 并观察效果。
- 参与开发：选择一个待办任务，编写 prompt 并提交 Pull Request。