Flatten skill category directory structure

This commit is contained in:
2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,35 @@
# Character Profile — {project_name}
## Physical Features
- **Gender**: [male / female / non-binary]
- **Age Range**: [approximate age range, e.g. 20-25]
- **Hair**: [color], [length], [style — straight/curly/wavy/tied up, bangs or not]
- **Skin Tone**: [light/medium/dark], [warm/cool undertone]
- **Face Shape**: [oval / round / square / heart / oblong]
## Distinctive Facial Features
- **Eyes**: [shape, size, color, double/single eyelid, lash details]
- **Eyebrows**: [shape, thickness, color]
- **Nose**: [shape, size, bridge height]
- **Lips**: [shape, thickness, color]
- **Unique Marks**: [moles, dimples, freckles, scars — or "none"]
## Outfit
- **Clothing**: [type and description, e.g. "black leather jacket over white t-shirt"]
- **Colors**: [dominant colors with hex values if possible]
- **Texture**: [fabric type — cotton, silk, leather, denim, etc.]
- **Accessories**: [jewelry, glasses, hat, etc. — or "none"]
## Scene Context
- **Pose**: [standing/sitting/etc., body orientation, hand position]
- **Background**: [environment description]
- **Lighting**: [direction — front/side/back, quality — soft/hard/dramatic]
- **Color Palette**: [dominant colors of the overall image]
## Output Specs
- **Aspect Ratio**: [9:16 / 16:9 / 1:1]
@@ -0,0 +1,73 @@
# Face Warp — Prompt Templates
## Shared Character Prefix
All prompts begin with this prefix, populated from `profile.md`:
```
[gender], [age range], [hair description], [skin tone], wearing [outfit description],
[pose description], [background/environment], [lighting]
```
---
## 1. Faceless (faceless.png)
### Base Prompt
```
{character_prefix}. The face area is completely smooth and featureless — no eyes,
no nose, no mouth, no eyebrows — just smooth blank skin where facial features
should be. The rest of the body, clothing, hair, and background remain
photorealistic and unchanged. Maintain exact same clothing, hair, body proportions,
and skin tone as the reference image. Photorealistic, high detail, 8K.
```
### Retry Reinforcement Keywords
| Failure Reason | Append to Prompt |
|----------------|-----------------|
| Face still visible | `absolutely NO facial features whatsoever, completely smooth featureless skin, mannequin-like blank face` |
| Character inconsistency | `MUST maintain exact same clothing ({outfit}), hair ({hair}), body proportions, and {skin_tone} skin tone as the reference image` |
| Unnatural appearance | `seamless photorealistic skin texture, natural smooth transition from hair to blank face area, no editing artifacts` |
---
## 2. Puzzle (puzzle.png)
### Base Prompt
```
Facial features extracted from the reference portrait, arranged on a clean white
background following the natural face layout — eyes at the top, nose in the middle,
mouth at the bottom — maintaining their correct relative positions as if the face
outline was removed but the features stayed in place. Each feature (eyes, nose,
mouth, eyebrows) is a separate piece with only narrow gaps (2-3mm) between them,
like a face puzzle with thin seams. No face outline, no hair, no body, no skin
filling between features — only the isolated features with small gaps revealing
white background between them. Each piece maintains the original skin tone and
photorealistic texture. {skin_tone} skin, {eye_description} eyes,
{nose_description} nose, {lip_description} lips. Photorealistic, sharp detail,
8K, studio lighting, white background.
```
### Retry Reinforcement Keywords
| Failure Reason | Append to Prompt |
|----------------|-----------------|
| Features don't match | `facial features MUST match the reference portrait exactly — {eye_description} eyes, {nose_description} nose, {lip_description} lips` |
| Skin tone mismatch | `each feature piece must have {skin_tone} skin, matching the reference portrait skin tone exactly` |
| Shows complete face | `NO complete face, NO face outline, NO connected skin between features — only isolated individual features with white gaps between them` |
| Gaps too wide | `features arranged in natural face layout with NARROW gaps (2-3mm thin seams only), maintaining relative positions` |
---
## Prompt Construction Checklist
Before submitting any prompt, verify:
- [ ] Character prefix includes all 7 fields (gender, age, hair, skin, outfit, pose, background/lighting)
- [ ] Faceless prompt explicitly says "no eyes, no nose, no mouth, no eyebrows"
- [ ] Puzzle prompt specifies skin tone, eye/nose/lip descriptions from profile
- [ ] Puzzle prompt includes "narrow gaps (2-3mm)" and "natural face layout"
- [ ] Both prompts end with quality anchors (Photorealistic, high detail, 8K)
@@ -0,0 +1,98 @@
# Face Warp — Quality Criteria & Retry Strategy
## Evaluation Prompt
Send original portrait + generated images to `read_media` together:
```
read_media(
file_paths=[faceless_image, puzzle_image, original_portrait],
question="Image 1 is a faceless variant, Image 2 is a puzzle variant, Image 3 is the original portrait.
Rate each variant on a 1-10 scale. Return your evaluation in this exact format:
FACELESS SCORES:
face_concealment: [score] — [brief reason]
character_consistency: [score] — [brief reason]
natural_appearance: [score] — [brief reason]
image_quality: [score] — [brief reason]
PUZZLE SCORES:
feature_accuracy: [score] — [brief reason]
skin_tone_consistency: [score] — [brief reason]
artistic_quality: [score] — [brief reason]
no_full_face: [score] — [brief reason]
VERDICT:
faceless_pass: [true/false]
puzzle_pass: [true/false]
lowest_scoring_dimension: [dimension name]
Scoring criteria below."
)
```
## Scoring Rubric
### Faceless Image
| Dimension | Threshold | What to Check |
|-----------|-----------|---------------|
| **face_concealment** | ≥ 8 | Face area is completely smooth with NO recognizable eyes, nose, mouth, eyebrows |
| **character_consistency** | ≥ 7 | Body, clothing, hair, skin tone match the original portrait |
| **natural_appearance** | ≥ 7 | Smooth face looks natural and photorealistic, not like bad Photoshop |
| **image_quality** | ≥ 7 | Overall photographic quality — sharp, well-lit, no artifacts |
### Puzzle Image
| Dimension | Threshold | What to Check |
|-----------|-----------|---------------|
| **feature_accuracy** | ≥ 7 | Extracted eyes, nose, lips visually match the original portrait |
| **skin_tone_consistency** | ≥ 7 | Skin tone of each feature piece matches the original |
| **artistic_quality** | ≥ 7 | Puzzle/collage is clean, well-arranged, and visually appealing |
| **no_full_face** | ≥ 8 | Must NOT show a complete recognizable face — only separated features |
## Pass/Fail Logic
```
PASS = all dimensions ≥ their threshold
FAIL = any dimension below threshold → retry ONLY that image
```
- Retry only the failing image, not both
- Maximum 2 retries per image
- After 2 retries, keep the best-scoring version
## Retry Prompt Adjustment Strategy
When retrying, append reinforcement keywords to the original prompt based on which dimension failed:
| Failed Dimension | Prompt Reinforcement |
|------------------|---------------------|
| face_concealment | `completely smooth featureless skin, absolutely no facial features, mannequin-like blank face` |
| character_consistency | `maintain exact same clothing, hair, body proportions as reference` |
| natural_appearance | `seamless, photorealistic skin texture, natural transition, no editing artifacts` |
| feature_accuracy | Strengthen specific feature descriptors, add `matching the reference portrait exactly` |
| skin_tone_consistency | Emphasize exact skin tone from profile, add `{skin_tone} skin matching reference` |
| artistic_quality | Add `clean composition, professional studio photography, minimal and elegant` |
| no_full_face | `no complete face, only isolated individual features with gaps between them, no connected skin` |
## Score Tracking
Keep track of scores across retries to select best version:
```
./.face-warp/{project_name}/quality_log.md
# Quality Log
## Faceless
| Attempt | face_concealment | character_consistency | natural_appearance | image_quality | Pass |
|---------|-----------------|----------------------|--------------------|---------------|------|
| 1 | ? | ? | ? | ? | ? |
## Puzzle
| Attempt | feature_accuracy | skin_tone_consistency | artistic_quality | no_full_face | Pass |
|---------|-----------------|----------------------|------------------|--------------|------|
| 1 | ? | ? | ? | ? | ? |
```