vibe-coding-cn/libs/external/prompts-library

# Prompt Library **一个全面的高质量AI提示词库，支持Excel和Markdown格式之间的双向转换。** ---

[✨ 功能特性](#-功能特性) • [🚀 快速开始](#-快速开始) • [⚙️ API参考](#️-api参考) • [🤝 参与贡献](#-参与贡献) • [🗺️ 路线图](#️-路线图)

---

🖼️ 概览与演示

本词库是一个结构化的、高质量的AI提示词（Prompts）集合，旨在为开发人员、研究人员和内容创作者提供强大而灵活的工具。与许多静态的提示词列表不同，本项目提供了一个双向转换的工作流程，允许用户在易于协作的Excel格式和便于版本控制的Markdown格式之间无缝切换。

核心理念: 让高质量的提示词像代码一样被管理、分享和迭代。

---

✨ 功能特性

• 📊 双向转换: 支持Excel ↔️ Markdown格式互转，兼顾易用性与版本控制。
• 🗂️ 结构化管理: 包含多个分类，覆盖从软件工程到哲学思辨的广泛领域。
• 🤖 多平台兼容: 提示词设计兼容Claude、GPT、Gemini等主流AI模型。
• 🛠️ 自动化工具: 提供命令行工具，支持批量转换和管理。
• 🎨 易于扩展: 可以方便地添加新的提示词、分类和自定义属性。

---

⚙️ 架构与工作流程

本项目的工作流程围绕“以结构化数据为中心”的思想构建。

graph LR
    subgraph "Excel-First 工作流"
        A[1. 在 Excel 中编辑提示词] --> B{运行转换脚本};
    end

    subgraph "Git-Native 工作流"
        D[3. 在 Markdown 文件中编辑] --> E{运行转换脚本};
    end

    subgraph "中央产物"
        B --> C[2. 生成结构化的 Markdown 文件];
        E --> F[4. 更新或生成 Excel 文件]
    end

    style A fill:#D5E8D4
    style D fill:#DAE8FC
    style C fill:#F8CECC
    style F fill:#F8CECC

这个流程确保了无论是喜欢电子表格的非技术人员，还是习惯于Git和代码编辑器的开发人员，都可以高效地协作。

---

🚀 快速开始

1. 环境依赖

• Python >= 3.8

2. 安装

从源码构建

```bash git clone https://github.com/tukuaiai/prompt-library.git cd prompt-library pip install -r requirements.txt ```

3. 使用

Excel → Markdown 转换

```bash # 运行交互式转换 python3 main.py ``` 程序将扫描 `prompt_excel` 目录下的 `.xlsx` 文件，并让你选择一个进行转换。结果将输出到 `prompt_docs` 目录下一个带时间戳的文件夹中。

Markdown → Excel 转换

```bash # 运行交互式转换 python3 main.py ``` 程序将扫描 `prompt_docs` 目录，让你选择一个文档集，然后将其转换回 Excel 文件，并输出到 `prompt_excel` 目录下一个带时间戳的文件夹中。

非交互式转换

```bash # 指定要转换的 Excel 文件 python3 main.py --select "prompt_excel/your_file.xlsx" # 指定要转换的 Markdown 目录 python3 main.py --select "prompt_docs/your_docs_folder" ```

Gemini 无头：Markdown → JSONL 批处理

```bash # 将目录中的 .md 提示词批量转为 JSONL（默认输入 2/，输出 2/prompts.jsonl） python3 scripts/gemini_jsonl_batch.py --input 2 --output 2/prompts.jsonl --model gemini-2.5-flash ``` - 脚本内置固定系统提示词，调用 `gemini --allowed-tools '' --output-format text` 确保纯文本 JSONL。 - 需要本地已登录的 Gemini CLI；如需代理，请自行设置 `http_proxy/https_proxy` 环境变量。 - 可用 `-v` 查看逐文件处理日志，`--gemini-cmd` 自定义 CLI 可执行路径。

---

❓ 常见问题 (FAQ) (可选)

- **Q: 为什么转换会失败？** - **A:** 请确保您的Excel文件格式与提供的示例一致，特别是工作表（Sheet）的名称和列的标题。 - **Q: 我可以添加自己的转换逻辑吗？** - **A:** 当然可以。核心逻辑位于 `scripts/` 目录下，您可以自由修改或扩展它们。

---

🗺️ 路线图

gantt
    title 项目发展路线图
    dateFormat  YYYY-MM
    section 核心功能
    双向转换脚本 :done, 2024-10, 30d
    交互式CLI :done, 2024-11, 20d
    section 未来计划
    Web界面 :2025-01, 30d
    更丰富的导出格式 :2025-02, 20d
    云同步功能 : 2025-03, 30d

---

🤝 参与贡献

我们热烈欢迎各种形式的贡献！如果您对本项目有任何想法或建议，请随时开启一个 Issue 或提交一个 Pull Request。

在您开始之前，请花点时间阅读我们的 贡献指南 (CONTRIBUTING.md) 和 行为准则 (CODE_OF_CONDUCT.md)。

✨ 贡献者们

感谢所有为本项目做出贡献的开发者！

---

🛡️ 安全策略

我们非常重视项目的安全性。如果您发现了任何安全漏洞，请不要公开讨论，而是通过电子邮件 tukuaiai@example.com 与我们联系。

---

📜 许可证

本项目采用 MIT 许可证。

---

**如果这个项目对您有帮助，请不要吝啬您的 Star ⭐！**
**Made with ❤️ by tukuaiai** [⬆ 回到顶部](#prompt-library)