角色驱动开发框架

danwang112/RoleX

0 Stars 28 次浏览更新于 2026-08-23

RoleX 是一个面向AI代理的角色驱动开发（RDD）框架，允许它们拥有持久的身份、目标、计划和任务——所有这些都以Gherkin .feature文件的形式表达。它从PromptX演变而来，重新思考了具有Gherkin原生身份和目标驱动开发的AI角色管理。

开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "rolex": {
      "args": [
        "-y",
        "@rolexjs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

服务介绍

RoleX lets AI agents have persistent identity, goals, plans, and tasks — all expressed in Gherkin .feature files. Instead of starting every conversation from scratch, your AI remembers who it is and what it's working on.

RoleX evolved from PromptX — rethinking AI role management with Gherkin-native identity and goal-driven development.

Core Concepts

Everything is Gherkin. Identity, knowledge, goals, plans, tasks — one format, one language.

Society (Rolex)          # Top-level: create roles, found organizations
  └── Organization       # Team structure: hire/fire roles
       └── Role          # First-person: identity, goals, plans, tasks

Five Dimensions of a Role

Dimension	What it is	Example
Identity	Who I am — persona, knowledge, experience, voice	"I am Sean, a backend architect"
Goal	What I want to achieve — with success criteria	"Build user authentication system"
Plan	How I'll do it — phased execution strategy	"Phase 1: Schema, Phase 2: API, Phase 3: JWT"
Task	Concrete work items — directly executable	"Implement POST /api/auth/register"
Skill	What I can do — AI capabilities, no teaching needed	Tool use, code generation

How It Works

Activate nuwa (the genesis role) — she guides everything else
nuwa creates roles, teaches knowledge, builds organizations
Each role works autonomously: set goals, make plans, execute tasks
Experience accumulates as part of identity — roles grow over time

Quick Start

Install the MCP server and connect it to your AI client. That's it — nuwa will guide you from there.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "rolex": {
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add rolex -- npx -y @rolexjs/mcp-server

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "rolex": {
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "rolex": {
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rolex": {
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "rolex": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

JetBrains IDEs

Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP), click + and paste:

{
  "mcpServers": {
    "rolex": {
      "command": "npx",
      "args": ["-y", "@rolexjs/mcp-server"]
    }
  }
}

Zed

Add to Zed's settings.json:

{
  "context_servers": {
    "rolex": {
      "command": {
        "path": "npx",
        "args": ["-y", "@rolexjs/mcp-server"]
      }
    }
  }
}

After Installation

Start a conversation with your AI and say:

Activate nuwa

nuwa is the genesis role. She will bootstrap the environment and guide you through creating your own roles, organizations, and knowledge systems.

MCP Tools

RoleX provides 15 tools through the MCP server, organized in three layers:

Layer	Tools	Who uses it
Society	`society` (born, found, directory, find, teach)	nuwa only
Organization	`organization` (hire, fire)	nuwa only
Role	`identity`, `focus`, `want`, `plan`, `todo`, `achieve`, `abandon`, `finish`, `synthesize`	Any role

Packages

Package	Description
`@rolexjs/core`	Core types and Platform interface
`@rolexjs/parser`	Gherkin parser (wraps @cucumber/gherkin)
`@rolexjs/local-platform`	Filesystem-based storage implementation
`rolexjs`	Main package — Rolex + Organization + Role + bootstrap
`@rolexjs/mcp-server`	MCP server for AI clients
`@rolexjs/cli`	Command-line interface

Storage Structure

RoleX stores everything in a .rolex/ directory:

.rolex/
├── rolex.json                              # Organization config
├── alex/
│   ├── identity/
│   │   ├── persona.identity.feature        # Who I am
│   │   ├── arch.knowledge.identity.feature # What I know
│   │   └── v1.experience.identity.feature  # What I've learned
│   └── goals/
│       └── auth-system/
│           ├── auth-system.goal.feature    # What I want
│           ├── auth-system.plan.feature    # How I'll do it
│           └── tasks/
│               └── register.task.feature   # Concrete work
└── bob/
    ├── identity/
    └── goals/

查看源码项目主页