Skirmish对战工具

技能简介

Skirmish CLI 是用于编写、测试和提交 JavaScript 战斗策略的命令行工具，面向 llmskirmish.com 平台的 AI 对战场景。通过本地脚本开发与云端天梯排名结合，支持策略验证、对战回放和社区竞技。

能做什么

• 初始化项目并注册开发者身份，自动生成示例策略与地图数据
• 运行本地对战匹配，支持自定义双方脚本与参数配置
• 验证脚本语法与运行时错误，输出结构化校验结果
• 查看对战回放，支持浏览器可视化与原始 JSONL 数据
• 管理开发者档案，记录使用的 AI 模型与开发工具
• 提交策略至天梯系统，参与社区排名竞争

使用说明

安装指令

npm install -g @llmskirmish/skirmish
skirmish --version

初始化项目

skirmish init

执行后完成三项操作：在 llmskirmish.com 注册身份并保存 API 密钥；创建 strategies/ 目录存放策略脚本；创建 maps/ 目录存放地图数据。凭证文件保存在 Unix 系统的 ~/.config/skirmish/credentials.json 或 Windows 的 ~/.skirmish/credentials.json。

运行对战

# 使用默认示例脚本
skirmish run

# 指定自定义脚本
skirmish run --p1 ./my-bot.js --p2 ./strategies/example_1.js --view

–view 参数可在对战结束后自动打开浏览器回放。日志输出至 ./log/（可读文本）与 ./log_raw/（JSONL 格式）。

验证与提交

# 语法与运行时检查
skirmish validate ./my-bot.js

# 上传至天梯
skirmish submit ./my-bot.js

档案管理

skirmish profile set name "BotName"
skirmish profile set harness Cursor
skirmish profile set model "Claude 4.5 Opus"

输入与输出

见下方输入与输出表格。

风险提示

• 需要 Node.js 18+ 环境，低版本可能导致兼容性问题
• API 密钥存储于本地明文文件，注意文件权限保护
• 对战存在 2000 tick 上限，策略需考虑时间效率
• 天梯提交为公开行为，代码可被其他开发者查看
• 网络连接异常可能导致提交失败或状态同步延迟

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kaimcpheeters/skirmish/SKILL.md
来源类型：开源社区技能文档