huangserva/skill-prompt-generator

这是一个基于Claude Skill的**AI人像Prompt生成系统**,能够从特征库中智能组合生成高质量的人像描述Prompt,并具备自动学习和库扩展能力。 核心能力: Prompt生成、特征提取、自动学习、智能审核、版本控制

936 stars158 forksUpdated Jan 14, 2026
npx skills add huangserva/skill-prompt-generator

README

Skill Prompt Generator - 基于Skills的智能提示词生成系统

🎉 v2.0 已发布! 新增跨domain查询和设计系统集成。查看升级指南 →

一个 Claude Code Skills 项目,通过12个专业领域Skills,基于Universal Elements Library(1246+元素)生成高质量AI图像提示词。

🆕 v2.0 新特性

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

快速开始 v2.0 → | 完整升级指南 →

🎯 项目定位

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

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

✨ 核心特性

🎯 Skills系统(核心)

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

🆕 v2.0 三种生成模式

  • Portrait(人像) - 纯人像摄影,使用portrait domain(502元素)
  • Cross-Domain(跨域) - 复杂场景,自动组合多个domains(995元素)
  • 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:克隆到本地(推荐)

# 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中测试:

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

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

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


🚀 快速开始

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

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

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

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

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

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

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

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

Claude Code会自动:

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

方式2:直接调用v2.0 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完全保留,无需修改:

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)- 适合只需要人像生成的场景

📖 项目结构

.
├── .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        

...
Read full README

Publisher

huangservahuangserva

Statistics

Stars936
Forks158
Open Issues5
CreatedJan 5, 2026