prompt-plus 1.0.0

package/README.md

@@ -0,0 +1,118 @@
+# prompt-plus
+
+AI 提示词模板管理工具 - 生成符合项目规范的提示词
+
+## 安装
+
+```bash
+npm install -g prompt-plus
+```
+
+## 快速开始
+
+```bash
+# 1. 添加官方模板仓库
+prompt-plus repo add official https://github.com/LeeSeaside/prompt-plus-templates.git
+
+# 2. 同步模板
+prompt-plus repo sync
+
+# 3. 查看可用模板
+prompt-plus list
+
+# 4. 使用模板
+prompt-plus use backend-api
+```
+
+## 命令
+
+### 模板操作
+
+```bash
+# 列出所有模板
+prompt-plus list
+prompt-plus ls
+
+# 使用模板（交互式选择）
+prompt-plus use
+
+# 使用指定模板
+prompt-plus use <模板名>
+
+# 指定输出目录
+prompt-plus use <模板名> -o ./my-prompts
+```
+
+### 仓库管理
+
+```bash
+# 查看仓库列表
+prompt-plus repo ls
+
+# 添加仓库
+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 <名称>
+```
+
+## 自建模板仓库
+
+创建 Git 仓库，在 `templates/` 目录下放置 Markdown 模板文件：
+
+```
+my-templates/
+└── templates/
+    ├── my-template-1.md
+    └── my-template-2.md
+```
+
+模板格式（Markdown + Front Matter）：
+
+```markdown
+---
+name: my-template
+description: 模板描述
+category: backend
+outputFileName: my-template-prompt.md
+---
+
+# 模板标题
+
+## 任务
+模板内容...
+```
+
+## 工作流程
+
+```
+模板 → 正式提示词 → 对接文档/代码
+
+.prompts/
+├── templates/     # 提示词模板
+└── generated/     # 正式提示词（AI 生成）
+
+docs/
+└── api/           # 对接文档（业务相关）
+```
+
+## 本地开发
+
+```bash
+npm install
+npm run build
+npm link
+prompt-plus list
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const commands_1 = require("./commands");
+const program = new commander_1.Command();
+program
+    .name('prompt-plus')
+    .description('AI提示词模板管理工具 - 生成符合项目规范的提示词')
+    .version('1.0.0');
+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('管理模板仓库')
+    .addCommand(new commander_1.Command('add')
+    .description('添加模板仓库')
+    .argument('<name>', '仓库名称')
+    .argument('<url>', '仓库地址')
+    .option('-b, --branch <branch>', '分支名称', 'main')
+    .action(commands_1.addRepo))
+    .addCommand(new commander_1.Command('remove')
+    .alias('rm')
+    .description('移除模板仓库')
+    .argument('<name>', '仓库名称')
+    .action(commands_1.removeRepo))
+    .addCommand(new commander_1.Command('list')
+    .alias('ls')
+    .description('列出所有模板仓库')
+    .action(commands_1.listRepos))
+    .addCommand(new commander_1.Command('sync')
+    .description('同步模板仓库')
+    .argument('[name]', '仓库名称（不指定则同步所有）')
+    .action(commands_1.syncRepo));
+program.parse();

package/dist/commands.d.ts

@@ -0,0 +1,14 @@
+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>;

package/dist/commands.js

@@ -0,0 +1,299 @@
+"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.listTemplates = listTemplates;
+exports.useTemplate = useTemplate;
+exports.initConfig = initConfig;
+exports.addRepo = addRepo;
+exports.removeRepo = removeRepo;
+exports.listRepos = listRepos;
+exports.syncRepo = syncRepo;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const templates_1 = require("./templates");
+// 配置文件路径（全局配置）
+const getGlobalConfigDir = () => path.join(process.env.HOME || process.env.USERPROFILE || '', '.prompt-plus');
+const getGlobalConfigPath = () => path.join(getGlobalConfigDir(), 'config.json');
+const getReposDir = () => path.join(getGlobalConfigDir(), 'repos');
+// 动态导入 ESM 模块
+async function getChalk() {
+    return (await Promise.resolve().then(() => __importStar(require('chalk')))).default;
+}
+async function getInquirer() {
+    return (await Promise.resolve().then(() => __importStar(require('inquirer')))).default;
+}
+// 获取全局配置
+function getConfig() {
+    const configPath = getGlobalConfigPath();
+    if (fs.existsSync(configPath)) {
+        return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    }
+    return {
+        defaultRepo: '',
+        repos: [],
+        outputDir: '.prompts',
+    };
+}
+// 保存全局配置
+function saveConfig(config) {
+    const configDir = getGlobalConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    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();
+    if (config.repos.find((r) => r.name === name)) {
+        console.log(chalk.yellow(`\n⚠️  仓库 "${name}" 已存在\n`));
+        return;
+    }
+    config.repos.push({
+        name,
+        url,
+        branch: options?.branch || 'main',
+    });
+    saveConfig(config);
+    console.log(chalk.green(`\n✅ 已添加仓库: ${name}`));
+    console.log(chalk.gray(`使用 "prompt-plus repo sync ${name}" 同步模板\n`));
+}
+async function removeRepo(name) {
+    const chalk = await getChalk();
+    const config = getConfig();
+    const index = config.repos.findIndex((r) => r.name === name);
+    if (index === -1) {
+        console.log(chalk.red(`\n❌ 未找到仓库: ${name}\n`));
+        return;
+    }
+    config.repos.splice(index, 1);
+    saveConfig(config);
+    // 删除本地仓库目录
+    const repoDir = path.join(getReposDir(), name);
+    if (fs.existsSync(repoDir)) {
+        fs.rmSync(repoDir, { recursive: true, force: true });
+    }
+    console.log(chalk.green(`\n✅ 已移除仓库: ${name}\n`));
+}
+async function listRepos() {
+    const chalk = await getChalk();
+    const config = getConfig();
+    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'));
+        return;
+    }
+    for (const repo of config.repos) {
+        const synced = fs.existsSync(path.join(getReposDir(), repo.name));
+        const status = synced ? chalk.green('✓ 已同步') : chalk.yellow('未同步');
+        console.log(chalk.white(`  • ${repo.name}`), chalk.gray(`- ${repo.url}`), status);
+    }
+    console.log(chalk.gray('\n使用 "prompt-plus repo add <name> <url>" 添加仓库'));
+    console.log(chalk.gray('使用 "prompt-plus repo sync [name]" 同步仓库\n'));
+}
+async function syncRepo(name) {
+    const chalk = await getChalk();
+    const config = getConfig();
+    const reposDir = getReposDir();
+    if (!fs.existsSync(reposDir)) {
+        fs.mkdirSync(reposDir, { recursive: true });
+    }
+    const reposToSync = name ? config.repos.filter((r) => r.name === name) : config.repos;
+    if (reposToSync.length === 0) {
+        if (name) {
+            console.log(chalk.red(`\n❌ 未找到仓库: ${name}\n`));
+        }
+        else {
+            console.log(chalk.yellow('\n⚠️  没有配置任何仓库'));
+            console.log(chalk.gray('使用 "prompt-plus repo add <name> <url>" 添加仓库\n'));
+        }
+        return;
+    }
+    for (const repo of reposToSync) {
+        const repoDir = path.join(reposDir, repo.name);
+        console.log(chalk.cyan(`\n🔄 同步仓库: ${repo.name}...`));
+        try {
+            if (fs.existsSync(repoDir)) {
+                (0, child_process_1.execSync)(`git -C "${repoDir}" pull origin ${repo.branch || 'main'}`, { stdio: 'pipe' });
+                console.log(chalk.green(`✅ 已更新: ${repo.name}`));
+            }
+            else {
+                (0, child_process_1.execSync)(`git clone -b ${repo.branch || 'main'} "${repo.url}" "${repoDir}"`, { stdio: 'pipe' });
+                console.log(chalk.green(`✅ 已克隆: ${repo.name}`));
+            }
+        }
+        catch (error) {
+            console.log(chalk.red(`❌ 同步失败: ${repo.name}`));
+            console.log(chalk.gray(`   ${error.message}`));
+        }
+    }
+    console.log();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { loadTemplatesFromDir } from './templates';
+export type { Template } from './types';

package/dist/index.js

@@ -0,0 +1,5 @@
+"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; } });

package/dist/templates/index.d.ts

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

package/dist/templates/index.js

@@ -0,0 +1,92 @@
+"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;
+}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+export interface Template {
+    name: string;
+    description: string;
+    category: string;
+    content: string;
+    outputFileName: string;
+}
+export interface RepoConfig {
+    name: string;
+    url: string;
+    branch?: string;
+}
+export interface PromptPlusConfig {
+    defaultRepo: string;
+    repos: RepoConfig[];
+    outputDir: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "prompt-plus",
+  "version": "1.0.0",
+  "description": "AI提示词模板管理工具 - 生成符合项目规范的提示词",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "prompt-plus": "./dist/cli.js",
+    "pp": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "prompt",
+    "ai",
+    "template",
+    "cursor",
+    "copilot",
+    "chatgpt",
+    "claude",
+    "llm"
+  ],
+  "author": "LeeSeaside",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LeeSeaside/prompt-plus.git"
+  },
+  "homepage": "https://github.com/LeeSeaside/prompt-plus#readme",
+  "bugs": {
+    "url": "https://github.com/LeeSeaside/prompt-plus/issues"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}