技能介绍

它解决什么问题

在 Crowdin 上做本地化时，脚本通常得自己拼 HTTP 请求、保管 token、处理分页和错误码。OOMOL 的 Crowdin 连接器把这些负担挡在 oo CLI 后面：凭据由服务端注入，脚本里不会出现明文令牌。该技能暴露 7 个动作，覆盖分支、目录、源文件三类资源的常见操作。

核心能力

create_branch：为 Crowdin 项目创建分支，用来隔离某一次翻译任务的改动。
create_directory：在项目里新建目录，整理多语言资源结构。
list_projects / list_branches / list_directories / list_files：只读列举，先确认目标是否存在，再决定要不要写入。
upload_file：把源文件推到 Crowdin。

工作方式是先读契约，再发动作。动作的输入输出 schema 靠猜是危险的——用 oo connector schema 拉实时契约，每个动作另有参考文件说明用途和准确命令。

提交载荷时，--data 接受 JSON 对象字符串或 @path/to/file.json；省略则发送 {}。返回结构统一为 { "data": ..., "meta": { "executionId": "..." } }，执行 id 在 meta.executionId，方便对账和排查。

运行规则与边界

只读动作可以直接跑。create_* 和 upload_file 会改变 Crowdin 状态，运行前需要和用户确认载荷内容与预期效果。删除类动作具有破坏性，必须明确指定目标并获得许可；本技能没有提供删除动作，但这条原则同样适用。

技能默认假设 oo CLI 已安装、已登录、Crowdin 已连接，因此不会主动执行 oo auth login。只有命令真的报出认证或连接错误时，才回退到一次性配置：安装 CLI、登录 OOMOL、按 OAuth2 或 API key 连接 Crowdin。若返回 OOMOL_INSUFFICIENT_CREDIT，说明计费已停，需要充值后重试。

覆盖范围就是这 7 个动作，更复杂的本地化流程需要自行组合，或借助 Crowdin 的其他能力完成。