prompt-plus 1.0.5 → 1.1.1

package/README.md

@@ -1,6 +1,8 @@
 # prompt-plus
 
-AI 提示词模板管理工具 - 生成符合项目规范的提示词
+AI 技能包管理工具 - 基于技能包驱动的开发工作流
+
+> ⚠️ **v1.1.0+ 断档式更新**：不兼容 v1.0.x，请重新安装
 
 ## 安装
 
@@ -11,106 +13,156 @@ npm install -g prompt-plus
 ## 快速开始
 
 ```bash
-# 1. 添加官方模板仓库
-prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git
+# 1. 添加技能包仓库
+pp repo add official https://github.com/your-repo/skills.git
+
+# 2. 同步仓库
+pp repo sync
 
-# 2. 同步模板
-prompt-plus repo sync
+# 3. 查看可用技能包
+pp skill list
 
-# 3. 查看可用模板
-prompt-plus list
+# 4. 安装技能包到当前项目
+pp skill install backend_api
 
-# 4. 使用模板
-prompt-plus use backend-api
+# 5. 查看已安装的技能包
+pp skill installed
 ```
 
-## 命令
+## 命令列表
 
-### 模板操作
+### 仓库管理
 
 ```bash
-# 列出所有模板
-prompt-plus list
-prompt-plus ls
-
-# 使用模板（交互式选择）
-prompt-plus use
+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>               # 同步指定仓库
+```
 
-# 使用指定模板
-prompt-plus use <模板名>
+### 技能包管理
 
-# 指定输出目录
-prompt-plus use <模板名> -o ./my-prompts
+```bash
+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
-# 查看仓库列表
-prompt-plus repo ls
+pp workspace init                 # 初始化 AI 工作区
+pp ws init                        # 简写
+```
 
-# 添加仓库
-prompt-plus repo add <名称> <Git地址>
-prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git
+---
 
-# 添加私有仓库（指定分支）
-prompt-plus repo add company git@github.com:company/prompts.git -b develop
+## 技能包仓库格式
 
-# 同步仓库
-prompt-plus repo sync          # 同步所有
-prompt-plus repo sync official # 同步指定仓库
+如果你想创建自己的技能包仓库，请按以下格式组织：
 
-# 移除仓库
-prompt-plus repo rm <名称>
+```
+your-repo/
+└── skills/
+    ├── backend_api/
+    │   ├── manifest.md      # 执行流程和规范（必需）
+    │   ├── context.md       # 项目配置模板（必需）
+    │   ├── input/           # 输入文档目录
+    │   │   └── .gitkeep
+    │   ├── output/          # 输出文档目录
+    │   │   └── .gitkeep
+    │   └── tools/           # 提示词工具
+    │       ├── init.md      # 初始化提示词
+    │       └── dev.md       # 开发提示词
+    ├── frontend_api/
+    │   └── ...
+    └── another_skill/
+        └── ...
 ```
 
-## 自建模板仓库
+### manifest.md 格式
 
-创建 Git 仓库，在 `templates/` 目录下放置 Markdown 模板文件：
+```markdown
+# Skill Manifest: 技能名称
 
-```
-my-templates/
-└── templates/
-    ├── my-template-1.md
-    └── my-template-2.md
-```
+## 技能描述
+简要说明这个技能包的用途。
 
-模板格式（Markdown + Front Matter）：
+## 执行协议
+定义 AI 执行任务的步骤流程。
 
-```markdown
----
-name: my-template
-description: 模板描述
-category: backend
-outputFileName: my-template-prompt.md
----
+### 1. Context Check (上下文检查)
+...
 
-# 模板标题
+### 2. Input Acquisition (获取需求)
+...
 
-## 任务
-模板内容...
-```
+### 3. Code Generation (代码生成)
+...
 
-## 工作流程
+### 4. Documentation Output (文档输出)
+...
 
+## 约束条件
+- 约束 1
+- 约束 2
 ```
-模板 → 正式提示词 → 对接文档/代码
 
-.prompts/
-├── templates/     # 提示词模板
-└── generated/     # 正式提示词（AI 生成）
+---
 
-docs/
-└── api/           # 对接文档（业务相关）
+## 安装后的项目结构
+
+```
+your-project/
+├── .ai-workspace/
+│   ├── RULES.md             # AI 工作流规则（自动生成）
+│   └── skills/
+│       ├── backend_api/
+│       │   ├── manifest.md
+│       │   ├── context.md   # 需要初始化
+│       │   ├── input/
+│       │   ├── output/
+│       │   └── tools/
+│       └── frontend_api/
+│           └── ...
+└── (你的项目源码)
 ```
 
-## 本地开发
+## 使用流程
+
+1. **安装技能包**：`pp skill install backend_api`
+2. **初始化配置**：查看 `tools/init.md`，复制提示词发送给 AI
+3. **AI 扫描项目**：AI 会分析项目并填充 `context.md`
+4. **开始开发**：将需求文档放入 `input/`，使用 `tools/dev.md` 的提示词
+
+## 技能包升级
+
+当仓库有更新时：
 
 ```bash
-npm install
-npm run build
-npm link
-prompt-plus list
+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

package/dist/cli.js

@@ -44,44 +44,64 @@ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
 const program = new commander_1.Command();
 program
     .name('prompt-plus')
-    .description('AI提示词模板管理工具 - 生成符合项目规范的提示词')
+    .description('AI 技能包管理工具 - 基于技能包驱动的开发工作流')
     .version(pkg.version);
-program
-    .command('list')
-    .alias('ls')
-    .description('列出所有可用的提示词模板')
-    .option('-r, --repo <name>', '指定仓库名称')
-    .action(commands_1.listTemplates);
-program
-    .command('use [templateName]')
-    .description('选择并使用模板生成提示词')
-    .option('-o, --output <path>', '输出路径', '.prompts')
-    .option('-r, --repo <name>', '指定仓库名称')
-    .action(commands_1.useTemplate);
-program
-    .command('init')
-    .description('初始化配置文件')
-    .action(commands_1.initConfig);
+// 仓库管理
 program
     .command('repo')
-    .description('管理模板仓库')
+    .description('管理技能包仓库')
     .addCommand(new commander_1.Command('add')
-    .description('添加模板仓库')
+    .description('添加技能包仓库')
     .argument('<name>', '仓库名称')
     .argument('<url>', '仓库地址')
     .option('-b, --branch <branch>', '分支名称', 'main')
     .action(commands_1.addRepo))
     .addCommand(new commander_1.Command('remove')
     .alias('rm')
-    .description('移除模板仓库')
+    .description('移除仓库')
     .argument('<name>', '仓库名称')
     .action(commands_1.removeRepo))
     .addCommand(new commander_1.Command('list')
     .alias('ls')
-    .description('列出所有模板仓库')
+    .description('列出所有仓库')
     .action(commands_1.listRepos))
     .addCommand(new commander_1.Command('sync')
-    .description('同步模板仓库')
+    .description('同步仓库')
     .argument('[name]', '仓库名称（不指定则同步所有）')
     .action(commands_1.syncRepo));
+// 技能包管理
+program
+    .command('skill')
+    .description('管理技能包')
+    .addCommand(new commander_1.Command('list')
+    .alias('ls')
+    .description('列出所有可用技能包')
+    .option('-r, --repo <name>', '指定仓库名称')
+    .action(commands_1.listSkills))
+    .addCommand(new commander_1.Command('install')
+    .alias('i')
+    .description('安装技能包到当前项目')
+    .argument('[skillName]', '技能包名称')
+    .option('-r, --repo <name>', '指定仓库名称')
+    .option('-o, --output <path>', '输出路径', '.ai-workspace')
+    .action(commands_1.installSkill))
+    .addCommand(new commander_1.Command('installed')
+    .description('查看已安装的技能包')
+    .option('-o, --output <path>', '工作区路径', '.ai-workspace')
+    .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')
+    .alias('ws')
+    .description('管理 AI 工作区')
+    .addCommand(new commander_1.Command('init')
+    .description('初始化 AI 工作区')
+    .option('-o, --output <path>', '输出路径', '.ai-workspace')
+    .action(commands_1.initWorkspace));
 program.parse();

package/dist/commands.d.ts

@@ -1,14 +1,22 @@
-export declare function listTemplates(options?: {
-    repo?: string;
-}): Promise<void>;
-export declare function useTemplate(templateName?: string, options?: {
-    output?: string;
-    repo?: string;
-}): Promise<void>;
-export declare function initConfig(): Promise<void>;
 export declare function addRepo(name: string, url: string, options?: {
     branch?: string;
 }): Promise<void>;
 export declare function removeRepo(name: string): Promise<void>;
 export declare function listRepos(): Promise<void>;
 export declare function syncRepo(name?: string): Promise<void>;
+export declare function listSkills(options?: {
+    repo?: string;
+}): Promise<void>;
+export declare function installSkill(skillName?: string, options?: {
+    repo?: string;
+    output?: string;
+}): Promise<void>;
+export declare function initWorkspace(options?: {
+    output?: string;
+}): Promise<void>;
+export declare function installedSkills(options?: {
+    output?: string;
+}): Promise<void>;
+export declare function upgradeSkill(skillName?: string, options?: {
+    output?: string;
+}): Promise<void>;

package/dist/commands.js

@@ -33,17 +33,19 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTemplates = listTemplates;
-exports.useTemplate = useTemplate;
-exports.initConfig = initConfig;
 exports.addRepo = addRepo;
 exports.removeRepo = removeRepo;
 exports.listRepos = listRepos;
 exports.syncRepo = syncRepo;
+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");
-const templates_1 = require("./templates");
+const skills_1 = require("./skills");
 // 配置文件路径（全局配置）
 const getGlobalConfigDir = () => path.join(process.env.HOME || process.env.USERPROFILE || '', '.prompt-plus');
 const getGlobalConfigPath = () => path.join(getGlobalConfigDir(), 'config.json');
@@ -64,7 +66,7 @@ function getConfig() {
     return {
         defaultRepo: '',
         repos: [],
-        outputDir: '.prompts',
+        outputDir: '.ai-workspace',
     };
 }
 // 保存全局配置
@@ -75,140 +77,7 @@ function saveConfig(config) {
     }
     fs.writeFileSync(getGlobalConfigPath(), JSON.stringify(config, null, 2), 'utf-8');
 }
-// 获取所有模板（按仓库分组）
-async function getAllTemplatesWithRepo(repoName) {
-    const config = getConfig();
-    const templates = [];
-    // 指定了具体仓库
-    if (repoName) {
-        const repo = config.repos.find((r) => r.name === repoName);
-        if (repo) {
-            const repoDir = path.join(getReposDir(), repo.name);
-            if (fs.existsSync(repoDir)) {
-                const repoTemplates = (0, templates_1.loadTemplatesFromDir)(path.join(repoDir, 'templates'));
-                return repoTemplates.map((t) => ({ ...t, repoName: repo.name }));
-            }
-        }
-        return [];
-    }
-    // 未指定仓库：合并所有已同步仓库模板
-    for (const repo of config.repos) {
-        const repoDir = path.join(getReposDir(), repo.name);
-        if (fs.existsSync(repoDir)) {
-            const repoTemplates = (0, templates_1.loadTemplatesFromDir)(path.join(repoDir, 'templates'));
-            templates.push(...repoTemplates.map((t) => ({ ...t, repoName: repo.name })));
-        }
-    }
-    return templates;
-}
-async function listTemplates(options) {
-    const chalk = await getChalk();
-    const templates = await getAllTemplatesWithRepo(options?.repo);
-    if (templates.length === 0) {
-        console.log(chalk.yellow('\n⚠️  没有找到模板'));
-        console.log(chalk.gray('请先添加并同步模板仓库:'));
-        console.log(chalk.gray('  prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git'));
-        console.log(chalk.gray('  prompt-plus repo sync\n'));
-        return;
-    }
-    console.log(chalk.cyan('\n📋 可用的提示词模板:\n'));
-    // 按仓库分组
-    const repoNames = [...new Set(templates.map((t) => t.repoName))];
-    for (const repoName of repoNames) {
-        console.log(chalk.magenta(`📦 ${repoName}`));
-        const repoTemplates = templates.filter((t) => t.repoName === repoName);
-        // 按分类分组
-        const categories = [...new Set(repoTemplates.map((t) => t.category))];
-        for (const category of categories) {
-            console.log(chalk.yellow(`  [${category}]`));
-            const categoryTemplates = repoTemplates.filter((t) => t.category === category);
-            for (const template of categoryTemplates) {
-                console.log(chalk.white(`    • ${template.name}`), chalk.gray(`- ${template.description}`));
-            }
-        }
-        console.log();
-    }
-    console.log(chalk.gray('使用 "prompt-plus use <模板名>" 或 "prompt-plus use" 交互式选择\n'));
-}
-async function useTemplate(templateName, options) {
-    const chalk = await getChalk();
-    const inquirer = await getInquirer();
-    const templates = await getAllTemplatesWithRepo(options?.repo);
-    let selectedTemplate;
-    if (templateName) {
-        selectedTemplate = templates.find((t) => t.name === templateName);
-        if (!selectedTemplate) {
-            console.log(chalk.red(`\n❌ 未找到模板: ${templateName}`));
-            console.log(chalk.gray('使用 "prompt-plus list" 查看可用模板\n'));
-            return;
-        }
-    }
-    else {
-        if (templates.length === 0) {
-            console.log(chalk.yellow('\n⚠️  没有可用模板'));
-            console.log(chalk.gray('请先添加并同步模板仓库\n'));
-            return;
-        }
-        const choices = templates.map((t) => ({
-            name: `[${t.repoName}] ${t.name} - ${t.description}`,
-            value: t.name,
-        }));
-        const answer = await inquirer.prompt([
-            {
-                type: 'list',
-                name: 'template',
-                message: '请选择要使用的模板:',
-                choices,
-            },
-        ]);
-        selectedTemplate = templates.find((t) => t.name === answer.template);
-    }
-    if (!selectedTemplate) {
-        console.log(chalk.red('\n❌ 模板选择失败'));
-        return;
-    }
-    const baseDir = options?.output || '.prompts';
-    const templatesDir = path.join(process.cwd(), baseDir, 'templates');
-    const generatedDir = path.join(process.cwd(), baseDir, 'generated');
-    if (!fs.existsSync(templatesDir)) {
-        fs.mkdirSync(templatesDir, { recursive: true });
-    }
-    if (!fs.existsSync(generatedDir)) {
-        fs.mkdirSync(generatedDir, { recursive: true });
-    }
-    const filePath = path.join(templatesDir, selectedTemplate.outputFileName);
-    fs.writeFileSync(filePath, selectedTemplate.content, 'utf-8');
-    console.log(chalk.green(`\n✅ 模板已生成: ${filePath}`));
-    console.log(chalk.cyan('\n📝 使用方法:'));
-    console.log(chalk.white('  1. 打开生成的提示词文件'));
-    console.log(chalk.white('  2. 复制内容到AI编辑器（Cursor/Trae等）'));
-    console.log(chalk.white('  3. AI会分析你的项目并生成具体的开发提示词'));
-    console.log(chalk.white(`  4. 将AI生成的正式提示词保存到: ${chalk.yellow(baseDir + '/generated/')}`));
-    console.log(chalk.white('  5. 使用正式提示词进行实际开发\n'));
-    console.log(chalk.gray(`📁 目录结构:`));
-    console.log(chalk.gray(`   ${baseDir}/`));
-    console.log(chalk.gray(`   ├── templates/     # 提示词模板`));
-    console.log(chalk.gray(`   └── generated/     # 正式提示词\n`));
-}
-async function initConfig() {
-    const chalk = await getChalk();
-    const configPath = getGlobalConfigPath();
-    if (fs.existsSync(configPath)) {
-        console.log(chalk.yellow('\n⚠️  配置文件已存在'));
-        console.log(chalk.gray(`路径: ${configPath}\n`));
-        return;
-    }
-    const defaultConfig = {
-        defaultRepo: '',
-        repos: [],
-        outputDir: '.prompts',
-    };
-    saveConfig(defaultConfig);
-    console.log(chalk.green('\n✅ 配置文件已创建'));
-    console.log(chalk.gray(`路径: ${configPath}`));
-    console.log(chalk.gray('\n下一步: 添加模板仓库'));
-    console.log(chalk.gray('  prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git\n'));
-}
+// ==================== 仓库管理 ====================
 async function addRepo(name, url, options) {
     const chalk = await getChalk();
     const config = getConfig();
@@ -223,7 +92,7 @@ async function addRepo(name, url, options) {
     });
     saveConfig(config);
     console.log(chalk.green(`\n✅ 已添加仓库: ${name}`));
-    console.log(chalk.gray(`使用 "prompt-plus repo sync ${name}" 同步模板\n`));
+    console.log(chalk.gray(`使用 "pp repo sync ${name}" 同步仓库\n`));
 }
 async function removeRepo(name) {
     const chalk = await getChalk();
@@ -245,19 +114,28 @@ async function removeRepo(name) {
 async function listRepos() {
     const chalk = await getChalk();
     const config = getConfig();
-    console.log(chalk.cyan('\n📦 模板仓库列表:\n'));
+    console.log(chalk.cyan('\n📦 技能包仓库列表:\n'));
     if (config.repos.length === 0) {
         console.log(chalk.gray('  暂无仓库，请先添加:'));
-        console.log(chalk.gray('  prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git\n'));
+        console.log(chalk.gray('  pp repo add official https://github.com/your-repo/skills.git\n'));
         return;
     }
     for (const repo of config.repos) {
-        const synced = fs.existsSync(path.join(getReposDir(), repo.name));
+        const repoDir = path.join(getReposDir(), repo.name);
+        const synced = fs.existsSync(repoDir);
         const status = synced ? chalk.green('✓ 已同步') : chalk.yellow('未同步');
-        console.log(chalk.white(`  • ${repo.name}`), chalk.gray(`- ${repo.url}`), status);
+        // 检查技能包数量
+        let skillCount = 0;
+        if (synced) {
+            const skillsDir = path.join(repoDir, 'skills');
+            if (fs.existsSync(skillsDir)) {
+                skillCount = (0, skills_1.loadSkillsFromDir)(skillsDir).length;
+            }
+        }
+        console.log(chalk.white(`  • ${repo.name}`), chalk.gray(`- ${repo.url}`), status, synced ? chalk.gray(`(${skillCount} 个技能包)`) : '');
     }
-    console.log(chalk.gray('\n使用 "prompt-plus repo add <name> <url>" 添加仓库'));
-    console.log(chalk.gray('使用 "prompt-plus repo sync [name]" 同步仓库\n'));
+    console.log(chalk.gray('\n使用 "pp repo add <name> <url>" 添加仓库'));
+    console.log(chalk.gray('使用 "pp repo sync [name]" 同步仓库\n'));
 }
 async function syncRepo(name) {
     const chalk = await getChalk();
@@ -273,7 +151,7 @@ async function syncRepo(name) {
         }
         else {
             console.log(chalk.yellow('\n⚠️  没有配置任何仓库'));
-            console.log(chalk.gray('使用 "prompt-plus repo add <name> <url>" 添加仓库\n'));
+            console.log(chalk.gray('使用 "pp repo add <name> <url>" 添加仓库\n'));
         }
         return;
     }
@@ -289,6 +167,12 @@ async function syncRepo(name) {
                 (0, child_process_1.execSync)(`git clone -b ${repo.branch || 'main'} "${repo.url}" "${repoDir}"`, { stdio: 'pipe' });
                 console.log(chalk.green(`✅ 已克隆: ${repo.name}`));
             }
+            // 显示技能包数量
+            const skillsDir = path.join(repoDir, 'skills');
+            if (fs.existsSync(skillsDir)) {
+                const skills = (0, skills_1.loadSkillsFromDir)(skillsDir);
+                console.log(chalk.gray(`   发现 ${skills.length} 个技能包`));
+            }
         }
         catch (error) {
             console.log(chalk.red(`❌ 同步失败: ${repo.name}`));
@@ -297,3 +181,347 @@ async function syncRepo(name) {
     }
     console.log();
 }
+// 获取所有技能包（按仓库分组）
+async function getAllSkillsWithRepo(repoName) {
+    const config = getConfig();
+    const skills = [];
+    if (repoName) {
+        const repo = config.repos.find((r) => r.name === repoName);
+        if (repo) {
+            const repoDir = path.join(getReposDir(), repo.name);
+            if (fs.existsSync(repoDir)) {
+                const repoSkills = (0, skills_1.loadSkillsFromDir)(path.join(repoDir, 'skills'));
+                return repoSkills.map((s) => ({ ...s, repoName: repo.name }));
+            }
+        }
+        return [];
+    }
+    for (const repo of config.repos) {
+        const repoDir = path.join(getReposDir(), repo.name);
+        if (fs.existsSync(repoDir)) {
+            const repoSkills = (0, skills_1.loadSkillsFromDir)(path.join(repoDir, 'skills'));
+            skills.push(...repoSkills.map((s) => ({ ...s, repoName: repo.name })));
+        }
+    }
+    return skills;
+}
+// 列出所有技能包
+async function listSkills(options) {
+    const chalk = await getChalk();
+    const skills = await getAllSkillsWithRepo(options?.repo);
+    if (skills.length === 0) {
+        console.log(chalk.yellow('\n⚠️  没有找到技能包'));
+        console.log(chalk.gray('请先添加并同步仓库:'));
+        console.log(chalk.gray('  pp repo add official <仓库地址>'));
+        console.log(chalk.gray('  pp repo sync\n'));
+        return;
+    }
+    console.log(chalk.cyan('\n🎯 可用的技能包:\n'));
+    const repoNames = [...new Set(skills.map((s) => s.repoName))];
+    for (const repoName of repoNames) {
+        console.log(chalk.magenta(`📦 ${repoName}`));
+        const repoSkills = skills.filter((s) => s.repoName === repoName);
+        for (const skill of repoSkills) {
+            const status = [];
+            if (skill.hasManifest)
+                status.push(chalk.green('✓manifest'));
+            if (skill.hasContext)
+                status.push(chalk.green('✓context'));
+            if (skill.hasTools)
+                status.push(chalk.green('✓tools'));
+            console.log(chalk.white(`  • ${skill.name}`), chalk.gray(`- ${skill.description || '无描述'}`), chalk.gray(`[${status.join(' ')}]`));
+        }
+        console.log();
+    }
+    console.log(chalk.gray('使用 "pp skill install <技能名>" 安装技能包到当前项目\n'));
+}
+// 安装技能包到当前项目
+async function installSkill(skillName, options) {
+    const chalk = await getChalk();
+    const inquirer = await getInquirer();
+    const skills = await getAllSkillsWithRepo(options?.repo);
+    let selectedSkill;
+    if (skillName) {
+        selectedSkill = skills.find((s) => s.name === skillName);
+        if (!selectedSkill) {
+            console.log(chalk.red(`\n❌ 未找到技能包: ${skillName}`));
+            console.log(chalk.gray('使用 "pp skill list" 查看可用技能包\n'));
+            return;
+        }
+    }
+    else {
+        if (skills.length === 0) {
+            console.log(chalk.yellow('\n⚠️  没有可用技能包'));
+            console.log(chalk.gray('请先添加并同步仓库\n'));
+            return;
+        }
+        const choices = skills.map((s) => ({
+            name: `[${s.repoName}] ${s.name} - ${s.description || '无描述'}`,
+            value: s.name,
+        }));
+        const answer = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'skill',
+                message: '请选择要安装的技能包:',
+                choices,
+            },
+        ]);
+        selectedSkill = skills.find((s) => s.name === answer.skill);
+    }
+    if (!selectedSkill) {
+        console.log(chalk.red('\n❌ 技能包选择失败'));
+        return;
+    }
+    const baseDir = options?.output || '.ai-workspace';
+    const targetDir = path.join(process.cwd(), baseDir, 'skills', selectedSkill.name);
+    // 检查是否已安装
+    if (fs.existsSync(targetDir)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: `技能包 "${selectedSkill.name}" 已存在，是否覆盖？`,
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.yellow('\n⚠️  已取消安装\n'));
+            return;
+        }
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    }
+    // 复制技能包
+    (0, skills_1.copySkill)(selectedSkill.path, targetDir);
+    // 确保 RULES.md 存在
+    const rulesPath = path.join(process.cwd(), baseDir, 'RULES.md');
+    if (!fs.existsSync(rulesPath)) {
+        await initWorkspace({ output: baseDir });
+    }
+    console.log(chalk.green(`\n✅ 技能包已安装: ${targetDir}`));
+    console.log(chalk.cyan('\n📝 下一步:'));
+    console.log(chalk.white(`  1. 查看 ${baseDir}/skills/${selectedSkill.name}/tools/init.md`));
+    console.log(chalk.white('  2. 复制初始化提示词发送给 AI'));
+    console.log(chalk.white('  3. AI 会扫描项目并填充 context.md\n'));
+}
+// 初始化 AI 工作区
+async function initWorkspace(options) {
+    const chalk = await getChalk();
+    const baseDir = options?.output || '.ai-workspace';
+    const workspaceDir = path.join(process.cwd(), baseDir);
+    const rulesPath = path.join(workspaceDir, 'RULES.md');
+    if (fs.existsSync(rulesPath)) {
+        console.log(chalk.yellow('\n⚠️  AI 工作区已存在'));
+        console.log(chalk.gray(`路径: ${workspaceDir}\n`));
+        return;
+    }
+    // 创建目录结构
+    fs.mkdirSync(path.join(workspaceDir, 'skills'), { recursive: true });
+    // 创建 RULES.md
+    const rulesContent = `# AI WORKSPACE - SYSTEM PROTOCOL
+
+> 此文件定义 AI 助手的强制性工作流规则，适用于所有 AI 编辑器（Cursor、Copilot、Kiro、Claude 等）
+
+## PRIORITY: ABSOLUTE (最高优先级)
+
+你是一个基于"技能包"驱动的开发助手。在处理任何开发任务之前，必须强制执行以下协议。
+
+## SKILL DISCOVERY
+
+**动态发现技能**：扫描 \`.ai-workspace/skills/\` 目录，每个子目录即为一个技能包。
+
+## SKILL STRUCTURE
+
+每个技能包的标准结构：
+\`\`\`
+skills/[skill_name]/
+├── manifest.md    # 执行流程和规范（必读）
+├── context.md     # 项目配置（需初始化）
+├── input/         # 该技能的输入文档
+├── output/        # 该技能的输出文档
+└── tools/         # 该技能的提示词工具
+\`\`\`
+
+## MANDATORY WORKFLOW
+
+### 1. Skill Discovery (技能发现)
+- 扫描 \`skills/\` 目录，列出所有可用技能
+- 读取每个技能的 \`manifest.md\` 了解其用途
+
+### 2. Skill Selection (技能选择)
+- 根据用户任务类型，选择对应的技能包
+- 如果不确定，询问用户或列出可用技能供选择
+
+### 3. Load Skill (加载技能)
+- 读取 \`skills/[skill]/manifest.md\` 获取执行流程
+- 读取 \`skills/[skill]/context.md\` 获取项目配置
+
+### 4. Context Check (上下文检查)
+- 如果 \`context.md\` 未初始化，**终止任务**
+- 提示用户："请先执行项目初始化，参考 \`skills/[skill]/tools/init.md\`"
+
+### 5. Input Acquisition (获取输入)
+- 从 \`skills/[skill]/input/\` 读取需求文档
+
+### 6. Execute Task (执行任务)
+- 按照 \`manifest.md\` 定义的流程执行
+- 代码输出到项目源码目录（由 context.md 指定）
+
+### 7. Output Documentation (输出文档)
+- 执行日志输出到 \`skills/[skill]/output/\`
+
+## CONSTRAINTS
+
+- 严格遵循所选技能的 manifest.md 流程
+- 代码路径受控于 context.md
+- 禁止跨技能读写 input/output
+- 禁止臆造依赖库或目录
+- 新技能自动可用，无需修改此文件
+`;
+    fs.writeFileSync(rulesPath, rulesContent, 'utf-8');
+    console.log(chalk.green('\n✅ AI 工作区已创建'));
+    console.log(chalk.gray(`路径: ${workspaceDir}`));
+    console.log(chalk.cyan('\n📝 下一步:'));
+    console.log(chalk.gray('  pp skill list          # 查看可用技能包'));
+    console.log(chalk.gray('  pp skill install       # 安装技能包\n'));
+}
+// 查看已安装的技能包
+async function installedSkills(options) {
+    const chalk = await getChalk();
+    const baseDir = options?.output || '.ai-workspace';
+    const skillsDir = path.join(process.cwd(), baseDir, 'skills');
+    if (!fs.existsSync(skillsDir)) {
+        console.log(chalk.yellow('\n⚠️  未找到 AI 工作区'));
+        console.log(chalk.gray('使用 "pp workspace init" 初始化工作区\n'));
+        return;
+    }
+    const skills = (0, skills_1.loadSkillsFromDir)(skillsDir);
+    if (skills.length === 0) {
+        console.log(chalk.yellow('\n⚠️  未安装任何技能包'));
+        console.log(chalk.gray('使用 "pp skill install" 安装技能包\n'));
+        return;
+    }
+    console.log(chalk.cyan('\n🎯 已安装的技能包:\n'));
+    for (const skill of skills) {
+        const status = [];
+        if (skill.hasManifest)
+            status.push(chalk.green('✓manifest'));
+        if (skill.hasContext)
+            status.push(chalk.green('✓context'));
+        if (skill.hasTools)
+            status.push(chalk.green('✓tools'));
+        console.log(chalk.white(`  • ${skill.name}`), chalk.gray(`- ${skill.description || '无描述'}`), chalk.gray(`[${status.join(' ')}]`));
+    }
+    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/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { loadTemplatesFromDir } from './templates';
-export type { Template } from './types';
+export { loadSkillsFromDir, copySkill } from './skills';
+export type { Skill, SkillMeta, RepoConfig, PromptPlusConfig } from './types';

package/dist/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTemplatesFromDir = void 0;
-var templates_1 = require("./templates");
-Object.defineProperty(exports, "loadTemplatesFromDir", { enumerable: true, get: function () { return templates_1.loadTemplatesFromDir; } });
+exports.copySkill = exports.loadSkillsFromDir = void 0;
+var skills_1 = require("./skills");
+Object.defineProperty(exports, "loadSkillsFromDir", { enumerable: true, get: function () { return skills_1.loadSkillsFromDir; } });
+Object.defineProperty(exports, "copySkill", { enumerable: true, get: function () { return skills_1.copySkill; } });

package/dist/skills.d.ts

@@ -0,0 +1,3 @@
+import { Skill } from './types';
+export declare function loadSkillsFromDir(skillsDir: string): Skill[];
+export declare function copySkill(skillPath: string, targetDir: string): void;

package/dist/skills.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSkillsFromDir = loadSkillsFromDir;
+exports.copySkill = copySkill;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// 从 manifest.md 解析技能元数据
+function parseSkillMeta(manifestPath) {
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    const content = fs.readFileSync(manifestPath, 'utf-8');
+    const lines = content.split('\n');
+    // 解析标题作为名称
+    const titleMatch = content.match(/^#\s+(?:Skill Manifest:\s*)?(.+)/m);
+    const name = titleMatch ? titleMatch[1].trim() : '';
+    // 解析描述（## 技能描述 或 ## 核心职责 下的内容）
+    let description = '';
+    const descMatch = content.match(/##\s*(?:技能描述|核心职责)\s*\n([^\n#]+)/);
+    if (descMatch) {
+        description = descMatch[1].trim();
+    }
+    // 解析分类（如果有）
+    let category = 'general';
+    const categoryMatch = content.match(/category:\s*(\w+)/i);
+    if (categoryMatch) {
+        category = categoryMatch[1];
+    }
+    return { name, description, category };
+}
+// 从目录加载技能包
+function loadSkillsFromDir(skillsDir) {
+    if (!fs.existsSync(skillsDir)) {
+        return [];
+    }
+    const skills = [];
+    const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillPath = path.join(skillsDir, entry.name);
+        const manifestPath = path.join(skillPath, 'manifest.md');
+        const contextPath = path.join(skillPath, 'context.md');
+        const toolsPath = path.join(skillPath, 'tools');
+        const meta = parseSkillMeta(manifestPath);
+        skills.push({
+            name: entry.name,
+            description: meta?.description || '',
+            category: meta?.category || 'general',
+            path: skillPath,
+            hasManifest: fs.existsSync(manifestPath),
+            hasContext: fs.existsSync(contextPath),
+            hasTools: fs.existsSync(toolsPath),
+        });
+    }
+    return skills;
+}
+// 复制技能包到目标目录
+function copySkill(skillPath, targetDir) {
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    copyDirRecursive(skillPath, targetDir);
+}
+// 递归复制目录
+function copyDirRecursive(src, dest) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}

package/dist/types.d.ts

@@ -1,17 +1,24 @@
-export interface Template {
+export interface Skill {
     name: string;
     description: string;
     category: string;
-    content: string;
-    outputFileName: string;
+    path: string;
+    hasManifest: boolean;
+    hasContext: boolean;
+    hasTools: boolean;
 }
 export interface RepoConfig {
     name: string;
     url: string;
-    branch?: string;
+    branch: string;
 }
 export interface PromptPlusConfig {
     defaultRepo: string;
     repos: RepoConfig[];
     outputDir: string;
 }
+export interface SkillMeta {
+    name: string;
+    description: string;
+    category?: string;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prompt-plus",
-  "version": "1.0.5",
-  "description": "AI提示词模板管理工具 - 生成符合项目规范的提示词",
+  "version": "1.1.1",
+  "description": "AI技能包管理工具 - 基于技能包驱动的 AI 开发工作流",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/dist/templates/index.d.ts

@@ -1,2 +0,0 @@
-import { Template } from '../types';
-export declare function loadTemplatesFromDir(dir: string): Template[];

package/dist/templates/index.js

@@ -1,92 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTemplatesFromDir = loadTemplatesFromDir;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-// 解析 Markdown Front Matter
-function parseFrontMatter(content) {
-    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
-    if (!match) {
-        return { meta: {}, body: content };
-    }
-    const meta = {};
-    const yamlContent = match[1];
-    const body = match[2];
-    yamlContent.split('\n').forEach((line) => {
-        const colonIndex = line.indexOf(':');
-        if (colonIndex > 0) {
-            const key = line.slice(0, colonIndex).trim();
-            const value = line.slice(colonIndex + 1).trim();
-            meta[key] = value;
-        }
-    });
-    return { meta, body };
-}
-// 从目录加载模板（支持 .md 和 .json）
-function loadTemplatesFromDir(dir) {
-    if (!fs.existsSync(dir)) {
-        return [];
-    }
-    const templates = [];
-    const files = fs.readdirSync(dir);
-    for (const file of files) {
-        const filePath = path.join(dir, file);
-        try {
-            if (file.endsWith('.md') && file !== 'README.md') {
-                const content = fs.readFileSync(filePath, 'utf-8');
-                const { meta, body } = parseFrontMatter(content);
-                if (meta.name) {
-                    templates.push({
-                        name: meta.name,
-                        description: meta.description || '',
-                        category: meta.category || 'other',
-                        outputFileName: meta.outputFileName || `${meta.name}-prompt.md`,
-                        content: body.trim(),
-                    });
-                }
-            }
-            else if (file.endsWith('.json')) {
-                const content = fs.readFileSync(filePath, 'utf-8');
-                const template = JSON.parse(content);
-                templates.push(template);
-            }
-        }
-        catch {
-            // 忽略解析错误
-        }
-    }
-    return templates;
-}