專案總覽
skill-prompt-generator 是一個開源的 Claude Code Skills 函式庫,能將簡潔的創意簡報轉換為細節豐富、領域精確的 AI 圖像生成提示詞 — 省去了手動提示詞工程的麻煩,這種工程會拖慢 Midjourney、DALL-E 3 或 Stable Diffusion 等工具的工作流程。
專案背景與定位
為何存在
撰寫有效的 AI 圖像提示詞需要對每個創意領域的詞彙有深入的了解:人像燈光術語與海報佈局語言、產品攝影材質分類法或電影動態詞彙有根本上的差異。大多數開發者和創作者缺乏這種廣度,他們的提示詞要麼過於籠統,要麼內部不一致。skill-prompt-generator 將領域專業知識封裝到 12 個專業的 Claude Code Skills 中,並由一個 1,246+ 個元素的 SQLite 資料庫支援 — 調用一個技能,即可在幾秒鐘內獲得專家級的提示詞。
與類似專案的差異
與靜態提示詞範本庫或單一用途的建構器不同,skill-prompt-generator 是一個原生的 Claude Code Skills 系統,具有智慧路由功能。引擎讀取使用者的意圖,自動從 12 個領域模組中選擇正確的專業技能,應用語義一致性檢查以防止元素衝突,並從元素資料庫中取樣以確保多樣性。2.0 版本增加了用於多類型場景的跨領域模式(Cross-Domain Mode)和由 200,000 多種顏色、邊框和佈局組合支援的設計模式(Design Mode)— 這些功能遠遠超出了基於規則的範本所能實現的。
功能類別
📸 人像攝影
- 涵蓋燈光、鏡頭、姿勢、膚質、表情和時代的 502 個精選元素
- 智慧依賴規則(例如,古代時期會自動觸發傳統風格)
- 範例:黃金時段輪廓光、85mm f/1.4 散景、編輯時尚構圖、電影級色彩分級
- 目的:為頭像、生活風格和編輯類作品生成逼真、技術精確的人像提示詞
🎨 平面設計與海報
- 涵蓋佈局、排版、色彩理論和印刷慣例的 155 個元素
- 設計模式每次運行都會從 200,000 多種顏色-邊框-裝飾組合中取樣
- 範例:瑞士網格海報、霓虹粗野主義卡片、極簡品牌識別、復古演唱會傳單
- 目的:生成視覺上獨特的設計提示詞,每次運行都不會重複
🛍️ 產品攝影
- 涵蓋桌面燈光、材質紋理、背景和品牌背景的 77 個商業元素
- 範例:漂浮的化妝品瓶、霧面陶瓷漫射光、主體拍攝飲料、生活風格平鋪
- 目的:為電子商務、廣告和目錄圖像製作具有專業構圖規則的提示詞
🖼️ 藝術風格
- 涵蓋古典到當代運動的 51 個美術技巧元素
- 範例:中國水墨畫、厚塗油畫、生成幾何抽象、復古波普藝術網點
- 目的:將領域準確的藝術詞彙應用於任何主題,以生成畫廊級別的圖像
🎬 影片生成
- 涵蓋攝影機運動、節奏和動態場景構圖的 49 個動態感知元素
- 範例:跟蹤推軌鏡頭、慢動作飛濺、航拍縮時攝影、焦點轉移揭示
- 目的:為 Sora、Kling 或 RunwayML 等工具生成具有正確電影語言的影片提示詞
📷 一般攝影技巧
- 涵蓋曝光、景深、色彩分級和構圖的 205 個元素
- 範例:傾斜移軸縮小、交叉處理膠片模擬、HDR 風景、三分法裁剪
- 目的:無論主體類型如何,都能以攝影精度補充任何領域
核心亮點
智慧 4 步驟領域路由 — 內建的決策樹檢查使用者意圖,對主要領域進行分類,檢測衝突,並在無需手動配置的情況下調用最合適的專業技能。使用者無需知道調用哪個技能。
1,246+ 個元素的 SQLite 資料庫 — 所有提示詞詞彙都存儲在一個標準化的關聯式資料庫(elements.db)中,包含領域、類別、可重用性分數和使用計數器元數據。這使得函式庫在不修改原始碼的情況下即可查詢、版本化和擴展。
三種生成模式(v2.0) — 人像模式(Portrait Mode)保持 v1.0 的完整向後兼容性;跨領域模式(Cross-Domain Mode)混合 2-4 個領域的詞彙以處理複雜場景;設計模式(Design Mode)將 YAML 變數取樣器連接到 200,000 多種顏色-邊框-佈局組合,用於圖形輸出。
自我學習通用學習器 — 內建的提取管道掃描任何新提示詞中的未定義特徵,按類別重要性對其進行優先排序,並生成審核報告供人工批准後再提交到資料庫 — 使函式庫能夠隨著時間的推移自主成長。
語義一致性引擎 — 在最終確定提示詞之前,IntelligentGenerator 運行 check_consistency() 和 resolve_conflicts() 來檢測不兼容的元素配對(例如,霓虹賽博朋克燈光與維多利亞時代背景)並自動更正它們 — 防止產生不連貫的圖像輸出。
完整的 Python API + Skills 介面 — 開發者可以直接從 Python 腳本調用 intelligent_generator.py 或通過 Claude Code Skills 介面進行整合,支援程式化管道和互動式創意會話。
按角色劃分的用例
一般開發者
將 Python API 整合到圖像生成管道中。傳遞一行主體描述;接收一個生產就緒的提示詞字串,可以直接轉發給擴散模型 API。自我學習系統意味著函式庫會隨著您輸入新提示詞而改進。
DevOps / 自動化工程師
將 CrossDomainGenerator 嵌入批次作業中,以大規模生成營銷素材、產品目錄圖像或社交媒體內容。200,000 多種組合空間確保了大型運行中的視覺多樣性,無需手動變更提示詞。
數據與研究團隊
使用 SQLite 元素資料庫作為提示詞工程研究的結構化數據集。通過 export_to_json() 導出以進行版本控制的分析,查詢元素共現模式,並對存儲在 source_prompts 中的提示詞質量分數進行基準測試。
產品與創意團隊
互動式使用 Claude Code Skills:用普通語言描述創意概念,讓路由系統選擇正確的技能(art-master、design-master、video-master 等),並在不學習提示詞語法的情況下迭代生成的提示詞。設計模式通過在您的團隊控制的 YAML 設定檔中編碼顏色配置和排版規則來產生符合品牌標準的結果。
快速入門
🔍 如何查找資源
該專案的 1,246+ 個元素按領域組織在 SQLite 資料庫中。要探索可用元素:
from element_db import ElementDB
db = ElementDB("extracted_results/elements.db")
print(db.get_stats()) # 全局指標
results = db.search_by_domain("portrait", min_reusability=0.7)
.claude/SKILL_ROUTING_GUIDE.md 文件記錄了完整的 4 步驟決策樹和所有 12 個技能定義。knowledge_base/ 目錄包含人類可讀的指南(例如,色彩控制理論)。
🛠 如何安裝 / 整合
先決條件: Python 3.9+、anthropic>=0.7.0、pyyaml>=6.0
# 1. 克隆儲存庫
git clone https://github.com/huangserva/skill-prompt-generator.git
cd skill-prompt-generator
# 2. 安裝依賴項
pip install -r requirements.txt
# 3. 通過 Python API 生成提示詞
python - <<'EOF'
from intelligent_generator import assemble_prompt_from_elements, query_candidates_by_intent
intent = "a confident young woman in a sunlit café, editorial fashion style"
elements = query_candidates_by_intent(intent)
prompt = assemble_prompt_from_elements(elements, subject_desc=intent)
print(prompt)
EOF
Claude Code Skills 整合
將 .claude/ 目錄放在您的專案根目錄並在 Claude Code 中打開專案。所有 12 個技能均可立即使用 — 無需額外配置:
# 在 Claude Code 中,只需描述您的圖像:
> Generate a product shot for a matte black water bottle on a marble surface
# → 自動路由到 product-master 技能
v2.0 跨領域模式
from core.cross_domain_generator import CrossDomainGenerator
gen = CrossDomainGenerator()
result = gen.generate(
intent="cyberpunk city street at night with neon reflections",
mode="cross_domain" # 如果省略則自動檢測
)
print(result["prompt"])
🤝 如何貢獻
# Fork 並克隆
git clone https://github.com/<your-username>/skill-prompt-generator.git
cd skill-prompt-generator
# 創建一個功能分支
git checkout -b feature/add-architecture-domain
# 通過 ElementDB API 添加新元素(優於直接 SQL)
python - <<'EOF'
from element_db import ElementDB
db = ElementDB("extracted_results/elements.db")
db.add_element(
domain="architecture",
category="style",
template="brutalist concrete façade with exposed aggregate",
keywords=["brutalism", "concrete", "architecture"],
reusability_score=0.85
)
EOF
# 運行通用學習器以發現未定義的特徵
python -c "from intelligent_generator import IntelligentGenerator; IntelligentGenerator().run_learner()"
# Commit 並打開一個 Pull Request
git add -A && git commit -m "feat: add architecture domain elements"
git push origin feature/add-architecture-domain
專案結構
skill-prompt-generator/
├── intelligent_generator.py # 主要生成引擎與 IntelligentGenerator 類別
├── element_db.py # ElementDB CRUD、搜尋、導入/導出
├── framework_loader.py # YAML 框架載入工具
├── prompt_framework.yaml # 七類框架配置(v1.0)
├── requirements.txt # Python 依賴項
│
├── core/ # v2.0 架構模組
│ ├── cross_domain_generator.py # 統一的三模式生成介面
│ ├── cross_domain_query.py # 跨領域元素檢索引擎
│ ├── design_bridge.py # YAML 設計系統 ↔ 提示詞橋樑
│ ├── variable_sampler.py # 200K+ 組合取樣器
│ ├── yaml_sampler.py # YAML 變數載入與隨機取樣
│ └── schema_migration_v1.sql # 資料庫遷移腳本
│
├── .claude/ # Claude Code 整合
│ ├── claude.md # 架構規則與設計原則
│ ├── SKILL_ROUTING_GUIDE.md # 4 步驟路由決策樹
│ └── skills/ # 12 個技能目錄
│ ├── intelligent-prompt-generator/ # 人像攝影
│ ├── art-master/ # 美術風格
│ ├── design-master/ # 平面設計與海報
│ ├── product-master/ # 產品攝影
│ ├── video-master/ # 影片生成
│ ├── prompt-master/ # 編排器技能
│ ├── domain-classifier/ # 意圖分類
│ ├── prompt-analyzer/ # 提示詞質量分析
│ ├── prompt-extractor/ # 特徵提取
│ ├── prompt-xray/ # 提示詞結構檢查
│ ├── universal-learner/ # 自我學習管道
│ └── prompt-crafter/ # 設計系統提示詞構建器
│
├── variables/ # 設計系統 YAML 配置
│ ├── colors.yaml # 37 種顏色方案(溫馨可愛 + 現代極簡)
│ ├── borders.yaml # 邊框樣式定義
│ └── decorations.yaml # 裝飾元素庫
│
├── design-logic/ # 設計範本目錄
│ ├── modern-minimal/ # 深藍/中性專業風格
│ └── warm-cute/ # 珊瑚粉/天藍色易於親近的風格
│
├── knowledge_base/ # 人類可讀的領域指南
│ └── how_to_control_color.md
│
└── extracted_results/ # 生成的提示詞輸出(gitignored DB)
└── .gitignore # 在本地保留 elements.db
相關生態系統
上游平台
- Claude Code (Anthropic) — 執行所有 12 個領域技能的技能運行時;
.claude/目錄直接整合,無需插件 - Anthropic Python SDK (
anthropic>=0.7.0) — 為通用學習器中的 AI 輔助特徵提取提供支援
圖像生成目標
- Midjourney — 主要提示詞目的地;元素詞彙與 Midjourney 的參數約定一致
- DALL-E 3 / GPT-Image — 兼容的提示詞結構;設計模式輸出適合 OpenAI 的風格描述符
- Stable Diffusion / ComfyUI — 提示詞字串是純文本兼容任何 SD 前端
- Sora / Kling / RunwayML — 影片大師技能輸出適合影片生成 API 的電影語言
補充工具
- SQLite Browser — 檢查和手動編輯
elements.db以進行批量元素管理 - PyYAML — 為變數取樣器和設計系統配置層提供支援
- Pandas (可選) — 有助於對
source_prompts質量分數進行批量分析
授權
MIT 授權
| ✅商業用途 | 允許 — 用於產品、SaaS、客戶工作 |
| ✅修改 | 允許 — Fork、擴展、重新品牌化 |
| ✅分發 | 允許 — 附帶歸屬進行重新分發 |
| ✅私人使用 | 允許 — 內部工具、研究 |
| ❌責任 | 不提供保證;自行承擔風險使用 |
| ❌商標 | MIT 不授予專案名稱的商標權利 |
| ℹ️歸屬 | 在分發中包含原始 MIT 授權文本 |
常見問題
問:我需要 Claude API 密鑰才能使用提示詞生成器嗎?
答:核心 Python 生成引擎(intelligent_generator.py、element_db.py)在本地運行,無需 API 調用。Claude API 僅用於通用學習器的 AI 輔助特徵提取步驟 — 所有其他生成都是確定性的 Python。
問:如何添加一個新的創意領域(例如,建築或時尚插畫)?
答:使用 ElementDB.add_element() 插入帶有新 domain 值的詞彙,然後在 .claude/skills/ 下創建一個對應的技能目錄,遵循現有的技能範本。一旦其關鍵字在 SKILL_ROUTING_GUIDE.md 中註冊,路由系統就會自動識別新領域。
問:v1.0 和 v2.0 有什麼區別?
答:v1.0 僅支持人像模式(502 個元素,7 類框架)。v2.0 擴展到 1,246+ 個元素,增加了跨領域模式和設計模式,將 SQLite 利用率從 40% 提高到 80%,並引入了 200,000 多種設計組合。v2.0 具有 100% 的向後兼容性;現有的 v1.0 調用無需更改。
問:生成的提示詞可以保存和重複使用嗎?
答:是的。save_generated_prompt() 將每個生成的提示詞持久化到 source_prompts 表中,並附帶質量分數、使用者意圖和使用的元素 ID。通用學習器之後可以掃描這些存儲的提示詞,為函式庫發現新詞彙。
問:一致性檢查器如何防止不良的元素組合?
答:check_consistency() 根據硬編碼的不兼容規則(時代衝突、燈光矛盾、風格衝突)評估元素對。resolve_conflicts() 應用優先級層次結構 — 主體 > 燈光 > 風格 > 背景 — 並自動用兼容的替代品替換較低優先級的衝突元素。
快速連結
- 儲存庫: https://github.com/huangserva/skill-prompt-generator
- v2.0 發布說明: 儲存庫根目錄中的
README_v2.0.md - 遷移指南: 儲存庫根目錄中的
UPGRADE_GUIDE_v2.0.md - 路由參考:
.claude/SKILL_ROUTING_GUIDE.md - 架構原則:
.claude/claude.md - 問題與功能請求: https://github.com/huangserva/skill-prompt-generator/issues
摘要
skill-prompt-generator 是最完整的開源 Claude Code Skills 實現,用於 AI 圖像提示詞生成,結合了 1,246+ 個元素的領域資料庫、跨 12 個專業技能的智慧路由以及一個隨時間擴展函式庫的自我學習管道。對於任何希望獲得專業級 AI 圖像提示詞而無需手動掌握每個視覺領域詞彙的開發者、創意團隊或自動化工程師來說,它是理想的工具。