ByteNoteByteNote

字节笔记本

2026年2月21日

skill-prompt-generator v2.0:基于 Claude Skills 的 AI 提示词生成系统

API中转
¥120

skill-prompt-generator 是一个基于 Claude Code Skills 的 AI 提示词生成系统,通过 12 个专业领域 Skills 和 Universal Elements Library(1246+ 元素),生成高质量 AI 图像提示词。v2.0 版本新增跨 domain 查询和设计系统集成,数据库利用率从 40.3% 提升到 79.9%。

项目简介

skill-prompt-generator 由 huangserva 开发维护,是一个完整的 Skills 系统而非普通 Python 工具。截至目前,该项目在 GitHub 上已获得 1k+ stars172 forks,主要使用 Python 编写。

这不是一个普通的 Python 工具,而是一个完整的 Skills 系统:

  • Skills 优先:用户通过调用 Skills 生成提示词,不直接调用 Python
  • 智能路由:自动识别领域(人像/艺术/设计/产品/视频),调用对应专家
  • 12 个专业 Skills:每个领域有独立的专家 Skill
  • 统一数据源:所有 Skills 共享 Universal Elements Library(1246+ 元素)

v2.0 新特性

  • 跨 Domain 查询:数据库利用率从 40.3% 提升到 79.9%,充分利用所有领域元素
  • 设计系统集成:融合 prompt-crafter 的配色方案,支持 20 万+ 组合
  • 三种生成模式:Portrait(人像)/ Cross-Domain(跨域)/ Design(设计)
  • 变量采样系统:参数化元素,避免重复生成
  • 100% 向后兼容:v1.0 功能完全保留

核心特性

Skills 系统(核心)

  • 12 个专业领域 Skills:intelligent-prompt-generator, art-master, design-master, product-master, video-master, universal-learner 等
  • 智能领域路由:自动识别用户需求,调用对应专家
  • 模块化架构:每个 Skill 独立工作,协同配合

v2.0 三种生成模式

模式说明元素数量
Portrait纯人像摄影502 元素
Cross-Domain复杂场景,自动组合多个 domains995 元素
Design海报卡片,SQLite 元素 + YAML 配色20 万+ 组合

智能能力

  • 语义理解:区分主体/风格/氛围
  • 常识推理:自动推断合理属性(如人种→眼睛颜色)
  • 一致性检查:自动检测并修正逻辑冲突
  • 框架驱动:基于 prompt_framework.yaml 结构化生成
  • 跨域查询:自动识别所需 domains 并智能组合
  • 变量采样:参数化元素,智能避免重复

双轨制系统

  • 元素级生成:从 1246+ 个元素中智能选择组合
  • 模板级生成:完整设计系统模板(如 Apple PPT 模板)
  • 设计变量库:37 种配色方案 + 边框 + 装饰元素

支持领域

领域说明元素数量
portrait人像摄影502 个元素
design平面设计155 个元素(含 5 个完整模板)
interior室内设计-
product产品摄影77 个元素
art艺术风格51 个元素
video视频生成49 个元素
common通用摄影技术205 个元素
跨 domain自动组合多个领域995 个元素
设计变量配色+边框+装饰20 万+ 组合

安装指南

前置要求

  • Claude Code - 需要安装 Claude Code CLI
  • Python 3.8+ - 用于运行底层引擎
  • Git - 用于克隆项目(可选)

安装步骤

方式 1:克隆到本地(推荐)

bash
# 1. 克隆项目
git clone https://github.com/huangserva/skill-prompt-generator.git

# 2. 进入项目目录
cd skill-prompt-generator

# 3. 安装 Python 依赖
pip install -r requirements.txt

重要:克隆后,.claude/skills/ 下的 12 个 Skills 会自动被 Claude Code 识别。

方式 2:下载 ZIP

  1. 访问 https://github.com/huangserva/skill-prompt-generator
  2. 点击 "Code" → "Download ZIP"
  3. 解压到任意目录
  4. 在该目录下运行 pip install -r requirements.txt

验证安装

在 Claude Code 中测试:

text
# 测试人像生成 skill
生成电影级的亚洲女性

# 测试设计 skill
生成 Bento Grid 海报

如果 Claude Code 能正确调用 Skills 并生成提示词,说明安装成功。

快速开始

方式 1:通过 Skills 使用(推荐)⭐

这是主要使用方式 - 在 Claude Code 中直接调用 Skills:

text
# 人像摄影(Portrait 模式)
生成电影级的亚洲女性,张艺谋电影风格

# 跨 domain 场景(Cross-Domain 模式)🆕
生成龙珠悟空打出龟派气功的提示词

# 设计海报(Design 模式)🆕
生成温馨可爱风格的儿童教育海报

# 平面设计
生成 Bento Grid 玻璃态海报

# 艺术绘画
生成中国水墨画山水

# 产品摄影
生成奢华手表产品摄影

Claude Code 会自动:

  • 识别领域(人像/设计/艺术/产品)
  • 识别生成模式(Portrait/Cross-Domain/Design)🆕
  • 调用对应的专家 Skill
  • 返回完美的提示词

方式 2:直接调用 v2.0 Python 引擎 🆕

使用新的统一接口:

python
from core.cross_domain_generator import CrossDomainGenerator

generator = CrossDomainGenerator()

# 自动识别类型(portrait/cross_domain/design)
result = generator.generate("龙珠悟空打出龟派气功")

print(result['type'])     # cross_domain
print(result['prompt'])   # 完整提示词
print(result['domains'])  # ['portrait', 'video', 'art', 'common']

generator.close()

方式 3:使用 v1.0 引擎(完全兼容)

v1.0 API 完全保留,无需修改:

python
from intelligent_generator import IntelligentGenerator

gen = IntelligentGenerator()

# 生成人像提示词(v1.0 方式)
prompt = gen.generate_from_intent({
    'subject': {
        'gender': 'female',
        'ethnicity': 'East_Asian',
        'age_range': 'young_adult'
    },
    'styling': {
        'makeup': 'k_beauty'
    },
    'lighting': {
        'lighting_type': 'natural'
    }
})

print(prompt)
gen.close()

注意

  • 推荐使用方式 1(Skills)- 最简单、最智能
  • 方式 2(v2.0)- 适合需要跨 domain 和设计系统的场景
  • 方式 3(v1.0)- 适合只需要人像生成的场景

项目结构

text
.
├── .claude/                    # ⭐ Skills 系统(核心)
│   ├── CLAUDE.md              # 项目规则和 Skill 路由指南
│   └── skills/                # 12 个专业领域 Skills
│       ├── intelligent-prompt-generator/  # 人像提示词专家
│       ├── art-master/        # 艺术风格专家
│       ├── design-master/     # 平面设计专家
│       ├── product-master/    # 产品摄影专家
│       ├── video-master/      # 视频生成专家
│       ├── universal-learner/ # 学习系统
│       ├── prompt-analyzer/   # 提示词分析
│       ├── prompt-extractor/  # 元素提取
│       ├── prompt-generator/  # 通用生成器
│       ├── prompt-master/     # 主控调度
│       ├── prompt-xray/       # X-Ray 分析
│       └── domain-classifier/ # 领域分类
│
├── 🆕 core/                    # v2.0 核心模块
│   ├── cross_domain_generator.py    # 统一生成接口(主入口)
│   ├── cross_domain_query.py        # 跨 domain 查询引擎
│   ├── variable_sampler.py          # 变量采样系统
│   ├── yaml_sampler.py              # YAML 变量采样
│   ├── design_bridge.py             # SQLite+YAML 融合
│   └── schema_migration_v1.sql      # 数据库扩展脚本
│
├── 🆕 variables/               # 设计变量库(YAML)
│   ├── colors.yaml            # 37 种配色方案
│   ├── borders.yaml           # 边框样式
│   └── decorations.yaml       # 装饰元素
│
├── 🆕 design-logic/            # 设计逻辑系统
│   ├── warm-cute/             # 温馨可爱风格
│   └── modern-minimal/        # 现代简约风格
│
├── intelligent_generator.py    # Python 引擎:核心生成
├── framework_loader.py         # Python 引擎:框架加载
├── element_db.py               # Python 引擎:数据库操作
├── prompt_framework.yaml       # 人像框架定义
│
├── extracted_results/
│   └── elements.db             # Universal Elements Library (1246+ 元素)
│
├── README_v2.0.md              # 🆕 v2.0 快速开始
├── UPGRADE_GUIDE_v2.0.md       # 🆕 v2.0 升级指南
├── requirements.txt            # Python 依赖
└── README.md                   # 项目文档

架构说明

  • 用户层:通过 Claude Code 调用 Skills
  • Skills 层:12 个专业领域专家(.claude/skills/)
  • v2.0 引擎层:core/ 模块(跨 domain + 设计系统)
  • v1.0 引擎层:Python 引擎支持 Skills 运行(完全保留)
  • 数据层:Universal Elements Library(1246+ 元素)+ 设计变量库

使用示例

示例 1:人像摄影 - Portrait 模式

用户请求

生成电影级的亚洲女性,张艺谋电影风格

Skill 自动处理

  • 识别:人像摄影领域,Portrait 模式
  • 调用:intelligent-prompt-generator skill
  • 生成:电影级人像提示词,包含戏剧性光影

输出提示词

Cinematic portrait of young East Asian woman, dramatic lighting with rim light and chiaroscuro effect, Zhang Yimou's signature color palette with rich reds and golds, 85mm lens, shallow depth of field, film grain texture...

示例 2:跨 Domain 复杂场景 - Cross-Domain 模式 🆕

用户请求

生成龙珠悟空打出龟派气功的提示词

Skill 自动处理

  • 识别:跨 domain 场景(人物+动作+特效)
  • 自动组合 4 个 domains: portrait + video + art + common
  • 生成:包含人物、动作姿势、能量特效的完整提示词

输出提示词

Son Goku from Dragon Ball, spiky black hair, orange gi martial arts uniform, Kamehameha pose with hands at waist forming glowing blue energy sphere, dynamic action shot, energy beam effects, blue energy glow, cinematic lighting...

示例 3:设计海报 - Design 模式 🆕

用户请求

生成温馨可爱风格的儿童教育海报

Skill 自动处理

  • 识别:设计海报,需要专业配色系统
  • 调用:Design 模式(SQLite + YAML 融合)
  • 生成:完整设计规范(配色+边框+装饰+技术参数)

输出

Color scheme: 天空蓝色系, primary color 淡紫蓝 (#C7CEEA), Decorative elements: elements, soft natural window light, Border style: box_shadow, round corners 20px...

示例 4:平面设计(design-master skill)

用户请求

生成 Apple 风格 PPT 模板

Skill 自动处理

  • 识别:平面设计领域
  • 调用:design-master skill
  • 查询:Apple 淡蓝商务 PPT 模板(12 个元素完整系统)

输出:完整模板系统,包括背景、布局、配色、字体、视觉效果

示例 5:艺术绘画(art-master skill)

用户请求

生成中国水墨画山水

Skill 自动处理

  • 识别:艺术绘画领域(无人物)
  • 调用:art-master skill
  • 生成:包含笔触、留白、泼墨等技法的提示词

示例 6:产品摄影(product-master skill)

用户请求

生成奢华手表产品摄影

Skill 自动处理

  • 识别:产品摄影领域
  • 调用:product-master skill
  • 生成:商业级产品摄影提示词

核心功能

1. 元素库系统

  • 1246+ 个可复用元素
  • 7 大领域分类
  • 复用性评分(1-10)
  • SQLite 数据库存储

2. 模板系统

  • 完整设计系统保存
  • 包含设计理念、使用指南
  • 元素结构化组织
  • 支持 PPT、UI、品牌 VI 等

3. 智能生成

  • 框架驱动(prompt_framework.yaml
  • 语义匹配和推理
  • 一致性检查
  • 自动冲突解决

4. 学习系统

  • 从新提示词中提取元素
  • 自动领域分类
  • 复用性评分
  • 持续积累知识

数据库统计

v2.0(当前版本)

  • 总元素数:1246+
  • Portrait 领域:502 个(人像专用)
  • Design 领域:155 个(平面设计,含 5 个完整模板)
  • Product 领域:77 个(产品摄影)
  • Art 领域:51 个(艺术风格)
  • Video 领域:49 个(视频生成)
  • Common 领域:205 个(通用技术)
  • 跨 domain 可用:995 个(组合使用)
  • 设计变量:37 种配色 + 边框 + 装饰(20 万+ 组合)
  • 完整模板:5 个(Apple、Material Design、Fluent Design 等)

性能提升(v1.0 → v2.0)

指标v1.0v2.0提升
数据库利用率40.3%79.9%+98.2%
生成模式1 种3 种+200%
可用组合固定20 万+100 倍+

配置

prompt_framework.yaml

定义人像提示词的完整框架:

  • 7 大类:subject, facial, styling, expression, lighting, scene, technical
  • 字段到数据库的映射
  • 依赖规则(如 era=ancient → makeup=traditional)
  • 验证规则

开发指南

添加新元素

python
from element_db import ElementDatabase

db = ElementDatabase()

db.add_element({
    'element_id': 'portrait_expressions_010',
    'domain_id': 'portrait',
    'category_id': 'expressions',
    'name': 'serene_smile',
    'chinese_name': '宁静微笑',
    'ai_prompt_template': 'serene gentle smile...',
    'keywords': '["serene", "gentle", "peaceful"]',
    'reusability_score': 8.5
})

创建新模板

python
template = {
    'template_id': 'template_xxx',
    'name': 'Template Name',
    'chinese_name': '模板中文名',
    'category': 'ppt_design',
    'element_ids': ['elem1', 'elem2', ...],
    'element_structure': {
        'backgrounds': ['elem1'],
        'layouts': ['elem2']
    },
    'design_philosophy': '设计理念...',
    'usage_scenarios': '使用场景...'
}

项目链接

License

MIT License

分享: