---
name: lyxy-runner-js
description: Any task that requires Javascript/Typescript processing should use this skill.
compatibility: Requires Bun runtime (https://bun.sh)
---

# lyxy-runner-js

基于 Bun 的 JavaScript/TypeScript 执行技能，提供隔离的脚本执行和自动依赖管理。

## Purpose

**必需依赖**: 此 skill 需要 Bun 运行时，不兼容其他 JavaScript 运行时。

Bun 特性：
- 自动检测和下载依赖（无需 package.json）
- 即时转译 TypeScript
- 跨平台兼容（Windows/macOS/Linux）

**重要**: 如果 Bun 未安装，立即停止任务并引导用户安装。禁止使用 nodejs、npm、yarn、pnpm 等替代工具。

## When to Use

任何 JavaScript/TypeScript 处理任务都应使用此 skill。

### 典型场景
- **数据处理**: JSON/CSV 解析、数据转换
- **API 交互**: HTTP 请求、Web API 调用
- **文件操作**: 文件读写、批量处理
- **脚本自动化**: 构建脚本、任务自动化

### 不适用场景
- ✗ 需要 Node.js 特定 API（如部分原生模块）
- ✗ 需要持久化进程（如服务器）

## Quick Reference

| 场景 | 描述 | 命令 |
|------|------|------|
| 场景1 | 直接执行已存在的脚本 | `bun <script-file>` |
| 场景2 | 在指定路径创建脚本并执行 | 使用 Write 工具创建 → `bun <path>` |
| 场景3 | 使用临时路径执行（默认） | 生成临时路径 → `bun <temp-file>` |

**重要**: 所有场景执行前必须先检查 Bun 环境：`bun --version`

## Workflow

1. **检查 Bun 环境**：执行 `bun --version`，失败则停止并提示安装
2. **选择执行场景**：根据用户意图选择场景1/2/3
3. **执行脚本**：使用 `bun <script>` 运行
4. **捕获输出**：stdout/stderr 分别处理

### 临时路径执行（场景3）

```bash
# 生成临时文件路径
TEMP_FILE=$(bun scripts/get_temp_path.js js)

# 写入脚本内容
cat <<EOF > "$TEMP_FILE"
console.log("Hello from lyxy-runner-js!");
EOF

# 执行脚本
bun "$TEMP_FILE"
```

## References

详细文档请参阅 `references/` 目录：

| 文件 | 内容 |
|------|------|
| `references/examples.md` | 各场景完整示例、TypeScript 示例、依赖管理示例 |
| `references/error-handling.md` | Bun 未安装、语法错误、运行时错误处理 |
| `references/best-practices.md` | 输出处理、临时文件管理、辅助函数 API |