px2cc 2.1.2 → 2.2.0

package/README.md

@@ -8,6 +8,7 @@
 - 🎭 动态获取所有可用的系统角色和用户角色  
 - 🤖 支持安装为Claude Code Subagents (通过自然语言提及调用)
 - ⚙️ 支持安装为Claude Code Commands (通过 `/command` 调用)
+- 🏷️ 支持自定义Agent和Command的安装名字
 - 🎨 友好的交互式界面
 - 📁 自动创建和管理 `.claude` 目录结构
 
@@ -29,7 +30,8 @@ npx px2cc
 然后按照交互式提示：
 1. 选择要安装的PromptX角色
 2. 选择安装类型（Agent 或 Command）
-3. 确认安装
+3. 选择是否自定义安装名字（可选）
+4. 确认安装
 
 ## 安装类型
 
@@ -46,6 +48,24 @@ npx px2cc
 - **系统角色** 📦 - PromptX内置的专业角色
 - **用户角色** 👤 - 用户自定义创建的角色
 
+## 自定义命名
+
+从 v2.2.0 开始支持自定义安装名字功能：
+
+- **默认命名规则**：
+  - Agent: `角色名-agent` (如 `assistant-agent`)
+  - Command: `角色名` (如 `assistant`)
+
+- **自定义命名**：
+  - 可以自由指定Agent或Command的名字
+  - 支持字母、数字、下划线和连字符
+  - 避免与现有文件重名冲突
+
+- **使用场景**：
+  - 多版本管理：`assistant-v1`, `assistant-v2`
+  - 功能区分：`code-assistant`, `writing-assistant`
+  - 个人偏好：`my-helper`, `ai-buddy`
+
 ## 系统要求
 
 - Node.js >= 16.0.0
@@ -67,7 +87,9 @@ $ px2cc
 
 ? 请选择要安装的PromptX角色: assistant (系统角色)
 ? 安装 assistant 为: Agent - 通过提及"assistant-agent subagent"调用
-? 确认安装到Claude Code? Yes
+? 是否要自定义安装名字？ Yes
+? 请输入自定义Agent名字 (默认: assistant-agent): my-assistant
+? 确认安装 assistant 为 my-assistant 到Claude Code? Yes
 
 📖 加载 assistant 角色定义...
 🔧 生成 assistant agent文件...
@@ -75,11 +97,11 @@ $ px2cc
 ✅ 角色安装完成！
 
 📄 生成的文件:
-   - .claude/agents/assistant-agent.md
+   - .claude/agents/my-assistant.md
 
 🎉 现在你可以在Claude Code中使用:
-   Use the assistant-agent subagent to help with my task
-   Have the assistant-agent subagent review my code
+   Use the my-assistant subagent to help with my task
+   Have the my-assistant subagent review my code
 
 💡 提示: 重启Claude Code以确保新配置生效
 ```

package/cli.js

@@ -191,16 +191,54 @@ async function showRoleMenu(systemRoles, userRoles, availableServers) {
         }
       ]
     },
+    {
+      type: 'confirm',
+      name: 'customName',
+      message: '是否要自定义安装名字？',
+      default: false
+    }
+  ]);
+
+  let customName = '';
+  if (typeAnswer.customName) {
+    const nameAnswer = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: typeAnswer.installType === 'agents' 
+          ? `请输入自定义Agent名字 (默认: ${roleAnswer.selectedRole.role}-agent):`
+          : `请输入自定义Command名字 (默认: ${roleAnswer.selectedRole.role}):`,
+        default: typeAnswer.installType === 'agents' 
+          ? `${roleAnswer.selectedRole.role}-agent` 
+          : roleAnswer.selectedRole.role,
+        validate: (input) => {
+          if (!input.trim()) {
+            return '名字不能为空';
+          }
+          // 检查名字格式
+          if (!/^[a-zA-Z0-9_-]+$/.test(input.trim())) {
+            return '名字只能包含字母、数字、下划线和连字符';
+          }
+          return true;
+        }
+      }
+    ]);
+    customName = nameAnswer.name.trim();
+  }
+
+  const confirmAnswer = await inquirer.prompt([
     {
       type: 'confirm',
       name: 'confirm',
-      message: '确认安装到Claude Code?',
+      message: customName 
+        ? `确认安装 ${roleAnswer.selectedRole.role} 为 ${chalk.yellow(customName)} 到Claude Code?`
+        : '确认安装到Claude Code?',
       default: true
     }
   ]);
 
   let selectedTools = [];
-  if (typeAnswer.confirm) {
+  if (confirmAnswer.confirm) {
     // 选择MCP服务器和工具
     selectedTools = await selectMCPServers(roleAnswer.selectedRole.role, availableServers);
   }
@@ -208,7 +246,8 @@ async function showRoleMenu(systemRoles, userRoles, availableServers) {
   return {
     selectedRole: roleAnswer.selectedRole,
     installType: typeAnswer.installType,
-    confirm: typeAnswer.confirm,
+    confirm: confirmAnswer.confirm,
+    customName: customName,
     selectedTools: selectedTools
   };
 }
@@ -229,7 +268,7 @@ function checkDirectory() {
 }
 
 // 安装角色
-async function installRole(selectedRole, installType, claudeDir, manager, selectedTools) {
+async function installRole(selectedRole, installType, claudeDir, selectedTools, customName = '') {
   const roleName = selectedRole.role;
   const results = {};
   
@@ -240,10 +279,12 @@ async function installRole(selectedRole, installType, claudeDir, manager, select
     const processedContent = await processor.processRole(roleName, mode);
     
     // 根据安装模式创建相应文件
+    const finalName = customName || (installType === 'agents' ? `${roleName}-agent` : roleName);
+    
     if (installType === 'agents') {
-      console.log(chalk.cyan(`🔧 生成 ${roleName} subagent文件...`));
+      console.log(chalk.cyan(`🔧 生成 ${finalName} subagent文件...`));
       const agentConfig = {
-        name: `${roleName}-agent`,
+        name: finalName,
         description: `基于PromptX ${roleName}角色的专业AI助手 - 完整action实现`,
         content: processedContent,
         targetDir: claudeDir
@@ -260,15 +301,15 @@ async function installRole(selectedRole, installType, claudeDir, manager, select
       if (!subagentResult.success) {
         throw new Error(`创建Subagent失败: ${subagentResult.error}`);
       }
-      results.agentFile = `${roleName}-agent.md`;
-      results.usage = `Use the ${roleName}-agent subagent to [任务描述]`;
+      results.agentFile = `${finalName}.md`;
+      results.usage = `Use the ${finalName} subagent to [任务描述]`;
     }
 
     if (installType === 'commands') {
-      console.log(chalk.cyan(`📋 生成 ${roleName} command文件...`));
+      console.log(chalk.cyan(`📋 生成 ${finalName} command文件...`));
       
       const commandConfig = {
-        name: roleName,
+        name: finalName,
         description: `基于PromptX ${roleName}角色的专业助手 - 完整action实现`,
         content: processedContent,
         targetDir: claudeDir
@@ -285,8 +326,8 @@ async function installRole(selectedRole, installType, claudeDir, manager, select
       if (!commandResult.success) {
         throw new Error(`创建Command失败: ${commandResult.error}`);
       }
-      results.commandFile = `${roleName}.md`;
-      results.usage = `/${roleName}`;
+      results.commandFile = `${finalName}.md`;
+      results.usage = `/${finalName}`;
     }
 
     results.roleName = roleName;
@@ -348,7 +389,7 @@ export async function main() {
     console.log(chalk.blue(`\n🎭 开始安装角色: ${selectedRole.role} (${installType})`));
     
     // 安装角色
-    const result = await installRole(selectedRole, installType, claudeDir, manager, selectedTools);
+    const result = await installRole(selectedRole, installType, claudeDir, selectedTools, selections.customName);
     
     console.log(chalk.green.bold('\n✅ 角色安装完成！'));
     console.log(`\n📄 生成的文件:`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "px2cc",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "CLI tool that implements complete PromptX Action flow in Claude Code - role activation, dependency loading, cognition networks & memory systems",
   "main": "cli.js",
   "type": "module",