From e28c8ebb4afcbed71096da580c13336b5c68b4b1 Mon Sep 17 00:00:00 2001 From: AgustD <1597274666@qq.com> Date: Fri, 13 Jun 2025 23:58:09 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0README=E6=96=87=E4=BB=B6?= =?UTF-8?q?=EF=BC=8C=E5=A2=9E=E5=8A=A0=E9=A1=B9=E7=9B=AE=E6=A0=87=E9=A2=98?= =?UTF-8?q?=E5=92=8C=E5=BE=BD=E7=AB=A0=EF=BC=8C=E4=BC=98=E5=8C=96=E5=86=85?= =?UTF-8?q?=E5=AE=B9=E7=BB=93=E6=9E=84=EF=BC=8C=E6=8F=90=E5=8D=87=E5=8F=AF?= =?UTF-8?q?=E8=AF=BB=E6=80=A7=E5=92=8C=E7=94=A8=E6=88=B7=E4=BD=93=E9=AA=8C?= =?UTF-8?q?=EF=BC=8C=E8=AF=A6=E7=BB=86=E8=AF=B4=E6=98=8EPromptX=E7=9A=84?= =?UTF-8?q?=E5=8A=9F=E8=83=BD=E5=92=8C=E4=BD=BF=E7=94=A8=E6=95=88=E6=9E=9C?= =?UTF-8?q?=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README_EN.md | 163 +++++++++++++++++++++++++++++++-------------------- 1 file changed, 101 insertions(+), 62 deletions(-) diff --git a/README_EN.md b/README_EN.md index 10be2b1..c98a9e4 100644 --- a/README_EN.md +++ b/README_EN.md @@ -1,7 +1,15 @@
PromptX Logo -

AI-native professional capability enhancement system

-

Provides specialized roles, memory management, and knowledge systems for AI applications through MCP protocol

+

PromptX ยท AI-native Professional Capability Enhancement System

+

Provides specialized roles, memory management, and knowledge systems for AI applications through MCP protocol. One command to transform any AI client into a professional powerhouse.

+ + +

+ Stars + npm version + License + CI Status +

ไธญๆ–‡ | @@ -10,41 +18,50 @@

+--- + +### โœจ **Understanding PromptX at a Glance** + +What can PromptX do? Simply put, it gives your AI assistant a "brain" and "memory." + +- **๐ŸŽญ Professional Role-Playing**: Provides expert roles across different domains, making AI responses more professional and in-depth. +- **๐Ÿง  Long-term Memory & Knowledge Base**: AI can remember key information and your preferences, providing coherent and personalized support in ongoing conversations and work. +- **๐Ÿ”Œ Easy Integration**: With just one command, seamlessly enable these powerful features for dozens of mainstream AI applications (like Claude, Cursor). +
-# PromptX +### ๐Ÿ“ธ **Usage Effects After Configuration** -> **AI-native professional capability enhancement system** - Provides specialized roles, memory management, and knowledge systems for AI applications through MCP protocol +#### **1. Discover and Activate Professional Roles** +*Use `promptx_hello` to discover available roles, then `promptx_action` to activate them, instantly transforming your AI into a domain expert.* +Role Discovery and Activation -[ไธญๆ–‡](README.md) | **English** | [Issues](https://github.com/Deepractice/PromptX/issues) +#### **2. Intelligent Memory** +*Use `promptx_remember` to save key information, and AI will proactively apply this knowledge in subsequent interactions.* +Memory Feature -## ๐Ÿš€ Quick Start - Direct AI Application Integration +--- -### ๐Ÿ”Œ **MCP Standardized Integration** +## ๐Ÿš€ **Quick Start - 30-Second Setup** -# Configure MCP connection in AI applications (minimal setup) - -#### **โšก Zero-Configuration Integration (Recommended)** -Add to your AI application's MCP configuration file: +Open your configuration file and copy the `promptx` configuration code below. This is the simplest **zero-configuration mode**, where PromptX automatically handles everything for you. ```json { "mcpServers": { "promptx": { + // Use npx to run promptx service "command": "npx", + // '-y' auto-confirm, '-f' force refresh cache, 'dpml-prompt@snapshot' use latest version, 'mcp-server' start service "args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"] } } } ``` -**๐ŸŽฏ That's it!** PromptX automatically: -- โœ… **Intelligent workspace detection** - Automatically finds suitable workspace -- โœ… **Auto environment initialization** - No manual folder/config creation needed -- โœ… **Dynamic project adaptation** - Works seamlessly across different projects +**๐ŸŽฏ It's that simple!** Save the file and restart your AI application, and PromptX is successfully activated. -#### **๐Ÿ”ง Advanced Configuration (Optional)** -For custom configurations: +๐Ÿ”ง If you want to specify a particular folder as PromptX's workspace, you can add the `env` environment variable. ```json { @@ -53,6 +70,9 @@ For custom configurations: "command": "npx", "args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"], "env": { + // PROMPTX_WORKSPACE: Custom workspace path (optional, automatically detected by default) + // Windows: "D:\\path\\to\\your\\project" (note the double backslashes) + // macOS/Linux: "/Users/username/path/your/project" "PROMPTX_WORKSPACE": "/your/custom/workspace/path" } } @@ -60,16 +80,43 @@ For custom configurations: } ``` +
+ +--- + +### โš™๏ธ **How It Works** + +PromptX acts as a "professional capability middleware" between you and your AI application, communicating through the standard [MCP protocol](https://github.com/metacontroller/mcp). + +```mermaid +graph TD + subgraph "Your AI App (Claude,Cursor,etc.)" + A[๐Ÿ‘จโ€๐Ÿ’ป User Interaction] + end + + subgraph "PromptX MCP Server" + C{PromptX Engine} + D[๐ŸŽญ Role Library] + E[๐Ÿง  Memory & Knowledge] + end + + A -- "Calls 'promptx_...' tools" --> B(MCP Protocol) + B --> C + C -- "Accesses" --> D + C -- "Accesses" --> E + + subgraph "Enhanced Response" + F[โœจ Professional Output] + end + C --> F +``` + +When you call the `promptx_...` series of tools, your AI application sends the request via the MCP protocol to PromptX. The PromptX engine loads the appropriate professional roles, retrieves relevant memories, and then returns a professionally enhanced result to your AI application, which is ultimately presented to you. + +--- + ### New to MCP? [Watch MCP Tutorial on BiliBili](https://www.bilibili.com/video/BV1HFd6YhErb) -##### ๐Ÿ”ง Advanced Options: -- `PROMPTX_WORKSPACE`: Custom workspace path (optional, auto-detected by default) - -##### ๐Ÿ“‚ Custom Workspace Path Formats - -- **Windows**: `"D:\\username\\path\\your\\project"` (use double backslashes) -- **macOS/Linux**: `"/Users/username/path/your/project"` - #### **Supported AI Applications** | Application | Status | Configuration | Notes | @@ -92,38 +139,23 @@ For custom configurations: | **่…พ่ฎฏ CodeWhisperer** | ๐ŸŸก Planned | Tencent Cloud IDE | Tencent's AI programming tool | > **Legend**: -> - โœ… **Official Support**: Native MCP protocol support -> - ๐ŸŸก **Experimental/Community Support**: Support through plugins or experimental features +> - โœ… **Official Support**: Native or official plugin support for MCP protocol. +> - ๐ŸŸก **Experimental/Community/Planned Support**: Support through community plugins, experimental features, or in development plans. > - More AI applications are integrating MCP protocol... -**๐ŸŽฏ After configuration, your AI application gains 6 professional tools:** -- `promptx_init` - ๐Ÿ—๏ธ System initialization -- `promptx_hello` - ๐Ÿ‘‹ Role discovery -- `promptx_action` - โšก Role activation -- `promptx_learn` - ๐Ÿ“š Knowledge learning -- `promptx_recall` - ๐Ÿ” Memory retrieval -- `promptx_remember` - ๐Ÿ’พ Experience saving +**๐ŸŽฏ After configuration, your AI application will automatically gain 6 professional tools:** +- `promptx_init`: ๐Ÿ—๏ธ **System Initialization** - Automatically prepares the working environment. +- `promptx_hello`: ๐Ÿ‘‹ **Role Discovery** - Browse all available expert roles. +- `promptx_action`: โšก **Role Activation** - Transform into an expert in a specific domain with one click. +- `promptx_learn`: ๐Ÿ“š **Knowledge Learning** - Have AI learn specific knowledge or skills. +- `promptx_recall`: ๐Ÿ” **Memory Retrieval** - Look up historical information from the memory repository. +- `promptx_remember`: ๐Ÿ’พ **Experience Saving** - Store important information in long-term memory. ๐Ÿ“– **[Complete MCP Integration Guide](docs/mcp-integration-guide.md)** -### **๐Ÿ“ธ Usage Effects After Configuration** +--- -#### **๐ŸŽญ Role Discovery and Activation** -![Role Discovery](assets/role-discovery.png) -*Step 1: Use `promptx_hello` to discover all available professional roles* - -![Role Selection](assets/role-select.png) -*Step 2: Use `promptx_action` to activate professional roles with complete capabilities* - -#### **๐Ÿ’ญ Intelligent Memory Management** -![Memory Feature](assets/remember.png) -*Step 3: Use `promptx_remember` to save important information for intelligent recall* - -> **โœจ Configuration Note**: After completing MCP configuration, your AI application will have all the above professional features. No additional learning required - just follow the interface prompts to enjoy professional AI services. - -## ๐Ÿ“‹ Practice Cases - -### ๐ŸŽฎ Legacy Lands Library +## ๐Ÿ“‹ **Practice Cases: Legacy Lands Library**
Legacy Lands Library Logo @@ -141,22 +173,27 @@ For custom configurations: **Official Website:** https://www.legacylands.cn/ **Organization Description:** Legacy Lands is an innovative team focused on building large-scale Minecraft civilization simulation experiences. They participate in the open-source community, providing elegant, efficient, and reliable solutions for Minecraft server plugin development and other domains. -#### ๐Ÿ’ก User Experience +> #### **๐Ÿ’ก Core Developer Experience** +> "The development experience with PromptX is truly different. Our team, using Claude Code combined with PromptX, had one developer complete over eleven thousand lines of high-quality Java code in just three days. +> +> The value of this workflow is fully demonstrated in actual development. PromptX solves many pain points in AI usage, consistently ensuring code style uniformity and quality standards, greatly reducing the learning curve for new team members. Best practices that previously required repeated communication and documentation inheritance can now naturally integrate into every code generation." -The development experience with PromptX is truly different. Our team, using Claude Code combined with PromptX, had one developer complete over eleven thousand lines of high-quality Java code in just three days. +#### **๐Ÿ“š Related Resources** -The value of this workflow is fully demonstrated in actual development. PromptX solves many pain points in AI usage, consistently ensuring code style uniformity and quality standards, greatly reducing the learning curve for new team members. Best practices that previously required repeated communication and documentation inheritance can now naturally integrate into every code generation. +- **AI Integration Standards and Practice Guide:** https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md -#### ๐Ÿ“š Related Resources +--- -**AI Integration Standards and Practice Guide:** https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md - -## โญ Star Growth Trend +## โญ **Star Growth Trend** [![Star History Chart](https://api.star-history.com/svg?repos=Deepractice/PromptX&type=Date)](https://star-history.com/#Deepractice/PromptX&Date) -### **Contributing Guidelines** -- ๐Ÿ“‹ **[Contributing Process](CONTRIBUTING.md)** - Detailed contribution guide and code standards +--- + +### **๐Ÿค Contributing and Communication** + +We welcome any form of contribution and feedback! + - ๐ŸŒฟ **[Branching Strategy](docs/BRANCHING.md)** - Branch management and release process - ๐Ÿš€ **[Release Process](docs/RELEASE.md)** - Version management and release documentation @@ -164,9 +201,11 @@ Join our technical community: Technical Community -## ๐Ÿ“„ License +--- -MIT License - Making AI professional capabilities accessible +## ๐Ÿ“„ **License** + +[MIT License](LICENSE) - Making AI professional capabilities accessible ---