智能体项目迁移到Archestra
读取现有智能体项目的指令、配置和脚本,生成迁移预览并在确认后导入Archestra,交付迁移报告。
功能与用途
适合把已验证的智能体原型搬到Archestra继续试用。提供源项目目录和目标实例后,可整理项目指令、技能、子智能体、MCP配置及本地脚本,将支持的内容转换为平台中的智能体、技能、工具目录和生命周期钩子。迁移前会展示创建清单、行为变化与待确认事项,经确认并通过预检后执行,最后给出结果报告和优先测试建议。OpenClaw配置及不支持的钩子会列为人工跟进项。使用时需具备Python环境和目标实例访问权限。
适用场景
- 将Claude Code原型搬入平台:把项目指令、技能和斜杠命令转换为Archestra智能体与技能,继续验证原型。
- 迁移试点中的MCP服务配置:将现有MCP配置注册为私有目录项,并按选择安装服务、关联目标智能体。
- 迁移已有自动化钩子:将支持的会话与工具调用钩子转为原生生命周期钩子,列明运行行为差异。
- 梳理混合智能体项目的迁移范围:盘点本地脚本、OpenClaw配置等零散材料,区分可迁移内容与人工跟进事项。
适用人群
- 准备将智能体原型迁入平台的AI工程师
- 维护Claude Code项目的开发者
- 负责企业智能体试点的技术负责人
- 管理Archestra实例的平台工程师
使用步骤
- 提供源项目目录,连接现有Archestra或部署本地实例。
- 扫描项目文件,查看可迁移内容与待处理事项。
- 确认资源归属、MCP安装选择及迁移预览。
- 执行离线预检,修正问题后应用已确认的计划。
- 查看迁移报告,测试关键流程并处理人工跟进项。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-11-03
- 文件数
- 5
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Migrate an existing agentic PoC/pilot (Claude Code project files, MCP configs, hooks, local tools, openclaw config, or similar hand-rolled setup artifacts) into an Archestra instance. Use when the user wants to move, port, or convert an existing agentic setup into an Archestra pilot.
使用前准备
- 已安装该技能,并能在支持技能调用的编码智能体中运行。
- 具备Python 3.10或更高版本,无需额外安装Python运行依赖。
- 能够访问源项目目录,并连接有权限使用的Archestra实例;本地部署可选用Docker。
- 如需迁移模型服务密钥,需另行提供密钥;涉及团队归属时需提供团队ID。
依赖与权限
- [project]
- name = "migrate-to-archestra"
- version = "0.0.0"
- description = "Dev tooling for the migrate-to-archestra skill (not published)."
- requires-python = ">=3.10"
- [tool.uv]
- package = false
- [dependency-groups]
- dev = [
- "pytest==9.0.3",
- "pyyaml==6.0.3", # test-only YAML oracle (the shipped scripts parse frontmatter themselves)
- "ty==0.0.44", # Astral type checker -- the enforced typing gate
- "ruff==0.15.16", # Astral linter -- dead-code / unused-import gate
- ]
- [tool.ty.environment]
- python-version = "3.10"
- [tool.ty.src]
- include = ["scripts", "install.py"]
- [tool.ruff]
- line-length = 120
- target-version = "py310"
- src = ["scripts", "install.py"]
- extend-exclude = ["tests/fixtures"]
- [tool.ruff.lint]
- select = ["F", "E", "I"]
- [tool.ruff.lint.per-file-ignores]
- "install.py" = ["E501"]
- ARCHESTRA_BASE_URL
- ARCHESTRA_API_KEY