# helloianneo/ian-xiaohei-illustrations architecture

> Architecture diagram of the GitHub repository helloianneo/ian-xiaohei-illustrations, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/helloianneo/ian-xiaohei-illustrations
- Repository: https://github.com/helloianneo/ian-xiaohei-illustrations
- Video tour (about a minute): https://gitdiagram.com/helloianneo/ian-xiaohei-illustrations/video

## Overview

这是一个指导 Codex Agent 为中文内容规划并生成小黑风格正文配图的 Skill，而非独立运行的软件服务。主要流程是理解输入、提炼认知锚点、规划 shot list、设计隐喻与构图、逐张生成、质检并保存 PNG。README 明确了这些阶段及参考资料的职责；没有源代码摘录，因此图中只呈现文档支持的调用与读写关系。

Main entry points: [`ian-xiaohei-illustrations/SKILL.md`](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md) (小黑配图 Skill), [`ian-xiaohei-illustrations/references/qa-checklist.md`](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/qa-checklist.md) (图像质检), [`ian-xiaohei-illustrations/references/composition-patterns.md`](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/composition-patterns.md) (结构类型选择), [`ian-xiaohei-illustrations/references/xiaohei-ip.md`](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/xiaohei-ip.md) (小黑动作设计)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["内容转配图"]
  node_skill["小黑配图 Skill<br/>[SKILL.md]"]
  node_analysis["认知锚点提炼<br/>[SKILL.md]"]
  node_shotlist["Shot list<br/>[SKILL.md]"]
  node_structure["结构类型选择"]
end

subgraph group_design["视觉设计规范"]
  node_metaphor["隐喻构思<br/>[SKILL.md]"]
  node_xiaohei["小黑动作设计<br/>[xiaohei-ip.md]"]
  node_style["风格规范<br/>[style-dna.md]"]
  node_prompt["图像提示词<br/>[prompt-template.md]"]
end

subgraph group_production["生成与交付"]
  node_generation["逐张图像生成<br/>[SKILL.md]"]
  node_qa["图像质检<br/>[qa-checklist.md]"]
  node_png["最终 PNG<br/>[SKILL.md]"]
end

node_writer(("文章作者"))
node_content["文章或主题"]
node_agent(("Codex Agent"))
node_image_model(("图像模型"))
node_workspace[("Workspace")]

node_writer -->|"提交请求"| node_agent
node_writer -->|"提供内容"| node_content
node_agent -->|"按其执行"| node_skill
node_skill -->|"读取输入"| node_content
node_skill -->|"提炼观点"| node_analysis
node_skill -->|"规划图组"| node_shotlist
node_skill -->|"选择结构"| node_structure
node_skill -->|"构思隐喻"| node_metaphor
node_skill -->|"设计动作"| node_xiaohei
node_skill -->|"遵循风格"| node_style
node_skill -->|"组织提示词"| node_prompt
node_agent -->|"执行生成"| node_generation
node_generation -->|"逐张请求"| node_image_model
node_image_model -->|"返回图像"| node_generation
node_agent -->|"检查图像"| node_qa
node_qa -->|"验收图像"| node_png
node_agent -->|"保存文件"| node_workspace
node_workspace -->|"写入 PNG"| node_png
node_agent -->|"报告用途路径"| node_writer

click node_skill "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"
click node_analysis "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"
click node_shotlist "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"
click node_structure "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/composition-patterns.md"
click node_metaphor "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"
click node_xiaohei "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/xiaohei-ip.md"
click node_style "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/style-dna.md"
click node_prompt "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/prompt-template.md"
click node_generation "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"
click node_qa "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/qa-checklist.md"
click node_png "https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_analysis,node_shotlist,node_structure toneBlue
class node_metaphor,node_xiaohei,node_style,node_prompt,node_workspace toneAmber
class node_generation,node_qa,node_png toneMint
class node_writer,node_content,node_agent,node_image_model toneIndigo
```

## Components

### 内容转配图

- [小黑配图 Skill](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`
- [认知锚点提炼](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`
- [Shot list](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`
- [结构类型选择](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/composition-patterns.md): `ian-xiaohei-illustrations/references/composition-patterns.md`

### 视觉设计规范

- [隐喻构思](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`
- [小黑动作设计](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/xiaohei-ip.md): `ian-xiaohei-illustrations/references/xiaohei-ip.md`
- [风格规范](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/style-dna.md): `ian-xiaohei-illustrations/references/style-dna.md`
- [图像提示词](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/prompt-template.md): `ian-xiaohei-illustrations/references/prompt-template.md`

### 生成与交付

- [逐张图像生成](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`
- [图像质检](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/references/qa-checklist.md): `ian-xiaohei-illustrations/references/qa-checklist.md`
- [最终 PNG](https://github.com/helloianneo/ian-xiaohei-illustrations/blob/main/ian-xiaohei-illustrations/SKILL.md): `ian-xiaohei-illustrations/SKILL.md`

### Other components

- **文章作者**
- **文章或主题**
- **Codex Agent**
- **图像模型**
- **Workspace**

## Connections

- 文章作者 → Codex Agent: 提交请求
- 文章作者 → 文章或主题: 提供内容
- Codex Agent → 小黑配图 Skill: 按其执行
- 小黑配图 Skill → 文章或主题: 读取输入
- 小黑配图 Skill → 认知锚点提炼: 提炼观点
- 小黑配图 Skill → Shot list: 规划图组
- 小黑配图 Skill → 结构类型选择: 选择结构
- 小黑配图 Skill → 隐喻构思: 构思隐喻
- 小黑配图 Skill → 小黑动作设计: 设计动作
- 小黑配图 Skill → 风格规范: 遵循风格
- 小黑配图 Skill → 图像提示词: 组织提示词
- Codex Agent → 逐张图像生成: 执行生成
- 逐张图像生成 → 图像模型: 逐张请求
- 图像模型 → 逐张图像生成: 返回图像
- Codex Agent → 图像质检: 检查图像
- 图像质检 → 最终 PNG: 验收图像
- Codex Agent → Workspace: 保存文件
- Workspace → 最终 PNG: 写入 PNG
- Codex Agent → 文章作者: 报告用途路径