不要把 LlamaGen API token 放在這個資料夾中。請將它保存在環境變數或受保護的密鑰儲存中。
第 1 步：寫一份製作簡報，而不是激勵段落
使用精簡的 lesson.md：
# U14 basketball communication comic
Audience: players ages 13-16
Learning goal: show that clear calls, teammate support, and respectful reflection
make practice safer and easier to follow.
Approved beats:
1. Jordan checks tied shoes and joins the warm-up.
2. Jordan raises a hand and calls before the pass.
3. Jordan receives the basketball in control.
4. Jordan helps a teammate stand after a normal loss of balance.
5. The adult coach leads a calm recap.
6. The team names one communication habit to repeat.
Guardrails:
- supervised indoor practice
- no diagnosis or medical instruction
- no real school or team marks
- no humiliation, punishment, or unsafe contact
- final output requires adult review
這樣的內容對視覺規劃來說已經足夠具體，同時也把在地規則交還給實際組織處理。
第 2 步：鎖定重複出現的球員角色
角色紀錄只應描述會影響畫面的事實：
# Jordan continuity record
Age: 15
Hair: short dark curls with a clean tapered side
Uniform: plain navy practice jersey and shorts, no team logo
Anchor prop: coral wristband on the left wrist
Shoes: white high-top basketball shoes
Body language: attentive, cooperative, never aggressive
Continuity rules:
- preserve age, face, hair, jersey color, wristband side, and shoes
- use a basketball, never a soccer ball
- keep the adult coach visually distinct from players
export LLAMAGEN_API_TOKEN="<YOUR_LLAMA_GEN_API_TOKEN>"
claude mcp add --scope user --transport http \
--header 'Authorization: Bearer ${LLAMAGEN_API_TOKEN}' \
llamagen https://llamagen.ai/api/mcp
在任何生成之前，先請 Claude Code 列出 LlamaGen 工具。如果沒有出現四個主要工具，請停止並修正端點、環境變數或授權標頭。絕對不要把 token 貼進故事檔案、截圖、提示詞或公開 URL。
第 4 步：讓 Claude Code 先規劃，再花點數
使用這個專案提示詞：
Read lesson.md, cast.md, style.md, and review-checklist.md.
1. Search the current LlamaGen Comic MCP documentation.
2. Check LlamaGen Comic API usage and report it separately from Claude usage.
3. Build scene-plan.json for one six-panel landscape comic.
4. For every panel include camera distance, action, emotion, background,
continuity anchors, and the teaching purpose.
5. Flag any unsafe, medical, or policy-sensitive statement.
6. Show me the plan and wait for explicit approval.
7. Do not call create_comic_generation until I approve.
這個核准關卡很重要。它讓教練或傳播負責人可以在使用生成點數之前先修正課程內容。
第 5 步：驗證 scene-plan.json
一份有用的計畫，應該具體到足以審核：
{
"audience": "ages 13-16",
"panelCount": 6,
"readingOrder": "left-to-right",
"panels": [
{
"panel": 1,
"camera": "medium-wide",
"action": "Jordan checks tied shoes, then joins the warm-up line",
"continuity": ["navy jersey", "coral left wristband", "white shoes"],
"teachingPurpose": "pre-practice preparation"
},
{
"panel": 4,
"camera": "medium",
"action": "Jordan offers a hand to a teammate after a normal loss of balance",
"continuity": ["same Jordan", "basketball visible", "coach supervising"],
"teachingPurpose": "teammate support"
}
]
}
Create one replacement comic panel for panel 4.
Jordan is the same 15-year-old athlete from the approved reference: short dark curls,
plain navy practice jersey, coral wristband on the left wrist, white high-top shoes.
Jordan offers a hand to a teammate after a normal loss of balance.
Keep the same medium camera angle, indoor gym, basketball, pose direction,
adult supervision, bright educational graphic-novel style, and no readable text.
