mindforge-cc 11.5.1 → 11.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/.agent/mindforge/skill-tdd.md +53 -0
  2. package/.agent/mindforge/skills-index.md +118 -0
  3. package/.agent/mindforge/systematic-debug.md +60 -0
  4. package/.agent/mindforge/wf-catalog.md +37 -0
  5. package/.agent/mindforge/wf-code-audit.md +31 -0
  6. package/.agent/mindforge/wf-competitive-analysis.md +31 -0
  7. package/.agent/mindforge/wf-deep-research.md +32 -0
  8. package/.agent/mindforge/wf-feature-planner.md +31 -0
  9. package/.agent/mindforge/wf-incident-response.md +31 -0
  10. package/.agent/mindforge/wf-onboard-codebase.md +31 -0
  11. package/.agent/mindforge/wf-perf-optimize.md +31 -0
  12. package/.agent/mindforge/wf-pr-review.md +31 -0
  13. package/.agent/mindforge/wf-refactor-plan.md +31 -0
  14. package/.agent/mindforge/wf-release-prep.md +31 -0
  15. package/.agent/mindforge/wf-tdd-sprint.md +31 -0
  16. package/.agent/mindforge/wf-tech-evaluation.md +31 -0
  17. package/.agent/skills/1password-skill/SKILL.md +156 -0
  18. package/.agent/skills/1password-skill/references/cli-examples.md +31 -0
  19. package/.agent/skills/1password-skill/references/get-started.md +21 -0
  20. package/.agent/skills/article-illustrator/SKILL.md +199 -0
  21. package/.agent/skills/article-illustrator/references/prompt-construction.md +426 -0
  22. package/.agent/skills/article-illustrator/references/style-presets.md +80 -0
  23. package/.agent/skills/article-illustrator/references/styles.md +224 -0
  24. package/.agent/skills/article-illustrator/references/usage.md +50 -0
  25. package/.agent/skills/article-illustrator/references/workflow.md +332 -0
  26. package/.agent/skills/arxiv/SKILL.md +275 -0
  27. package/.agent/skills/blogwatcher/SKILL.md +130 -0
  28. package/.agent/skills/code-wiki/SKILL.md +438 -0
  29. package/.agent/skills/code-wiki/templates/README.md +31 -0
  30. package/.agent/skills/code-wiki/templates/architecture.md +30 -0
  31. package/.agent/skills/code-wiki/templates/getting-started.md +47 -0
  32. package/.agent/skills/code-wiki/templates/module.md +38 -0
  33. package/.agent/skills/codebase-inspection/SKILL.md +109 -0
  34. package/.agent/skills/comic-creator/SKILL.md +240 -0
  35. package/.agent/skills/comic-creator/references/analysis-framework.md +176 -0
  36. package/.agent/skills/comic-creator/references/auto-selection.md +71 -0
  37. package/.agent/skills/comic-creator/references/base-prompt.md +98 -0
  38. package/.agent/skills/comic-creator/references/character-template.md +180 -0
  39. package/.agent/skills/comic-creator/references/ohmsha-guide.md +85 -0
  40. package/.agent/skills/comic-creator/references/partial-workflows.md +106 -0
  41. package/.agent/skills/comic-creator/references/storyboard-template.md +143 -0
  42. package/.agent/skills/comic-creator/references/workflow.md +401 -0
  43. package/.agent/skills/concept-diagrams/SKILL.md +355 -0
  44. package/.agent/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
  45. package/.agent/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
  46. package/.agent/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
  47. package/.agent/skills/creative-ideation/SKILL.md +144 -0
  48. package/.agent/skills/creative-ideation/references/full-prompt-library.md +110 -0
  49. package/.agent/skills/devops-cli/SKILL.md +149 -0
  50. package/.agent/skills/devops-cli/references/app-discovery.md +112 -0
  51. package/.agent/skills/devops-cli/references/authentication.md +59 -0
  52. package/.agent/skills/devops-cli/references/cli-reference.md +104 -0
  53. package/.agent/skills/devops-cli/references/running-apps.md +171 -0
  54. package/.agent/skills/devops-watchers/SKILL.md +103 -0
  55. package/.agent/skills/docker-management/SKILL.md +273 -0
  56. package/.agent/skills/domain-intel/SKILL.md +96 -0
  57. package/.agent/skills/duckduckgo-search/SKILL.md +230 -0
  58. package/.agent/skills/github-auth/SKILL.md +240 -0
  59. package/.agent/skills/github-code-review/SKILL.md +474 -0
  60. package/.agent/skills/github-code-review/references/review-output-template.md +74 -0
  61. package/.agent/skills/github-issues/SKILL.md +363 -0
  62. package/.agent/skills/github-issues/templates/bug-report.md +35 -0
  63. package/.agent/skills/github-issues/templates/feature-request.md +31 -0
  64. package/.agent/skills/github-pr-workflow/SKILL.md +360 -0
  65. package/.agent/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
  66. package/.agent/skills/github-pr-workflow/references/conventional-commits.md +71 -0
  67. package/.agent/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
  68. package/.agent/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
  69. package/.agent/skills/github-repo-management/SKILL.md +509 -0
  70. package/.agent/skills/github-repo-management/references/github-api-cheatsheet.md +161 -0
  71. package/.agent/skills/godmode/SKILL.md +396 -0
  72. package/.agent/skills/godmode/references/jailbreak-templates.md +128 -0
  73. package/.agent/skills/godmode/references/refusal-detection.md +142 -0
  74. package/.agent/skills/hyperframes/SKILL.md +182 -0
  75. package/.agent/skills/hyperframes/references/cli.md +185 -0
  76. package/.agent/skills/hyperframes/references/composition.md +129 -0
  77. package/.agent/skills/hyperframes/references/features.md +289 -0
  78. package/.agent/skills/hyperframes/references/gsap.md +136 -0
  79. package/.agent/skills/hyperframes/references/troubleshooting.md +137 -0
  80. package/.agent/skills/hyperframes/references/website-to-video.md +145 -0
  81. package/.agent/skills/jupyter-live-kernel/SKILL.md +160 -0
  82. package/.agent/skills/kanban-orchestrator/SKILL.md +209 -0
  83. package/.agent/skills/kanban-worker/SKILL.md +188 -0
  84. package/.agent/skills/llm-wiki/SKILL.md +499 -0
  85. package/.agent/skills/meme-generation/SKILL.md +122 -0
  86. package/.agent/skills/node-inspect-debugger/SKILL.md +312 -0
  87. package/.agent/skills/obsidian/SKILL.md +60 -0
  88. package/.agent/skills/osint-investigation/SKILL.md +269 -0
  89. package/.agent/skills/osint-investigation/templates/source-template.md +59 -0
  90. package/.agent/skills/oss-forensics/SKILL.md +422 -0
  91. package/.agent/skills/oss-forensics/references/evidence-types.md +89 -0
  92. package/.agent/skills/oss-forensics/references/github-archive-guide.md +184 -0
  93. package/.agent/skills/oss-forensics/references/investigation-templates.md +131 -0
  94. package/.agent/skills/oss-forensics/references/recovery-techniques.md +164 -0
  95. package/.agent/skills/oss-forensics/templates/forensic-report.md +151 -0
  96. package/.agent/skills/oss-forensics/templates/malicious-package-report.md +43 -0
  97. package/.agent/skills/parallel-cli/SKILL.md +384 -0
  98. package/.agent/skills/pinggy-tunnel/SKILL.md +302 -0
  99. package/.agent/skills/pixel-art/SKILL.md +209 -0
  100. package/.agent/skills/pixel-art/references/palettes.md +49 -0
  101. package/.agent/skills/plan/SKILL.md +331 -0
  102. package/.agent/skills/polymarket/SKILL.md +75 -0
  103. package/.agent/skills/polymarket/references/api-endpoints.md +220 -0
  104. package/.agent/skills/python-debugpy/SKILL.md +368 -0
  105. package/.agent/skills/requesting-code-review/SKILL.md +273 -0
  106. package/.agent/skills/research-paper-writing/SKILL.md +2367 -0
  107. package/.agent/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
  108. package/.agent/skills/research-paper-writing/references/checklists.md +434 -0
  109. package/.agent/skills/research-paper-writing/references/citation-workflow.md +563 -0
  110. package/.agent/skills/research-paper-writing/references/experiment-patterns.md +728 -0
  111. package/.agent/skills/research-paper-writing/references/human-evaluation.md +476 -0
  112. package/.agent/skills/research-paper-writing/references/paper-types.md +481 -0
  113. package/.agent/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
  114. package/.agent/skills/research-paper-writing/references/sources.md +191 -0
  115. package/.agent/skills/research-paper-writing/references/writing-guide.md +474 -0
  116. package/.agent/skills/research-paper-writing/templates/README.md +251 -0
  117. package/.agent/skills/rest-graphql-debug/SKILL.md +507 -0
  118. package/.agent/skills/s6-container-supervision/SKILL.md +171 -0
  119. package/.agent/skills/scrapling/SKILL.md +328 -0
  120. package/.agent/skills/sherlock/SKILL.md +186 -0
  121. package/.agent/skills/simplify-code/SKILL.md +168 -0
  122. package/.agent/skills/skill-authoring/SKILL.md +158 -0
  123. package/.agent/skills/spike/SKILL.md +190 -0
  124. package/.agent/skills/subagent-driven-development/SKILL.md +345 -0
  125. package/.agent/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
  126. package/.agent/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
  127. package/.agent/skills/systematic-debugging/SKILL.md +360 -0
  128. package/.agent/skills/test-driven-development/SKILL.md +336 -0
  129. package/.agent/skills/video-orchestrator/SKILL.md +194 -0
  130. package/.agent/skills/video-orchestrator/references/examples.md +227 -0
  131. package/.agent/skills/video-orchestrator/references/intake.md +166 -0
  132. package/.agent/skills/video-orchestrator/references/kanban-setup.md +278 -0
  133. package/.agent/skills/video-orchestrator/references/monitoring.md +180 -0
  134. package/.agent/skills/video-orchestrator/references/role-archetypes.md +298 -0
  135. package/.agent/skills/video-orchestrator/references/tool-matrix.md +317 -0
  136. package/.agent/skills/web-pentest/SKILL.md +332 -0
  137. package/.agent/skills/web-pentest/references/bypass-techniques.md +133 -0
  138. package/.agent/skills/web-pentest/references/exploitation-techniques.md +204 -0
  139. package/.agent/skills/web-pentest/references/scope-enforcement.md +110 -0
  140. package/.agent/skills/web-pentest/references/vuln-taxonomy.md +81 -0
  141. package/.agent/skills/web-pentest/templates/authorization.md +69 -0
  142. package/.agent/skills/web-pentest/templates/pentest-report.md +178 -0
  143. package/.claude/commands/mindforge/skill-tdd.md +53 -0
  144. package/.claude/commands/mindforge/skills-index.md +118 -0
  145. package/.claude/commands/mindforge/systematic-debug.md +60 -0
  146. package/.claude/commands/mindforge/wf-catalog.md +37 -0
  147. package/.claude/commands/mindforge/wf-code-audit.md +31 -0
  148. package/.claude/commands/mindforge/wf-competitive-analysis.md +31 -0
  149. package/.claude/commands/mindforge/wf-deep-research.md +32 -0
  150. package/.claude/commands/mindforge/wf-feature-planner.md +31 -0
  151. package/.claude/commands/mindforge/wf-incident-response.md +31 -0
  152. package/.claude/commands/mindforge/wf-onboard-codebase.md +31 -0
  153. package/.claude/commands/mindforge/wf-perf-optimize.md +31 -0
  154. package/.claude/commands/mindforge/wf-pr-review.md +31 -0
  155. package/.claude/commands/mindforge/wf-refactor-plan.md +31 -0
  156. package/.claude/commands/mindforge/wf-release-prep.md +31 -0
  157. package/.claude/commands/mindforge/wf-tdd-sprint.md +31 -0
  158. package/.claude/commands/mindforge/wf-tech-evaluation.md +31 -0
  159. package/.mindforge/config.json +2 -2
  160. package/.mindforge/dynamic-workflows/REGISTRY.md +65 -0
  161. package/.mindforge/dynamic-workflows/index.json +171 -0
  162. package/.mindforge/dynamic-workflows/scripts/code-audit.js +103 -0
  163. package/.mindforge/dynamic-workflows/scripts/competitive-analysis.js +85 -0
  164. package/.mindforge/dynamic-workflows/scripts/deep-research.js +151 -0
  165. package/.mindforge/dynamic-workflows/scripts/feature-planner.js +104 -0
  166. package/.mindforge/dynamic-workflows/scripts/incident-response.js +106 -0
  167. package/.mindforge/dynamic-workflows/scripts/onboard-codebase.js +102 -0
  168. package/.mindforge/dynamic-workflows/scripts/perf-optimize.js +128 -0
  169. package/.mindforge/dynamic-workflows/scripts/pr-review.js +87 -0
  170. package/.mindforge/dynamic-workflows/scripts/refactor-plan.js +121 -0
  171. package/.mindforge/dynamic-workflows/scripts/release-prep.js +102 -0
  172. package/.mindforge/dynamic-workflows/scripts/tdd-sprint.js +103 -0
  173. package/.mindforge/dynamic-workflows/scripts/tech-evaluation.js +72 -0
  174. package/.mindforge/memory/sync-manifest.json +1 -1
  175. package/.mindforge/skills/arxiv/SKILL.md +294 -0
  176. package/.mindforge/skills/blogwatcher/SKILL.md +147 -0
  177. package/.mindforge/skills/code-wiki/SKILL.md +457 -0
  178. package/.mindforge/skills/codebase-inspection/SKILL.md +126 -0
  179. package/.mindforge/skills/concept-diagrams/SKILL.md +373 -0
  180. package/.mindforge/skills/creative-ideation/SKILL.md +162 -0
  181. package/.mindforge/skills/domain-intel/SKILL.md +116 -0
  182. package/.mindforge/skills/duckduckgo-search/SKILL.md +249 -0
  183. package/.mindforge/skills/github-code-review/SKILL.md +493 -0
  184. package/.mindforge/skills/github-issues/SKILL.md +382 -0
  185. package/.mindforge/skills/github-pr-workflow/SKILL.md +379 -0
  186. package/.mindforge/skills/jupyter-live-kernel/SKILL.md +179 -0
  187. package/.mindforge/skills/kanban-orchestrator/SKILL.md +227 -0
  188. package/.mindforge/skills/kanban-worker/SKILL.md +206 -0
  189. package/.mindforge/skills/meme-generation/SKILL.md +141 -0
  190. package/.mindforge/skills/obsidian/SKILL.md +80 -0
  191. package/.mindforge/skills/osint-investigation/SKILL.md +288 -0
  192. package/.mindforge/skills/oss-forensics/SKILL.md +421 -0
  193. package/.mindforge/skills/pixel-art/SKILL.md +228 -0
  194. package/.mindforge/skills/plan/SKILL.md +350 -0
  195. package/.mindforge/skills/requesting-code-review/SKILL.md +292 -0
  196. package/.mindforge/skills/research-paper-writing/SKILL.md +2384 -0
  197. package/.mindforge/skills/scrapling/SKILL.md +345 -0
  198. package/.mindforge/skills/sherlock/SKILL.md +203 -0
  199. package/.mindforge/skills/simplify-code/SKILL.md +187 -0
  200. package/.mindforge/skills/spike/SKILL.md +209 -0
  201. package/.mindforge/skills/subagent-driven-development/SKILL.md +364 -0
  202. package/.mindforge/skills/systematic-debugging/SKILL.md +379 -0
  203. package/.mindforge/skills/test-driven-development/SKILL.md +355 -0
  204. package/.mindforge/skills/web-pentest/SKILL.md +327 -0
  205. package/CHANGELOG.md +71 -0
  206. package/MINDFORGE.md +2 -2
  207. package/README.md +72 -3
  208. package/RELEASENOTES.md +109 -0
  209. package/bin/installer-core.js +6 -2
  210. package/bin/mindforge-cli.js +7 -0
  211. package/bin/workflows/workflow-runner.js +110 -0
  212. package/docs/commands-reference.md +25 -0
  213. package/docs/getting-started.md +42 -5
  214. package/package.json +2 -1
@@ -0,0 +1,240 @@
1
+ ---
2
+ name: baoyu-comic
3
+ description: "Knowledge comics (知识漫画): educational, biography, tutorial."
4
+ version: 1.56.1
5
+ ---
6
+
7
+ # Knowledge Comic Creator
8
+
9
+ Adapted from [baoyu-comic](https://github.com/JimLiu/baoyu-skills) for
10
+
11
+ Create original knowledge comics with flexible art style × tone combinations.
12
+
13
+ ## When to Use
14
+
15
+ Trigger this skill when the user asks to create a knowledge/educational comic, biography comic, tutorial comic, or uses terms like "知识漫画", "教育漫画", or "Logicomix-style". The user provides content (text, file path, URL, or topic) and optionally specifies art style, tone, layout, aspect ratio, or language.
16
+
17
+ ## Reference Images
18
+
19
+ the agent' `image_generate` tool is **prompt-only** — it accepts a text prompt and an aspect ratio, and returns an image URL. It does **NOT** accept reference images. When the user supplies a reference image, use it to **extract traits in text** that get embedded in every page prompt:
20
+
21
+ **Intake**: Accept file paths when the user provides them (or pastes images in conversation).
22
+ - File path(s) → copy to `refs/NN-ref-{slug}.{ext}` alongside the comic output for provenance
23
+ - Pasted image with no path → ask the user for the path via `clarify`, or extract style traits verbally as a text fallback
24
+ - No reference → skip this section
25
+
26
+ **Usage modes** (per reference):
27
+
28
+ | Usage | Effect |
29
+ |-------|--------|
30
+ | `style` | Extract style traits (line treatment, texture, mood) and append to every page's prompt body |
31
+ | `palette` | Extract hex colors and append to every page's prompt body |
32
+ | `scene` | Extract scene composition or subject notes and append to the relevant page(s) |
33
+
34
+ **Record in each page's prompt frontmatter** when refs exist:
35
+
36
+ ```yaml
37
+ references:
38
+ - ref_id: 01
39
+ filename: 01-ref-scene.png
40
+ usage: style
41
+ traits: "muted earth tones, soft-edged ink wash, low-contrast backgrounds"
42
+ ```
43
+
44
+ Character consistency is driven by **text descriptions** in `characters/characters.md` (written in Step 3) that get embedded inline in every page prompt (Step 5). The optional PNG character sheet generated in Step 7.1 is a human-facing review artifact, not an input to `image_generate`.
45
+
46
+ ## Options
47
+
48
+ ### Visual Dimensions
49
+
50
+ | Option | Values | Description |
51
+ |--------|--------|-------------|
52
+ | Art | ligne-claire (default), manga, realistic, ink-brush, chalk, minimalist | Art style / rendering technique |
53
+ | Tone | neutral (default), warm, dramatic, romantic, energetic, vintage, action | Mood / atmosphere |
54
+ | Layout | standard (default), cinematic, dense, splash, mixed, webtoon, four-panel | Panel arrangement |
55
+ | Aspect | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen) | Page aspect ratio |
56
+ | Language | auto (default), zh, en, ja, etc. | Output language |
57
+ | Refs | File paths | Reference images used for style / palette trait extraction (not passed to the image model). See [Reference Images](#reference-images) above. |
58
+
59
+ ### Partial Workflow Options
60
+
61
+ | Option | Description |
62
+ |--------|-------------|
63
+ | Storyboard only | Generate storyboard only, skip prompts and images |
64
+ | Prompts only | Generate storyboard + prompts, skip images |
65
+ | Images only | Generate images from existing prompts directory |
66
+ | Regenerate N | Regenerate specific page(s) only (e.g., `3` or `2,5,8`) |
67
+
68
+ Details: [references/partial-workflows.md](references/partial-workflows.md)
69
+
70
+ ### Art, Tone & Preset Catalogue
71
+
72
+ - **Art styles** (6): `ligne-claire`, `manga`, `realistic`, `ink-brush`, `chalk`, `minimalist`. Full definitions at `references/art-styles/<style>.md`.
73
+ - **Tones** (7): `neutral`, `warm`, `dramatic`, `romantic`, `energetic`, `vintage`, `action`. Full definitions at `references/tones/<tone>.md`.
74
+ - **Presets** (5) with special rules beyond plain art+tone:
75
+
76
+ | Preset | Equivalent | Hook |
77
+ |--------|-----------|------|
78
+ | `ohmsha` | manga + neutral | Visual metaphors, no talking heads, gadget reveals |
79
+ | `wuxia` | ink-brush + action | Qi effects, combat visuals, atmospheric |
80
+ | `shoujo` | manga + romantic | Decorative elements, eye details, romantic beats |
81
+ | `concept-story` | manga + warm | Visual symbol system, growth arc, dialogue+action balance |
82
+ | `four-panel` | minimalist + neutral + four-panel layout | 起承转合 structure, B&W + spot color, stick-figure characters |
83
+
84
+ Full rules at `references/presets/<preset>.md` — load the file when a preset is picked.
85
+
86
+ - **Compatibility matrix** and **content-signal → preset** table live in [references/auto-selection.md](references/auto-selection.md). Read it before recommending combinations in Step 2.
87
+
88
+ ## File Structure
89
+
90
+ Output directory: `comic/{topic-slug}/`
91
+ - Slug: 2-4 words kebab-case from topic (e.g., `alan-turing-bio`)
92
+ - Conflict: append timestamp (e.g., `turing-story-20260118-143052`)
93
+
94
+ **Contents**:
95
+ | File | Description |
96
+ |------|-------------|
97
+ | `source-{slug}.md` | Saved source content (kebab-case slug matches the output directory) |
98
+ | `analysis.md` | Content analysis |
99
+ | `storyboard.md` | Storyboard with panel breakdown |
100
+ | `characters/characters.md` | Character definitions |
101
+ | `characters/characters.png` | Character reference sheet (downloaded from `image_generate`) |
102
+ | `prompts/NN-{cover\|page}-[slug].md` | Generation prompts |
103
+ | `NN-{cover\|page}-[slug].png` | Generated images (downloaded from `image_generate`) |
104
+ | `refs/NN-ref-{slug}.{ext}` | User-supplied reference images (optional, for provenance) |
105
+
106
+ ## Language Handling
107
+
108
+ **Detection Priority**:
109
+ 1. User-specified language (explicit option)
110
+ 2. User's conversation language
111
+ 3. Source content language
112
+
113
+ **Rule**: Use user's input language for ALL interactions:
114
+ - Storyboard outlines and scene descriptions
115
+ - Image generation prompts
116
+ - User selection options and confirmations
117
+ - Progress updates, questions, errors, summaries
118
+
119
+ Technical terms remain in English.
120
+
121
+ ## Workflow
122
+
123
+ ### Progress Checklist
124
+
125
+ ```
126
+ Comic Progress:
127
+ - [ ] Step 1: Setup & Analyze
128
+ - [ ] 1.1 Analyze content
129
+ - [ ] 1.2 Check existing directory
130
+ - [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
131
+ - [ ] Step 3: Generate storyboard + characters
132
+ - [ ] Step 4: Review outline (conditional)
133
+ - [ ] Step 5: Generate prompts
134
+ - [ ] Step 6: Review prompts (conditional)
135
+ - [ ] Step 7: Generate images
136
+ - [ ] 7.1 Generate character sheet (if needed) → characters/characters.png
137
+ - [ ] 7.2 Generate pages (with character descriptions embedded in prompt)
138
+ - [ ] Step 8: Completion report
139
+ ```
140
+
141
+ ### Flow
142
+
143
+ ```
144
+ Input → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → Complete
145
+ ```
146
+
147
+ ### Step Summary
148
+
149
+ | Step | Action | Key Output |
150
+ |------|--------|------------|
151
+ | 1.1 | Analyze content | `analysis.md`, `source-{slug}.md` |
152
+ | 1.2 | Check existing directory | Handle conflicts |
153
+ | 2 | Confirm style, focus, audience, reviews | User preferences |
154
+ | 3 | Generate storyboard + characters | `storyboard.md`, `characters/` |
155
+ | 4 | Review outline (if requested) | User approval |
156
+ | 5 | Generate prompts | `prompts/*.md` |
157
+ | 6 | Review prompts (if requested) | User approval |
158
+ | 7.1 | Generate character sheet (if needed) | `characters/characters.png` |
159
+ | 7.2 | Generate pages | `*.png` files |
160
+ | 8 | Completion report | Summary |
161
+
162
+ ### User Questions
163
+
164
+ Use the `clarify` tool to confirm options. Since `clarify` handles one question at a time, ask the most important question first and proceed sequentially. See [references/workflow.md](references/workflow.md) for the full Step 2 question set.
165
+
166
+ **Timeout handling (CRITICAL)**: `clarify` can return `"The user did not provide a response within the time limit. Use your best judgement to make the choice and proceed."` — this is NOT user consent to default everything.
167
+
168
+ - Treat it as a default **for that one question only**. Continue asking the remaining Step 2 questions in sequence; each question is an independent consent point.
169
+ - **Surface the default to the user visibly** in your next message so they have a chance to correct it: e.g. `"Style: defaulted to ohmsha preset (clarify timed out). Say the word to switch."` — an unreported default is indistinguishable from never having asked.
170
+ - Do NOT collapse Step 2 into a single "use all defaults" pass after one timeout. If the user is genuinely absent, they will be equally absent for all five questions — but they can correct visible defaults when they return, and cannot correct invisible ones.
171
+
172
+ ### Step 7: Image Generation
173
+
174
+ Use the agent' built-in `image_generate` tool for all image rendering. Its schema accepts only `prompt` and `aspect_ratio` (`landscape` | `portrait` | `square`); it **returns a URL**, not a local file. Every generated page or character sheet must therefore be downloaded to the output directory.
175
+
176
+ **Prompt file requirement (hard)**: write each image's full, final prompt to a standalone file under `prompts/` (naming: `NN-{type}-[slug].md`) BEFORE calling `image_generate`. The prompt file is the reproducibility record.
177
+
178
+ **Aspect ratio mapping** — the storyboard's `aspect_ratio` field maps to `image_generate`'s format as follows:
179
+
180
+ | Storyboard ratio | `image_generate` format |
181
+ |------------------|-------------------------|
182
+ | `3:4`, `9:16`, `2:3` | `portrait` |
183
+ | `4:3`, `16:9`, `3:2` | `landscape` |
184
+ | `1:1` | `square` |
185
+
186
+ **Download step** — after every `image_generate` call:
187
+ 1. Read the URL from the tool result
188
+ 2. Fetch the image bytes using an **absolute** output path, e.g.
189
+ `curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png`
190
+ 3. Verify the file exists and is non-empty at that exact path before proceeding to the next page
191
+
192
+ **Never rely on shell CWD persistence for `-o` paths.** The terminal tool's persistent-shell CWD can change between batches (session expiry, `TERMINAL_LIFETIME_SECONDS`, a failed `cd` that leaves you in the wrong directory). `curl -o relative/path.png` is a silent footgun: if CWD has drifted, the file lands somewhere else with no error. **Always pass a fully-qualified absolute path to `-o`**, or pass `workdir=<abs path>` to the terminal tool. Incident Apr 2026: pages 06-09 of a 10-page comic landed at the repo root instead of `comic/<slug>/` because batch 3 inherited a stale CWD from batch 2 and `curl -o 06-page-skills.png` wrote to the wrong directory. The agent then spent several turns claiming the files existed where they didn't.
193
+
194
+ **7.1 Character sheet** — generate it (to `characters/characters.png`, aspect `landscape`) when the comic is multi-page with recurring characters. Skip for simple presets (e.g., four-panel minimalist) or single-page comics. The prompt file at `characters/characters.md` must exist before invoking `image_generate`. The rendered PNG is a **human-facing review artifact** (so the user can visually verify character design) and a reference for later regenerations or manual prompt edits — it does **not** drive Step 7.2. Page prompts are already written in Step 5 from the **text descriptions** in `characters/characters.md`; `image_generate` cannot accept images as visual input.
195
+
196
+ **7.2 Pages** — each page's prompt MUST already be at `prompts/NN-{cover|page}-[slug].md` before invoking `image_generate`. Because `image_generate` is prompt-only, character consistency is enforced by **embedding character descriptions (sourced from `characters/characters.md`) inline in every page prompt during Step 5**. The embedding is done uniformly whether or not a PNG sheet is produced in 7.1; the PNG is only a review/regeneration aid.
197
+
198
+ **Backup rule**: existing `prompts/…md` and `…png` files → rename with `-backup-YYYYMMDD-HHMMSS` suffix before regenerating.
199
+
200
+ Full step-by-step workflow (analysis, storyboard, review gates, regeneration variants): [references/workflow.md](references/workflow.md).
201
+
202
+ ## References
203
+
204
+ **Core Templates**:
205
+ - [analysis-framework.md](references/analysis-framework.md) - Deep content analysis
206
+ - [character-template.md](references/character-template.md) - Character definition format
207
+ - [storyboard-template.md](references/storyboard-template.md) - Storyboard structure
208
+ - [ohmsha-guide.md](references/ohmsha-guide.md) - Ohmsha manga specifics
209
+
210
+ **Style Definitions**:
211
+ - `references/art-styles/` - Art styles (ligne-claire, manga, realistic, ink-brush, chalk, minimalist)
212
+ - `references/tones/` - Tones (neutral, warm, dramatic, romantic, energetic, vintage, action)
213
+ - `references/presets/` - Presets with special rules (ohmsha, wuxia, shoujo, concept-story, four-panel)
214
+ - `references/layouts/` - Layouts (standard, cinematic, dense, splash, mixed, webtoon, four-panel)
215
+
216
+ **Workflow**:
217
+ - [workflow.md](references/workflow.md) - Full workflow details
218
+ - [auto-selection.md](references/auto-selection.md) - Content signal analysis
219
+ - [partial-workflows.md](references/partial-workflows.md) - Partial workflow options
220
+
221
+ ## Page Modification
222
+
223
+ | Action | Steps |
224
+ |--------|-------|
225
+ | **Edit** | **Update prompt file FIRST** → regenerate image → download new PNG |
226
+ | **Add** | Create prompt at position → generate with character descriptions embedded → renumber subsequent → update storyboard |
227
+ | **Delete** | Remove files → renumber subsequent → update storyboard |
228
+
229
+ **IMPORTANT**: When updating pages, ALWAYS update the prompt file (`prompts/NN-{cover|page}-[slug].md`) FIRST before regenerating. This ensures changes are documented and reproducible.
230
+
231
+ ## Pitfalls
232
+
233
+ - Image generation: 10-30 seconds per page; auto-retry once on failure
234
+ - **Always download** the URL returned by `image_generate` to a local PNG — downstream tooling (and the user's review) expects files in the output directory, not ephemeral URLs
235
+ - **Use absolute paths for `curl -o`** — never rely on persistent-shell CWD across batches. Silent footgun: files land in the wrong directory and subsequent `ls` on the intended path shows nothing. See Step 7 "Download step".
236
+ - Use stylized alternatives for sensitive public figures
237
+ - **Step 2 confirmation required** - do not skip
238
+ - **Steps 4/6 conditional** - only if user requested in Step 2
239
+ - **Step 7.1 character sheet** - recommended for multi-page comics, optional for simple presets. The PNG is a review/regeneration aid; page prompts (written in Step 5) use the text descriptions in `characters/characters.md`, not the PNG. `image_generate` does not accept images as visual input
240
+ - **Strip secrets** — scan source content for API keys, tokens, or credentials before writing any output file
@@ -0,0 +1,176 @@
1
+ # Comic Content Analysis Framework
2
+
3
+ Deep analysis framework for transforming source content into effective visual storytelling.
4
+
5
+ ## Purpose
6
+
7
+ Before creating a comic, thoroughly analyze the source material to:
8
+ - Identify the target audience and their needs
9
+ - Determine what value the comic will deliver
10
+ - Extract narrative potential for visual storytelling
11
+ - Plan character arcs and key moments
12
+
13
+ ## Analysis Dimensions
14
+
15
+ ### 1. Core Content (Understanding "What")
16
+
17
+ **Central Message**
18
+ - What is the single most important idea readers should take away?
19
+ - Can you express it in one sentence?
20
+
21
+ **Key Concepts**
22
+ - What are the essential concepts readers must understand?
23
+ - How should these concepts be visualized?
24
+ - Which concepts need simplified explanations?
25
+
26
+ **Content Structure**
27
+ - How is the source material organized?
28
+ - What is the natural narrative arc?
29
+ - Where are the climax and turning points?
30
+
31
+ **Evidence & Examples**
32
+ - What concrete examples, data, or stories support the main ideas?
33
+ - Which examples translate well to visual panels?
34
+ - What can be shown rather than told?
35
+
36
+ ### 2. Context & Background (Understanding "Why")
37
+
38
+ **Source Origin**
39
+ - Who created this content? What is their perspective?
40
+ - What was the original purpose?
41
+ - Is there bias to be aware of?
42
+
43
+ **Historical/Cultural Context**
44
+ - When and where does the story take place?
45
+ - What background knowledge do readers need?
46
+ - What period-specific visual elements are required?
47
+
48
+ **Underlying Assumptions**
49
+ - What does the source assume readers already know?
50
+ - What implicit beliefs or values are present?
51
+ - Should the comic challenge or reinforce these?
52
+
53
+ ### 3. Audience Analysis
54
+
55
+ **Primary Audience**
56
+ - Who will read this comic?
57
+ - What is their existing knowledge level?
58
+ - What are their interests and motivations?
59
+
60
+ **Secondary Audiences**
61
+ - Who else might benefit from this comic?
62
+ - How might their needs differ?
63
+
64
+ **Reader Questions**
65
+ - What questions will readers have?
66
+ - What misconceptions might they bring?
67
+ - What "aha moments" can we create?
68
+
69
+ ### 4. Value Proposition
70
+
71
+ **Knowledge Value**
72
+ - What will readers learn?
73
+ - What new perspectives will they gain?
74
+ - How will this change their understanding?
75
+
76
+ **Emotional Value**
77
+ - What emotions should readers feel?
78
+ - What connections will they make with characters?
79
+ - What will make this memorable?
80
+
81
+ **Practical Value**
82
+ - Can readers apply what they learn?
83
+ - What actions might this inspire?
84
+ - What conversations might it spark?
85
+
86
+ ### 5. Narrative Potential
87
+
88
+ **Story Arc Candidates**
89
+ - What natural narratives exist in the content?
90
+ - Where is the conflict or tension?
91
+ - What transformations occur?
92
+
93
+ **Character Potential**
94
+ - Who are the key figures?
95
+ - What are their motivations and obstacles?
96
+ - How do they change throughout?
97
+
98
+ **Visual Opportunities**
99
+ - What scenes have strong visual potential?
100
+ - Where can abstract concepts become concrete images?
101
+ - What metaphors can be visualized?
102
+
103
+ **Dramatic Moments**
104
+ - What are the breakthrough/revelation moments?
105
+ - Where are the emotional peaks?
106
+ - What creates tension and release?
107
+
108
+ ### 6. Adaptation Considerations
109
+
110
+ **What to Keep**
111
+ - Essential facts and ideas
112
+ - Key quotes or moments
113
+ - Core emotional beats
114
+
115
+ **What to Simplify**
116
+ - Complex explanations
117
+ - Dense technical details
118
+ - Lengthy descriptions
119
+
120
+ **What to Expand**
121
+ - Brief mentions that deserve more attention
122
+ - Implied emotions or relationships
123
+ - Visual details not in source
124
+
125
+ **What to Omit**
126
+ - Tangential information
127
+ - Redundant examples
128
+ - Content that doesn't serve the narrative
129
+
130
+ ## Output Format
131
+
132
+ Analysis results should be saved to `analysis.md` with:
133
+
134
+ 1. **YAML Front Matter**: Metadata (title, topic, time_span, source_language, user_language, aspect_ratio, recommended_page_count, recommended_art, recommended_tone, recommended_layout)
135
+ 2. **Target Audience**: Primary, secondary, tertiary audiences with their needs
136
+ 3. **Value Proposition**: What readers will gain (knowledge, emotional, practical)
137
+ 4. **Core Themes**: Table with theme, narrative potential, visual opportunity
138
+ 5. **Key Figures & Story Arcs**: Character profiles with arcs, visual identity, key moments
139
+ 6. **Content Signals**: Style and layout recommendations based on content type
140
+ 7. **Recommended Approaches**: Narrative approaches ranked by suitability
141
+
142
+ ### YAML Front Matter Example
143
+
144
+ ```yaml
145
+ ---
146
+ title: "Alan Turing: The Father of Computing"
147
+ topic: alan-turing-biography
148
+ time_span: 1912-1954
149
+ source_language: en
150
+ user_language: zh # User-specified or detected from conversation
151
+ aspect_ratio: "3:4"
152
+ recommended_page_count: 16
153
+ recommended_art: ligne-claire # ligne-claire|manga|realistic|ink-brush|chalk
154
+ recommended_tone: neutral # neutral|warm|dramatic|romantic|energetic|vintage|action
155
+ recommended_layout: mixed # standard|cinematic|dense|splash|mixed|webtoon
156
+ ---
157
+ ```
158
+
159
+ ### Language Fields
160
+
161
+ | Field | Description |
162
+ |-------|-------------|
163
+ | `source_language` | Detected language of source content |
164
+ | `user_language` | Output language for comic (user-specified option > conversation language > source_language) |
165
+
166
+ ## Analysis Checklist
167
+
168
+ Before proceeding to storyboard:
169
+
170
+ - [ ] Can I state the core message in one sentence?
171
+ - [ ] Do I know exactly who will read this comic?
172
+ - [ ] Have I identified at least 3 ways this comic provides value?
173
+ - [ ] Are there clear protagonists with compelling arcs?
174
+ - [ ] Have I found at least 5 visually powerful moments?
175
+ - [ ] Do I understand what to keep, simplify, expand, and omit?
176
+ - [ ] Have I identified the emotional peaks and valleys?
@@ -0,0 +1,71 @@
1
+ # Auto Selection
2
+
3
+ Content signals determine default art + tone + layout (or preset).
4
+
5
+ ## Content Signal Matrix
6
+
7
+ | Content Signals | Art Style | Tone | Layout | Preset |
8
+ |-----------------|-----------|------|--------|--------|
9
+ | Tutorial, how-to, beginner | manga | neutral | webtoon | **ohmsha** |
10
+ | Computing, AI, programming | manga | neutral | dense | **ohmsha** |
11
+ | Technical explanation, educational | manga | neutral | webtoon | **ohmsha** |
12
+ | Pre-1950, classical, ancient | realistic | vintage | cinematic | - |
13
+ | Personal story, mentor | ligne-claire | warm | standard | - |
14
+ | Psychology, motivation, self-help, coaching | manga | warm | standard | **concept-story** |
15
+ | Business narrative, management, leadership | manga | warm | standard | **concept-story** |
16
+ | Conflict, breakthrough | (inherit) | dramatic | splash | - |
17
+ | Wine, food, lifestyle | realistic | neutral | cinematic | - |
18
+ | Martial arts, wuxia, xianxia | ink-brush | action | splash | **wuxia** |
19
+ | Romance, love, school life | manga | romantic | standard | **shoujo** |
20
+ | Business allegory, fable, parable, short insight, 四格 | minimalist | neutral | four-panel | **four-panel** |
21
+ | Biography, balanced | ligne-claire | neutral | mixed | - |
22
+
23
+ ## Preset Recommendation Rules
24
+
25
+ **When preset is recommended**: Load `presets/{preset}.md` and apply all special rules.
26
+
27
+ ### ohmsha
28
+ - **Triggers**: Tutorial, technical, educational, computing, programming, how-to, beginner
29
+ - **Special rules**: Visual metaphors, NO talking heads, gadget reveals, Doraemon-style characters
30
+ - **Base**: manga + neutral + webtoon/dense
31
+
32
+ ### wuxia
33
+ - **Triggers**: Martial arts, wuxia, xianxia, cultivation, swordplay
34
+ - **Special rules**: Qi effects, combat visuals, atmospheric elements
35
+ - **Base**: ink-brush + action + splash
36
+
37
+ ### shoujo
38
+ - **Triggers**: Romance, love story, school life, emotional drama
39
+ - **Special rules**: Decorative elements, eye details, romantic beats
40
+ - **Base**: manga + romantic + standard
41
+
42
+ ### concept-story
43
+ - **Triggers**: Psychology, motivation, self-help, business narrative, management, leadership, personal growth, coaching, soft skills, abstract concept through story
44
+ - **Special rules**: Visual symbol system, growth arc, dialogue+action balance, original characters
45
+ - **Base**: manga + warm + standard
46
+
47
+ ### four-panel
48
+ - **Triggers**: Business allegory, fable, parable, short insight, four-panel, 四格, 四格漫画, single-page comic, minimalist comic strip
49
+ - **Special rules**: Strict 起承转合 4-panel structure, B&W + spot color, simplified stick-figure characters, single-page story
50
+ - **Base**: minimalist + neutral + four-panel
51
+
52
+ ## Compatibility Matrix
53
+
54
+ Art Style × Tone combinations work best when matched appropriately:
55
+
56
+ | Art Style | ✓✓ Best | ✓ Works | ✗ Avoid |
57
+ |-----------|---------|---------|---------|
58
+ | ligne-claire | neutral, warm | dramatic, vintage, energetic | romantic, action |
59
+ | manga | neutral, romantic, energetic, action | warm, dramatic | vintage |
60
+ | realistic | neutral, warm, dramatic, vintage | action | romantic, energetic |
61
+ | ink-brush | neutral, dramatic, action, vintage | warm | romantic, energetic |
62
+ | chalk | neutral, warm, energetic | vintage | dramatic, action, romantic |
63
+ | minimalist | neutral | warm, energetic | dramatic, vintage, romantic, action |
64
+
65
+ **Note**: Art Style × Tone × Layout can be freely combined. Incompatible combinations work but may produce unexpected results.
66
+
67
+ ## Priority Order
68
+
69
+ 1. User-specified options (art / tone / style)
70
+ 2. Content signal analysis → auto-selection
71
+ 3. Fallback: ligne-claire + neutral + standard
@@ -0,0 +1,98 @@
1
+ Create a knowledge biography comic page following these guidelines:
2
+
3
+ ## Image Specifications
4
+
5
+ - **Type**: Comic book page with multiple panels
6
+ - **Orientation**: Portrait (vertical)
7
+ - **Aspect Ratio**: 2:3
8
+ - **Style**: See style-specific reference for visual guidelines
9
+
10
+ ## Panel Structure
11
+
12
+ ### Panel Borders
13
+ - Clean black lines (1-2px) around each panel
14
+ - White gutters between panels (8-12px)
15
+ - Panels arranged for clear reading flow
16
+ - Variety in panel sizes for visual rhythm
17
+
18
+ ### Panel Composition
19
+ - Clear focal points in each panel
20
+ - Proper use of foreground, midground, background
21
+ - Camera angles vary: eye level, bird's eye, low angle, close-up, wide shot
22
+ - Action flows logically between panels
23
+ - Negative space used intentionally
24
+
25
+ ## Text Elements
26
+
27
+ ### Speech Bubbles
28
+ - **Dialogue**: Oval/elliptical bubbles with pointed tails
29
+ - White fill with thin black outline
30
+ - Tail points clearly to speaker
31
+ - Hand-lettered style font (not computer-generated)
32
+
33
+ ### Narrator Boxes
34
+ - **Fourth Wall/Narrator**: Rectangular boxes
35
+ - Often positioned at panel edges (top or bottom)
36
+ - Slightly different fill color (cream or light yellow)
37
+ - Used for commentary, time jumps, explanations
38
+
39
+ ### Thought Bubbles
40
+ - Cloud-shaped with bubble trail leading to thinker
41
+ - Softer outline than speech bubbles
42
+ - For internal monologue
43
+
44
+ ### Caption Bars
45
+ - Rectangular bars at panel edges
46
+ - Time and place information
47
+ - "Meanwhile...", "Three years later..." type transitions
48
+ - Darker fill with white text, or vice versa
49
+
50
+ ### Typography
51
+ - Hand-drawn lettering style throughout
52
+ - Bold for emphasis and key terms
53
+ - Consistent letter sizing
54
+ - Chinese text: use full-width punctuation "",。!
55
+ - Clear hierarchy: titles > dialogue > captions
56
+
57
+ ## Scientific/Concept Visualization
58
+
59
+ When depicting abstract concepts:
60
+
61
+ | Concept | Visual Metaphor |
62
+ |---------|----------------|
63
+ | Neural networks | Glowing nodes connected by clean lines |
64
+ | Data flow | Luminous particles along simple paths |
65
+ | Algorithms | Geometric patterns, building blocks |
66
+ | Logic/proof | Interlocking puzzle pieces |
67
+ | Discovery | Light breaking through darkness |
68
+ | Uncertainty | Forking paths, question marks |
69
+ | Time | Clock motifs, calendar pages |
70
+
71
+ - Integrate diagrams naturally into narrative panels
72
+ - Use inset panels or thought-bubble style for explanations
73
+ - Simplified iconography over realistic depiction
74
+
75
+ ## Fourth Wall / Narrator Character
76
+
77
+ When depicting narrator characters addressing the reader:
78
+ - Character may look directly out of panel
79
+ - Can appear in "present day" framing scenes
80
+ - Distinct visual treatment from main timeline
81
+ - Often at page edges or in dedicated panels
82
+ - May comment on or question the events shown
83
+
84
+ ## Historical Accuracy
85
+
86
+ - Research period-specific details: costumes, technology, architecture
87
+ - Show aging naturally for characters across time periods
88
+ - Iconic items and locations rendered recognizably
89
+ - Balance accuracy with stylization
90
+
91
+ ## Language
92
+
93
+ - All text in Chinese (中文) unless source material is in another language
94
+ - Use Chinese full-width punctuation: "",。!
95
+
96
+ ---
97
+
98
+ Please generate the comic page based on the content provided below: