Skill Prompt Generator

AI portrait prompt generation system with intelligent feature combination and auto-learning capabilities.

Category: Image Generation

About this skill

An AI-powered portrait prompt generation system based on Claude Skills. Intelligently combines features from a library to generate high-quality portrait description prompts. Includes auto-learning, smart review, and version control capabilities.

Source and installation instructions

Installation

  1. Clone the repository
  2. Set up feature libraries
  3. Configure prompt generation settings

Documentation

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

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

🆕 Codex 适配完成！ 支持 OpenAI Codex CLI 使用全部 Skills。查看 Codex 指南 →

一个 Claude Code Skills 项目，通过12个专业领域Skills，基于Universal Elements Library（1246元素）和社区提示词语料库（675条 source prompts）生成高质量AI图像提示词。

同时支持 Claude Code 和 OpenAI Codex CLI 两种 Agent 平台。

🆕 v2.0 新特性

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

🎯 项目定位

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

✨ 核心特性

🎯 Skills系统（核心）

🆕 v2.0 三种生成模式

🧠 智能能力

📦 双轨制系统

📦 支持领域

📦 安装

前置要求

安装步骤

方式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()

注意：

📖 项目结构

.
├── .claude/                       # ⭐ Skills系统（Claude Code）
│   ├── 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/     # 领域分类
│
├── .codex/                        # ⭐ Skills系统（OpenAI Codex CLI）🆕
│   ├── codex.md                   # Codex 入口指南
│   ├── SKILL_ROUTING_GUIDE.md     # Skill 路由规则
│   ├── learner.md                 # 学习模块
│   └── skills/                    # 12个Codex版Skills（与.claude/对应）
│       ├── intelligent-prompt-generator/
│       ├── prompt-master/         # 含 analyzer/builder/extractor/learner/optimizer/recommender
│       ├── prompt-extractor/      # 含 Python preprocessor + 测试
│       ├── prompt-xray/           # 含 xray_helper.py
│       ├── universal-learner/     # 含 domain_classifier/element_extractor/tagger/library_updater
│       ├── product-master/        # 含 builder + grid_collage 模块
│       ├── art-master/
│       ├── design-master/
│       ├── domain-classifier/
│       ├── prompt-analyzer/
│       ├── prompt-generator/
│       ├── video-master/
│       └── ...
│
├── 🆕 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元素) + source_prompts (675条)
│
├── README_v2.0.md                 # 🆕 v2.0快速开始
├── UPGRADE_GUIDE_v2.0.md          # 🆕 v2.0升级指南
└── README.md                      # 项目文档（本文件）

架构说明：

🎨 使用示例

示例1：人像摄影 - Portrait模式（intelligent-prompt-generator skill）

用户请求：

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

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自动处理：

输出提示词：

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自动处理：

输出：

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自动处理：

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

示例5：艺术绘画（art-master skill）

用户请求：

生成中国水墨画山水

Skill自动处理：

示例6：产品摄影（product-master skill）

用户请求：

生成奢华手表产品摄影

Skill自动处理：

🛠️ 核心功能

1. 元素库系统

2. 模板系统

3. 智能生成

4. 学习系统

📊 数据库统计

元素库（当前版本）

社区语料库 🆕

性能提升（v1.0 → v2.0）

🔧 配置

prompt_framework.yaml

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

📝 开发指南

添加新元素

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
})

创建新模板

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': '使用场景...'
}

🤝 贡献

欢迎提交Issue和Pull Request！

贡献者

📄 License

MIT License

📚 相关文档

🙏 致谢