okww-axis
给 Claude Code 用的 skill：OKWW（ok-wuthering-waves，鸣潮自动战斗框架）自定义队伍战斗轴的制作与调试手册。
内容是 2026-08 到 2026-10 用 Claude 做了 20 多条轴（心雷穗、日月守、爱琳莫、心锁守……）之后沉淀下来的方法：怎么从攻略视频/宏截图扒轴、持宏引擎怎么写、每一格用判据还是计时、保底加到哪为止、实机报「慢了/没放出来/切早了」怎么查、定稿怎么导出分享。每条规则后面都有一次实机翻车。
这是社区经验整理，不是 ok-ww 官方项目。
装上
skill 放在 Claude Code 的用户级 skills 目录，文件夹名就叫 okww-axis：
git clone https://github.com/wk321425/okww-axis.git ~/.claude/skills/okww-axis
Windows 上 ~ 是 C:\Users\<用户名>。不用 git 的话点 Code → Download ZIP，解压后把文件夹改名成 okww-axis 放进 C:\Users\<用户名>\.claude\skills\（SKILL.md 要在 okww-axis\ 下面一层，别多套一层）。
更新：在那个目录里 git pull，或者重新下 ZIP 覆盖。
用法
在 ok-ww 安装目录里打开 Claude Code，直接说要做什么就行，skill 会自己触发，例如：
- 「按这个视频做个心雷穗的轴」
- 「循环轴第二圈守岸人切早了」
- 「可以了，确认分享」
里面有什么
| 路径 | 内容 |
|---|
SKILL.md | 入口：环境速查、做一条轴的七个阶段（立项→学机制→扒轴→写代码→干跑→实机迭代→定稿）、14 条核心原则 |
references/engine.md | 持宏引擎结构与原语（tap / 切人 / 大招 / 长按 / HUD 看门狗 / 开关重跑） |
references/judgment-and-fallback.md | 判据 vs 计时、去抖、提前量、保底的分界线 |
references/framework-pitfalls.md | ok-ww 框架 API 的坑 |
references/video-extraction.md | 扒攻略视频、读宏截图、对录屏 |
references/dryrun.md / judge-test.md | 干跑工具、离线在录屏/截图上跑判据 |
references/axis-recorder.md / troubleshooting.md | 实机排查：先读跑轴记录，再按症状找根因 |
references/finalize.md | 定稿、导出、分享、备份清单 |
references/teams-index.md | 哪个角色的判据去哪条轴抄 |
scripts/ | 帧表查询、视频工具、离线判据测试、跑轴记录读取、队伍代码静态检查、定稿导出 |
assets/reference_team/Hsin__Rover__Suisui/ | 参考队伍心雷穗 v1.0.0：引擎模板 + 干跑模板（见里面的 README） |
环境
- ok-ww：脚本都用 ok-ww 自带的 python 跑（
<安装目录>/data/apps/ok-ww/python/python.exe），会自己找 working 目录：环境变量 OKWW_WORKING > 当前目录往上找 > <当前目录>/data/apps/ok-ww/working。
- 文档里的
F:\ok-ww、E:\轴视频 是作者机器上的路径，换成你自己的读；team_backup、其他队伍目录、每条轴的 memory 你那边没有，Claude 会先问。
- 可选：
- ffmpeg / PySceneDetect ——
video_tool.py 用来精确跳帧、找剪辑点，OKWW_FFMPEG / OKWW_PYLIB 指定位置，没有就退回 OpenCV。
- 官方动作帧表 xlsx —— 不随附，
frame_data.py --xlsx <路径> 指定。
- 「跑轴记录」插件 ——
run_report.py 读它的记录和反馈包，OKWW_AXIS_RECORDER（插件源码目录）/ OKWW_AXIS_RUNS（记录目录）指定位置。
export_team.py 的备份位置用 OKWW_BACKUP_ROOT 改。
相关项目
协议
AGPL-3.0，跟 ok-wuthering-waves 上游一致。
