Flatten skill category directory structure

2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -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       | ?               | ?                    | ?                | ?            | ?    |
+```