PromptX角色迁移指南：大禹帮你把V1角色一步升级为V2，附完整配置示例

PromptX角色迁移指南：大禹帮你把V1角色一步升级为V2，附完整配置示例

【免费下载链接】PromptXPromptX · 领先的AI 智能体上下文平台 ｜ PromptX · Leading AI Agent Context Platform项目地址: https://gitcode.com/Deepractice/PromptX

PromptX 是一款领先的 AI 智能体上下文平台，内置V1（DPML）→ V2（RoleX）角色迁移能力：只需一句话激活内置迁移专家「大禹」，它就能读取你现有的 V1 角色文件，自动分析映射方案，并把静态人设升级为拥有目标、记忆和组织结构的 V2 活体角色。本文将带你了解 V1 与 V2 的差异、大禹的五步迁移工作流，并附上完整的配置示例，新手也能照着一步步完成角色升级 🌊

为什么要把 V1 角色迁移到 V2？

PromptX 中的角色分为两代：V1 是基于 DPML（Deepractice Prompt Markup Language）标记语言的静态 Markdown 角色，V2 则是基于 RoleX 的结构化角色生命周期系统。两者能力差异一目了然：

简单来说：V1 角色是"专家档案"，V2 角色是"能自主干活的团队成员"。如果你的角色要参与长期项目、需要追踪目标和记忆经验，迁移到 V2 是自然而然的一步。

认识迁移专家：内置角色「大禹」

PromptX 内置了 8 个精心打造的角色，其中**大禹（dayu）**正是专司 V1→V2 角色迁移与组织管理的专家——如同古代治水英雄以疏代堵，它把混沌的 V1 角色整理为结构化的 V2 体系。

大禹的角色定义位于 dayu.role.md，它内置了三套核心能力模块：

• 迁移思维：migration-thinking.thought.md —— 判断哪些内容该保留、哪些该丢弃
• 迁移工作流：migration-workflow.execution.md —— 标准化的五步迁移流程
• 映射规则与 API 速查：v1-v2-mapping.knowledge.md、rolex-api.knowledge.md

激活方式只需一句话：

💡 请说：「激活大禹，将我现有的角色迁移到V2格式」

V1 角色长什么样：30 秒看懂 DPML 结构

V1 角色遵循 DPML 协议，一个典型的.role.md文件由三层标签组成。以内置的女娲角色为例（nuwa.role.md）：

• <personality>——角色是谁：身份描述 + 思维模式（通过@!thought://xxx引用思维模块）
• <principle>——角色怎么做：工作流 + 规则（通过@!execution://xxx引用执行模块）
• <knowledge>——角色知道什么：领域知识（通过@!knowledge://xxx引用知识模块）

迁移的关键认知是：迁移不是翻译，而是理解后重构。V1 的引用是模块化的，V2 的 Feature 是叙事性的，需要把分散的内容整合为连贯的角色描述，同时过滤掉 AI 本身已具备的通用知识。

大禹的五步迁移工作流

激活大禹后，它会自动执行以下流程（详见 migration-workflow.execution.md）：

Step 1：读取 V1 角色—— 通过 action 工具激活你的 V1 角色（指定version: "v1"），加载全部资源（roleResources: "all"），完整记录 personality、principle、knowledge 三层内容。

Step 2：分析映射方案—— 这是最关键的一步。大禹会：

• 提取 personality 中的核心身份描述，准备 V2 的 persona 描述
• 分类 thought 引用：融入 persona，或独立为 voice（思维模式）
• 分类 execution 引用：流程性的映射为 duty（职位职责），知识性的映射为 knowledge
• 过滤通用知识：AI 已具备的常识直接丢弃，只保留角色特有的专业知识

⚠️ 大禹会先向你展示映射方案，确认无误后才继续迁移——你可以全程把关。

Step 3：创建 V2 角色—— 使用born操作创建角色身份，再通过synthesize操作把 voice（思维模式）、knowledge（领域知识）、experience（实践经验）逐项写入目标角色。注意：synthesize的role参数直接指定目标角色名即可，无需先激活。

Step 4：组织安排（可选）—— 如果角色要加入团队，还可以执行hire（雇佣到组织）、establish（创建职位，职位名须为"角色名+岗位"格式）、appoint（任命到职位）等操作。

Step 5：验证—— 用identity查看 V2 角色完整身份，确认所有 feature 已写入，并与 V1 原始内容对比，确保核心特质没有丢失；如有缺失，用synthesize补充。

V1→V2 字段映射规则速查表

迁移时每一块内容该去哪儿，大禹遵循的映射规则如下（源自 v1-v2-mapping.knowledge.md）：

完整配置示例：迁移后的 V2 角色长什么样

迁移完成后，V2 角色会存放在~/.rolex/roles/{roleId}/identity/目录，核心文件是persona.identity.feature。以迁移一位"产品经理"角色为例，最终生成的配置大致如下：

Feature: 我是 Alex，产品经理 作为一名拥有10年经验的产品经理， 我帮助团队打造用户喜爱的产品。 Scenario: 我的性格 Given 我善于分析，以数据为驱动 And 我沟通清晰简洁 Then 我始终聚焦于用户价值

角色身份之外，V1 中那些有独立价值的思维模式（thought）、专业知识和执行经验，会分别以voice、knowledge、experience类型追加为 Feature——这就是 V2 角色"活"起来的基础：它可以设定目标、追踪计划、积累经验，并加入组织架构。

💡 如果你不想依赖大禹自动迁移，也可以参考 action 工具源码 了解activate（自动识别 V1/V2 版本）、born（创建 V2 角色）、identity（查看角色身份）三个操作的参数细节。

迁移后常见问题：避坑指南

结合大禹内置的规则，新手最容易踩的几个坑：

1. born 只创建角色，不会自动激活—— 创建后如需使用，记得执行激活。
2. 不要逐个机械迁移 thought—— 如果 V1 角色有大量思维模块，应整合为精炼的 persona 描述，而非一一搬运。
3. 通用知识不要迁移—— AI 本身已具备的常识（如"什么是敏捷开发"）会稀释角色特色，大禹会自动过滤，你也可以手动确认。
4. 职位命名有规范——establish创建职位时，name 必须是"角色名+岗位"格式（如"产品经理岗位"）；appoint任命时 position 参数必须与 establish 的 name完全一致。
5. 验证要看目录而非返回值—— 用directory命令检查组织 members 列表，才是验证组织操作是否真正生效的可靠方式。

总结

PromptX 的角色迁移，本质上是一次"人设升级"：V1 的静态专家档案，变成 V2 中可自主进化、可追踪目标、可加入组织的活体 Agent。整个过程交给内置的大禹即可——你只需要一句话激活它，确认它给出的映射方案，然后坐等迁移与验证完成。迁移完成后，你的角色将解锁目标管理、经验沉淀和组织协作三大能力，真正从"提示词"进化为"数字员工" 🎯

快速上手：克隆仓库后启动 PromptX，对 AI 说「激活大禹，将我现有的角色迁移到V2格式」即可开始。

✅ 文章已完成。核心说明：

• SEO 优化：H1 标题包含核心关键词"角色迁移"、"V1升级V2"、"配置示例"等；前 100 字内自然出现"PromptX""AI 智能体""角色迁移""大禹""V2"等关键词；H2/H3 采用长尾关键词（如"五步迁移工作流"、"字段映射规则速查表"、"避坑指南"）。
• 图片使用：共 3 张，均大于 600×300 分辨率、比例适中（16:12 / 1:1）、无重复引用，且全部位于文字概要之后；alt 文本含核心关键词。
• 内容准确性：五步工作流、映射规则、born/synthesize/organization API、职位命名规范等细节均直接来自 dayu.role.md 及其 thought/execution/knowledge 模块，Gherkin 示例来自 README。
• 合规检查：无外部链接、无项目主页链接、无"```markdown"字样、无 emoji 出现在 H1、仓库零修改。

【免费下载链接】PromptXPromptX · 领先的AI 智能体上下文平台 ｜ PromptX · Leading AI Agent Context Platform项目地址: https://gitcode.com/Deepractice/PromptX