xiaohei-biology-comic-column

name	xiaohei-biology-comic-column
description	Use when creating or managing the 小黑旁白生物课 Xiaohongshu comic-learning column from Chinese K12 textbook chapters. Guides Codex through source reading, chapter extraction, life-based hook selection, episode bible, single-image comic script, Xiaohei narrator role, imagen/image_gen generation, Obsidian file placement, publish copy, QA, and archival loops.

小黑旁白生物课 Skill

Purpose

Use this skill to create a complete Xiaohongshu comic-learning episode from a Chinese K12 textbook chapter, especially 人教版初中生物. The workflow must be file-backed: every stage has explicit inputs, outputs, paths, and validation.

Always Load First

Read these references before creating or updating an episode:

1. references/paths-and-variables.md - canonical local paths and variables.
2. references/workflow-io.md - 12-step workflow with inputs/outputs.
3. references/episode-artifact-schema.md - required files and fields.

When generating images, also load:

• references/image-and-ip-rules.md
• /Users/Dario/.codex/skills/ian-xiaohei-illustrations/SKILL.md

When doing final QA, load:

• references/qa-checklist.md

Core Role Rules

• 小黑 is the student-side third-person narrator: a visible brain-commentary / 旁白员, not teacher, judge, main character, or mascot.
• The textbook is the source of truth. Do not invent curriculum facts.
• New knowledge must be life-based and serve the textbook concept. It should open one door, not become an encyclopedia.
• Every episode now defaults to one information-rich single-image comic: textbook anchor, life hook, story conflict, Xiaohei narrator action, core concept diagram, self-test, new-knowledge tease, and unresolved hook must fit into one image unless the user explicitly asks for a carousel.

Mandatory Workflow

1. Resolve variables and create/confirm episode folders.
2. Read the textbook source and prior reading notes.
3. Extract chapter scope, student pain points, and visualizable concepts.
4. Create/update the episode process index.
5. Draft the episode bible.
6. Draft the single-image comic script: 6-8 panels inside one image.
7. Build the one-image information architecture: title hook, story conflict, textbook concept, core visual, self-test, and next hook.
8. Generate one complete single-image comic draft with imagen / image_gen. Do not use SVG or local drawing scripts for the final visual.
9. QA the single image for knowledge completeness, reading order, Xiaohei role, and Chinese legibility.
10. Write final Xiaohongshu publish copy.
11. Run QA against references and source files.
12. Archive rejected versions and write a short episode retrospective.

Carousel images are a special-case fallback only when the user explicitly asks for multiple images.

Output Discipline

Store all process files under the episode folder, not scattered in generic scratch folders. Use Obsidian paths from paths-and-variables.md. Keep old drafts as process history unless the user explicitly asks to delete them.

Interaction Gates

Do not generate the final single image before the user approves the episode bible and single-image direction, unless the user explicitly asks to proceed. For each episode, ask for review at these gates:

• Gate A: episode bible and single-image scope.
• Gate B: single-image comic script and panel architecture.
• Gate C: one complete single-image draft.
• Gate D: final publish package.

Optional Script

Use scripts/init_episode.sh to create the standard Obsidian folders and starter process index when beginning a new episode.