prompt-plus 1.1.0 → 1.1.2

package/README.md

@@ -2,7 +2,7 @@
 
 AI 技能包管理工具 - 基于技能包驱动的开发工作流
 
-> ⚠️ **v1.1.0 断档式更新**：不兼容旧版本，请重新安装
+> ⚠️ **v1.1.0+ 断档式更新**：不兼容 v1.0.x，请重新安装
 
 ## 安装
 
@@ -14,7 +14,7 @@ npm install -g prompt-plus
 
 ```bash
 # 1. 添加技能包仓库
-pp repo add official https://github.com/your-repo/skills.git
+pp repo add official https://github.com/LeeSeaside/prompt-plus-templates.git
 
 # 2. 同步仓库
 pp repo sync
@@ -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                        # 简写
 ```
 
 ---
@@ -66,7 +69,7 @@ pp ws init                   # 简写
 如果你想创建自己的技能包仓库，请按以下格式组织：
 
 ```
-your-repo/
+prompt-plus-templates/
 └── skills/
     ├── backend_api/
     │   ├── manifest.md      # 执行流程和规范（必需）
@@ -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,14 @@ 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）')
+    .argument('[skillName]', '技能包名称（不指定则交互式选择）')
+    .option('-o, --output <path>', '工作区路径', '.ai-workspace')
+    .option('-m, --mode <mode>', 'context.md 处理策略: merge(智能合并) | keep(保留本地) | overwrite(使用仓库)')
+    .action(commands_1.upgradeSkill));
 // 工作区管理
 program
     .command('workspace')

package/dist/commands.d.ts

@@ -17,3 +17,7 @@ export declare function initWorkspace(options?: {
 export declare function installedSkills(options?: {
     output?: string;
 }): Promise<void>;
+export declare function upgradeSkill(skillName?: string, options?: {
+    output?: string;
+    mode?: 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");
@@ -116,7 +117,7 @@ async function listRepos() {
     console.log(chalk.cyan('\n📦 技能包仓库列表:\n'));
     if (config.repos.length === 0) {
         console.log(chalk.gray('  暂无仓库，请先添加:'));
-        console.log(chalk.gray('  pp repo add official https://github.com/your-repo/skills.git\n'));
+        console.log(chalk.gray('  pp repo add official https://github.com/LeeSeaside/prompt-plus-templates.git\n'));
         return;
     }
     for (const repo of config.repos) {
@@ -413,3 +414,178 @@ 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：保留用户填充的值，更新模板结构
+function mergeContextMd(localContent, repoContent) {
+    // 提取本地已填充的值（非注释、非占位符的内容）
+    const userValues = new Map();
+    // 匹配 "- **Key**: Value" 或 "- Key: Value" 格式
+    const valuePattern = /^[-*]\s*\*?\*?([^:*]+)\*?\*?:\s*(.+)$/gm;
+    let match;
+    while ((match = valuePattern.exec(localContent)) !== null) {
+        const key = match[1].trim();
+        const value = match[2].trim();
+        // 跳过占位符和注释
+        if (value && !value.startsWith('<!--') && !value.includes('待填充') && !value.includes('⚠️')) {
+            userValues.set(key.toLowerCase(), value);
+        }
+    }
+    // 在新模板中填充用户值
+    let merged = repoContent;
+    for (const [key, value] of userValues) {
+        // 替换占位符
+        const placeholderPattern = new RegExp(`([-*]\\s*\\*?\\*?${key}\\*?\\*?:\\s*)<!--[^>]*-->`, 'gi');
+        merged = merged.replace(placeholderPattern, `$1${value}`);
+    }
+    return merged;
+}
+// 升级技能包
+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;
+    }
+    // 选择 context.md 处理策略
+    let contextMode = options?.mode;
+    if (!contextMode) {
+        const modeAnswer = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'mode',
+                message: 'context.md 处理策略:',
+                choices: [
+                    { name: '智能合并 - 保留用户数据，更新模板结构（推荐）', value: 'merge' },
+                    { name: '保留本地 - 完全保留本地 context.md', value: 'keep' },
+                    { name: '使用仓库 - 使用仓库最新版本（会丢失已填充数据）', value: 'overwrite' },
+                ],
+                default: 'merge',
+            },
+        ]);
+        contextMode = modeAnswer.mode;
+    }
+    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 localContext = 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);
+        // 处理 context.md
+        const repoContextPath = path.join(repoSkill.path, 'context.md');
+        const repoContext = fs.existsSync(repoContextPath) ? fs.readFileSync(repoContextPath, 'utf-8') : null;
+        if (localContext && repoContext) {
+            let finalContext;
+            switch (contextMode) {
+                case 'keep':
+                    finalContext = localContext;
+                    break;
+                case 'overwrite':
+                    finalContext = repoContext;
+                    break;
+                case 'merge':
+                default:
+                    finalContext = mergeContextMd(localContext, repoContext);
+                    break;
+            }
+            fs.writeFileSync(contextPath, finalContext, 'utf-8');
+        }
+        else if (localContext) {
+            fs.writeFileSync(contextPath, localContext, 'utf-8');
+        }
+        // 恢复 input 和 output
+        if (inputBackup) {
+            restoreDirFromMemory(inputDir, inputBackup);
+        }
+        if (outputBackup) {
+            restoreDirFromMemory(outputDir, outputBackup);
+        }
+        const modeLabel = contextMode === 'merge' ? '智能合并' : contextMode === 'keep' ? '保留本地' : '使用仓库';
+        console.log(chalk.green(`  ✅ ${name}: 已升级（context.md: ${modeLabel}）`));
+    }
+    console.log(chalk.gray('\n升级完成！\n'));
+    if (contextMode === 'merge') {
+        console.log(chalk.cyan('💡 提示: 智能合并已尝试保留您的配置数据。'));
+        console.log(chalk.gray('   如果仓库新增了配置项，请检查 context.md 并补充填写。\n'));
+    }
+}

package/package.json

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