# Rune 开发文档

## 技术栈

- 运行时：Bun
- 语言：TypeScript
- CLI 框架：cac
- YAML 解析：yaml
- 测试：bun:test

## 项目结构

```
src/
├── cli.ts              # CLI 入口
├── types.ts            # 类型定义
├── commands/
│   └── init.ts         # init 命令
├── core/
│   ├── config.ts       # 配置加载
│   ├── scanner.ts      # 状态扫描
│   ├── assembler.ts    # 提示词拼装
│   └── task-parser.ts  # 任务解析
├── adapters/
│   ├── opencode.ts     # OpenCode 适配器
│   └── claude-code.ts  # Claude Code 适配器（占位）
└── defaults/
    └── config.ts       # 内置默认配置

tests/                   # 测试目录（镜像 src 结构）
```

## 开发命令

```bash
bun test                      # 运行全部测试
bun test tests/core/          # 运行指定目录测试
bun src/cli.ts init opencode  # 测试 init 命令
```

## 测试策略

### Level 1 — 纯单元/集成测试（当前）

在临时目录执行完整流程，验证文件创建、目录结构、提示词输出。

### Level 2 — 提示词快照测试（后续增强）

对每个阶段捕获提示词输出，与预期快照对比。

### Level 3 — mock-agent 端到端（后续增强）

编排完整闭环：rune 输出 → mock-agent 处理 → rune 继续下一阶段。

### Level 4 — 真实 AI 工具集成（CI 可选）

调用 LLM API 验证输出格式可被解析。