cocos-skills

name cocos-skills description Cocos Creator 命令行自动化工具。支持场景管理、资源操作、节点创建、组件绑定、属性设置等常用开发流程。从dev/cocos-skills-main整合的Cocos Creator CLI自动化工具，提供HTTP-based编辑器控制和程序化开发支持。 Cocos Skills Cocos Creator 命令行自动化工具，用于快速完成游戏开发中的重复性操作。 快速开始 # 检查服务状态 cocos-skills health # 查看所有命令 cocos-skills scene -h 常用工作流程 场景编辑流程 打开场景 → 查询节点树 → 修改节点/组件 → 保存场景 # 1. 打开场景 cocos-skills scene open-scene db://assets/scenes/Main.scene # 2. 查询节点树（获取 UUID） cocos-skills scene query-node-tree minimal # 3. 修改操作 # - 创建节点、添加组件、设置属性 # 4. 保存场景 cocos-skills scene save-scene 资源操作流程 导入资源 → 创建预制体 → 绑定组件引用 # 1. 创建资源 cocos-skills asset-db create-asset db://assets/config.json # 2. 创建预制体 cocos-skills prefab create-prefab db://assets/prefabs/Player.prefab # 3. 绑定组件引用 cocos-skills component bind-component 组件管理流程 添加组件 → 设置属性 → 绑定事件 → 测试组件 # 1. 添加组件到节点 cocos-skills component add-component <node-uuid> <component-type> # 2. 设置组件属性 cocos-skills property set-property <node-uuid> <component-uuid> <property-name> <value> # 3. 绑定事件 cocos-skills event bind-event <node-uuid> <event-type> <callback> 核心功能 场景管理 场景打开 : 加载和激活指定场景 场景保存 : 保存当前场景状态 节点查询 : 查询场景节点树结构 场景验证 : 验证场景完整性 节点操作 节点创建 : 创建新节点并设置属性 节点删除 : 安全删除节点及其子节点 节点移动 : 移动节点到指定父节点 节点复制 : 复制节点及其组件 组件操作 组件添加 : 向节点添加指定组件 组件删除 : 从节点删除组件 组件查询 : 查询节点组件信息 组件配置 : 配置组件属性 属性操作 属性设置 : 设置组件属性值 属性获取 : 获取组件属性值 属性验证 : 验证属性值有效性 属性批量操作 : 批量设置多个属性 资源管理 资源创建 : 创建新资源文件 资源导入 : 导入外部资源 资源删除 : 删除指定资源 资源验证 : 验证资源完整性 高级功能 批量操作 # 批量创建节点 cocos-skills node create-batch '[{"name":"Node1"},{"name":"Node2"}]' # 批量设置属性 cocos-skills property set-batch <node-uuid> '{"x":100,"y":200}' # 批量保存场景 cocos-skills scene save-all-scenes 模板系统 # 使用节点模板 cocos-skills template create-node-from-template <template-name> <parent-uuid> # 创建自定义模板 cocos-skills template create-template <template-name> <template-data> 自动化脚本 # 执行自动化脚本 cocos-skills script execute <script-file> # 脚本验证 cocos-skills script validate <script-file> # 脚本调试 cocos-skills script debug <script-file> 开发工具集成 IDE集成 VS Code插件 : Cocos Creator VS Code扩展 命令行工具 : 命令行自动化工具 构建集成 : 与构建系统集成 调试支持 : 调试和错误处理 CI/CD支持 自动化测试 : 自动化测试脚本 构建流水线 : CI/CD流水线集成 部署自动化 : 自动化部署流程 质量检查 : 代码质量检查 版本控制 Git集成 : Git版本控制集成 分支管理 : 分支管理和合并 标签管理 : 版本标签管理 冲突解决 : 合并冲突解决 性能优化 批处理优化 批量操作 : 高效的批量处理算法 内存管理 : 内存使用优化 缓存机制 : 智能缓存机制 异步处理 : 异步操作处理 网络优化 连接池 : HTTP连接池管理 请求优化 : 请求优化和批处理 错误处理 : 网络错误处理 重试机制 : 智能重试机制 数据处理 JSON处理 : 高效JSON处理 数据验证 : 数据格式验证 类型转换 : 类型安全转换 错误处理 : 错误处理和恢复 安全考虑 权限控制 访问控制 : 基于角色的访问控制 操作验证 : 操作权限验证 安全日志 : 安全操作日志 审计跟踪 : 操作审计跟踪 数据保护 数据加密 : 敏感数据加密 备份策略 : 数据备份策略 恢复机制 : 数据恢复机制 完整性检查 : 数据完整性检查 故障排除 常见问题 连接失败 : 检查Cocos Creator HTTP Server状态 权限错误 : 确认编辑器权限设置 格式错误 : 验证JSON格式和数据类型 超时错误 : 检查网络连接和超时设置 调试工具 # 启用调试模式 cocos-skills --debug # 查看详细日志 cocos-skills --verbose # 检查系统状态 cocos-skills health --detailed 错误恢复 自动重试 : 自动重试失败的请求 状态恢复 : 自动恢复编辑器状态 数据恢复 : 自动恢复丢失的数据 服务重启 : 自动重启相关服务 扩展开发 自定义命令 // 创建自定义命令 export class CustomCommand { execute ( params : string []): Promise < void > { // 自定义命令逻辑 } } 插件系统 插件接口 : 标准插件接口 插件加载 : 插件加载和管理 插件配置 : 插件配置和设置 插件扩展 : 插件扩展机制 API集成 REST API : RESTful API支持 WebSocket : WebSocket连接支持 事件系统 : 事件系统接口 钩子机制 : 钩子机制支持 最佳实践 开发规范 代码风格 : 统一的代码风格规范 命名规范 : 清晰的命名规范 文档规范 : 完整的文档规范 测试规范 : 全面的测试规范 性能优化 批量处理 : 优先使用批量操作 缓存策略 : 合理的缓存策略 异步处理 : 使用异步处理 错误处理 : 完善的错误处理 安全实践 输入验证 : 严格的输入验证 权限检查 : 完整的权限检查 日志记录 : 详细的日志记录 审计跟踪 : 完整的审计跟踪 版本: 1.0.0 最后更新: 2026-03-10 集成: Claude Code Game Studios