prompt-plus 1.1.0 → 1.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 AI 技能包管理工具 - 基于技能包驱动的开发工作流
 
-> ⚠️ **v1.1.0 断档式更新**：不兼容旧版本，请重新安装
+> ⚠️ **v1.1.0+ 断档式更新**：不兼容 v1.0.x，请重新安装
 
 ## 安装
 
@@ -34,29 +34,32 @@ pp skill installed
 ### 仓库管理
 
 ```bash
-pp repo add <name> <url>     # 添加技能包仓库
+pp repo add <name> <url>          # 添加技能包仓库
 pp repo add <name> <url> -b <branch>  # 指定分支
-pp repo remove <name>        # 移除仓库
-pp repo list                 # 列出所有仓库
-pp repo sync                 # 同步所有仓库
-pp repo sync <name>          # 同步指定仓库
+pp repo remove <name>             # 移除仓库
+pp repo list                      # 列出所有仓库
+pp repo sync                      # 同步所有仓库
+pp repo sync <name>               # 同步指定仓库
 ```
 
 ### 技能包管理
 
 ```bash
-pp skill list                # 列出所有可用技能包
-pp skill list -r <repo>      # 列出指定仓库的技能包
-pp skill install             # 交互式安装技能包
-pp skill install <name>      # 安装指定技能包
-pp skill installed           # 查看已安装的技能包
+pp skill list                     # 列出所有可用技能包
+pp skill list -r <repo>           # 列出指定仓库的技能包
+pp skill install                  # 交互式安装技能包
+pp skill install <name>           # 安装指定技能包
+pp skill installed                # 查看已安装的技能包
+pp skill upgrade                  # 升级技能包（保留 context.md）
+pp skill upgrade <name>           # 升级指定技能包
+pp skill up                       # upgrade 简写
 ```
 
 ### 工作区管理
 
 ```bash
-pp workspace init            # 初始化 AI 工作区
-pp ws init                   # 简写
+pp workspace init                 # 初始化 AI 工作区
+pp ws init                        # 简写
 ```
 
 ---
@@ -79,8 +82,6 @@ your-repo/
     │       ├── init.md      # 初始化提示词
     │       └── dev.md       # 开发提示词
     ├── frontend_api/
-    │   ├── manifest.md
-    │   ├── context.md
     │   └── ...
     └── another_skill/
         └── ...
@@ -114,43 +115,6 @@ your-repo/
 - 约束 2
 ```
 
-### context.md 格式
-
-```markdown
-# Project Context Configuration
-
-> ⚠️ 此文件需要初始化
-
-## Tech Stack
-- **Framework**: <!-- 待填充 -->
-- **ORM**: <!-- 待填充 -->
-
-## Directory Mapping
-- **Controller Path**: <!-- 待填充 -->
-- **Service Path**: <!-- 待填充 -->
-
-## Code Style
-- **Naming Convention**: <!-- 待填充 -->
-```
-
-### tools/init.md 格式
-
-```markdown
-# 技能名 - 初始化提示词
-
-## 使用方法
-复制以下内容发送给 AI
-
----
-
-\`\`\`
-请执行 xxx 技能初始化：
-1. 扫描项目结构
-2. 识别技术栈
-3. 将结果写入 context.md
-\`\`\`
-```
-
 ---
 
 ## 安装后的项目结构
@@ -158,7 +122,7 @@ your-repo/
 ```
 your-project/
 ├── .ai-workspace/
-│   ├── RULES.md             # AI 工作流规则
+│   ├── RULES.md             # AI 工作流规则（自动生成）
 │   └── skills/
 │       ├── backend_api/
 │       │   ├── manifest.md
@@ -178,6 +142,29 @@ your-project/
 3. **AI 扫描项目**：AI 会分析项目并填充 `context.md`
 4. **开始开发**：将需求文档放入 `input/`，使用 `tools/dev.md` 的提示词
 
+## 技能包升级
+
+当仓库有更新时：
+
+```bash
+pp repo sync              # 同步仓库（不影响已安装的技能包）
+pp skill upgrade          # 升级技能包（保留 context.md、input/、output/）
+```
+
+## 工作流闭环
+
+backend_api 会输出前端对接文档，可直接用于 frontend_api：
+
+```
+backend_api 开发完成
+    ↓
+输出 output/api-spec-[模块].md
+    ↓
+复制到 frontend_api/input/
+    ↓
+frontend_api 生成前端代码
+```
+
 ## License
 
 MIT

package/dist/cli.js

@@ -88,7 +88,13 @@ program
     .addCommand(new commander_1.Command('installed')
     .description('查看已安装的技能包')
     .option('-o, --output <path>', '工作区路径', '.ai-workspace')
-    .action(commands_1.installedSkills));
+    .action(commands_1.installedSkills))
+    .addCommand(new commander_1.Command('upgrade')
+    .alias('up')
+    .description('升级技能包（保留 context.md、input/、output/）')
+    .argument('[skillName]', '技能包名称（不指定则交互式选择）')
+    .option('-o, --output <path>', '工作区路径', '.ai-workspace')
+    .action(commands_1.upgradeSkill));
 // 工作区管理
 program
     .command('workspace')

package/dist/commands.d.ts

@@ -17,3 +17,6 @@ export declare function initWorkspace(options?: {
 export declare function installedSkills(options?: {
     output?: string;
 }): Promise<void>;
+export declare function upgradeSkill(skillName?: string, options?: {
+    output?: string;
+}): Promise<void>;

package/dist/commands.js

@@ -41,6 +41,7 @@ exports.listSkills = listSkills;
 exports.installSkill = installSkill;
 exports.initWorkspace = initWorkspace;
 exports.installedSkills = installedSkills;
+exports.upgradeSkill = upgradeSkill;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
@@ -413,3 +414,114 @@ async function installedSkills(options) {
     }
     console.log(chalk.gray(`\n📁 位置: ${skillsDir}\n`));
 }
+// 辅助函数：将目录内容复制到内存
+function copyDirToMemory(dir) {
+    const files = new Map();
+    function readDir(currentDir, prefix = '') {
+        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                readDir(fullPath, relativePath);
+            }
+            else {
+                files.set(relativePath, fs.readFileSync(fullPath));
+            }
+        }
+    }
+    readDir(dir);
+    return files;
+}
+// 辅助函数：从内存恢复目录
+function restoreDirFromMemory(dir, files) {
+    for (const [relativePath, content] of files) {
+        const fullPath = path.join(dir, relativePath);
+        const dirPath = path.dirname(fullPath);
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+        fs.writeFileSync(fullPath, content);
+    }
+}
+// 升级技能包（保留 context.md、input/、output/）
+async function upgradeSkill(skillName, options) {
+    const chalk = await getChalk();
+    const inquirer = await getInquirer();
+    const baseDir = options?.output || '.ai-workspace';
+    const localSkillsDir = path.join(process.cwd(), baseDir, 'skills');
+    if (!fs.existsSync(localSkillsDir)) {
+        console.log(chalk.yellow('\n⚠️  未找到 AI 工作区'));
+        console.log(chalk.gray('使用 "pp workspace init" 初始化工作区\n'));
+        return;
+    }
+    const localSkills = (0, skills_1.loadSkillsFromDir)(localSkillsDir);
+    if (localSkills.length === 0) {
+        console.log(chalk.yellow('\n⚠️  未安装任何技能包\n'));
+        return;
+    }
+    // 获取仓库中的技能包
+    const repoSkills = await getAllSkillsWithRepo();
+    let skillsToUpgrade = [];
+    if (skillName) {
+        // 指定技能名
+        if (!localSkills.find((s) => s.name === skillName)) {
+            console.log(chalk.red(`\n❌ 未安装技能包: ${skillName}\n`));
+            return;
+        }
+        skillsToUpgrade = [skillName];
+    }
+    else {
+        // 交互式选择
+        const choices = localSkills.map((s) => ({
+            name: s.name,
+            value: s.name,
+            checked: true,
+        }));
+        const answer = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'skills',
+                message: '选择要升级的技能包:',
+                choices,
+            },
+        ]);
+        skillsToUpgrade = answer.skills;
+    }
+    if (skillsToUpgrade.length === 0) {
+        console.log(chalk.yellow('\n⚠️  未选择任何技能包\n'));
+        return;
+    }
+    console.log(chalk.cyan('\n🔄 开始升级技能包...\n'));
+    for (const name of skillsToUpgrade) {
+        const repoSkill = repoSkills.find((s) => s.name === name);
+        if (!repoSkill) {
+            console.log(chalk.yellow(`  ⚠️  ${name}: 仓库中未找到，跳过`));
+            continue;
+        }
+        const localDir = path.join(localSkillsDir, name);
+        // 备份需要保留的文件
+        const contextPath = path.join(localDir, 'context.md');
+        const inputDir = path.join(localDir, 'input');
+        const outputDir = path.join(localDir, 'output');
+        const contextBackup = fs.existsSync(contextPath) ? fs.readFileSync(contextPath, 'utf-8') : null;
+        const inputBackup = fs.existsSync(inputDir) ? copyDirToMemory(inputDir) : null;
+        const outputBackup = fs.existsSync(outputDir) ? copyDirToMemory(outputDir) : null;
+        // 删除旧技能包
+        fs.rmSync(localDir, { recursive: true, force: true });
+        // 复制新技能包
+        (0, skills_1.copySkill)(repoSkill.path, localDir);
+        // 恢复备份
+        if (contextBackup) {
+            fs.writeFileSync(contextPath, contextBackup, 'utf-8');
+        }
+        if (inputBackup) {
+            restoreDirFromMemory(inputDir, inputBackup);
+        }
+        if (outputBackup) {
+            restoreDirFromMemory(outputDir, outputBackup);
+        }
+        console.log(chalk.green(`  ✅ ${name}: 已升级（保留 context.md、input/、output/）`));
+    }
+    console.log(chalk.gray('\n升级完成！\n'));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prompt-plus",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "AI技能包管理工具 - 基于技能包驱动的 AI 开发工作流",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",