Skill/openspec/changes/archive/2026-02-05-bun-js-runner/tasks.md

1. 项目设置和目录结构

• 1.1 验证 skills/js-runner/ 目录结构
• 1.2 创建 skills/js-runner/scripts/ 目录（注意是复数 scripts/）
• 1.3 确认现有测试文件 skills/js-runner/test/axios.js 的状态
• 1.4 验证 Bun 运行时是否已安装（本地开发环境）

2. 实现临时路径生成辅助脚本

• 2.1 创建 skills/js-runner/scripts/get_temp_path.js 文件（使用 JavaScript）
• 2.2 实现 getTempPath(extension) 函数
• 2.3 确保函数生成唯一路径（包含时间戳和随机字符串）
• 2.4 测试辅助脚本的输出格式正确性
• 2.5 使用 bun scripts/get_temp_path.js 验证脚本可执行

3. 编写 SKILL.md 文档

• 3.1 创建 skills/js-runner/SKILL.md 文档
• 3.2 添加必要的 YAML frontmatter：
  • name: js-runner
  • description 描述功能和场景
  • 可选 compatibility 说明 Bun 依赖
• 3.3 编写 Bun 安装说明和先决条件
• 3.4 描述完整的调用流程（供大模型使用）：
  • 执行 bun --version 检查环境
  • 调用 scripts/get_temp_path.js 生成临时文件路径
  • 写入脚本内容到临时文件
  • 使用 bun <temp-file> 执行脚本
  • 输出结果到 stdout/stderr
• 3.5 添加调用流程的完整示例代码
• 3.6 添加依赖管理示例（通过 import 直接引入，Bun 自动处理）
• 3.7 添加 JavaScript 和 TypeScript 执行示例（同样流程）
• 3.8 添加错误处理和故障排除指南
• 3.9 添加辅助函数 API 参考
• 3.10 说明不主动清理临时文件，由系统自动处理

4. 验证 SKILL.md 格式

• 4.1 使用 skills-ref validate ./skills/js-runner 验证格式（如果可用）
• 4.2 确认 frontmatter 符合 Agent Skills 规范
• 4.3 确认 name 字段格式正确（小写、数字、连字符）
• 4.4 确认 description 字段长度在 1024 字符以内
• 4.5 确认文档内容清晰且易于理解

5. 集成和最终验证

• 5.1 手动测试 scripts/get_temp_path.js 辅助脚本
• 5.2 验证 SKILL.md 格式符合规范
• 5.3 验证调用流程的可行性
• 5.4 验证与 python-runner 模式的一致性
• 5.5 提交所有更改到版本控制（如适用）