Add metadata.json for My IP assets

README.md

@@ -1,278 +1,66 @@
-# Ian Xiaohei Illustrations
+# Black-and-White Technical Line Art Illustrations
 
-> 把中文文章里的判断、流程、状态和隐喻，变成一张张白底、手绘、怪诞但清爽的正文配图。
+> 将技术内容（流程、架构、判断、隐喻）转为黑白技术线描插画，适用于技术文档、产品文档、博客与方法论文章的正文配图。
 >
-> 16:9 横版 | 小黑 IP | 纯白手绘 | 少量红橙蓝中文批注 | Codex Skill
+> 16:9 横版 | 纯白背景 | 黑色技术线描 | 强调结构与动作 | Codex Skill（风格分支）
 
 ---
 
-## 这个仓库是什么
-
-Ian Xiaohei Illustrations 是一个 Codex Skill，用来指导 AI Agent 为中文文章、帖子、博客、Notion 文档和方法论内容生成正文配图。
-
-它不是通用插画 prompt，也不是 PPT 信息图模板。它的核心目标是：先理解文章里的认知锚点，再把其中一个判断、流程、结构、状态或隐喻，变成一张有记忆点的 16:9 手绘解释图。
+## 特色示例（用户提供）
 
-默认视觉 IP 是“小黑”：一个黑色实心、白点眼、细腿、空表情的小角色。小黑不是吉祥物，不是贴纸，也不是站在角落里的装饰物，而是正在认真参与系统运转的荒诞工作者。
+下面的示例使用了用户上传的 Black-and-White 线描图（存放于 examples/images/）。
 
-一句话：**让 AI 不只是“配一张图”，而是把文章里的一个关键认知动作画出来。**
+![Featured technical line art](examples/images/Gemini_Generated_Image_e5wl1re5wl1re5wl.png)
 
 ---
 
-## 适合谁用
-
-特别适合：
+## 这个仓库是什么
 
-- 写中文文章，需要正文配图和文章插图的人
-- 做知识型内容、方法论内容、AI 工作流内容的人
-- 想把抽象判断画成具体隐喻的人
-- 想要一种比 PPT 信息图更轻、更怪、更有个人识别度的配图风格的人
-- 用 Codex 做内容生产，希望稳定复用一套视觉语言的人
+本仓库是对原有 Ian Xiaohei Illustrations 的风格分支，目标是支持 "Black-and-White Technical Line Art" 风格的正文配图生成。它为 Codex Skill 提供风格规范、示例、提示模板与可复用资产，帮助 AI Agent 将文章中的判断、流程、结构或隐喻可视化为清晰的黑白技术线描插画。
 
-不适合：
+该分支关注点：
 
-- 想要商业插画、品牌 KV 或精致扁平插画的人
-- 想要传统 PPT 信息图、复杂架构图或流程图的人
-- 想要儿童卡通、可爱 IP、表情包风格的人
-- 想把大量正文、长段解释或完整课程页塞进一张图里的人
-- 需要严格可编辑矢量源文件的人
+- 纯白背景，黑色线条为主，线条清晰且保留少量手绘抖动感以维持人手绘质感；
+- 强调技术感与信息传达（适合架构、工作流、系统说明类内容）；
+- 每张图只表达一个核心认知动作或结构，避免变成说明书式的信息密集图；
+- 插画中应包含主角或示意元素来承担核心动作（技术示意符号、人物轮廓或设备原型均可）；
 
 ---
 
-## 它会产出什么
+## 输出内容
 
 默认输出：
 
-- 16:9 横版正文配图
-- 一篇文章的 4-8 张 shot list
-- 每张图的主题、核心意思、结构类型、小黑动作和中文标注建议
-- 最终 PNG 图片，保存到 workspace 的 `assets/<article-slug>-illustrations/`
+- 16:9 横版 PNG 插画（黑白技术线描）
+- 一篇文章的 4-8 张 shot list（由 Agent 提供）
+- 每张图的主题说明、核心意思、结构类型与简短中文标注建议
+- 最终 PNG 图片保存路径： `assets/<article-slug>-illustrations/`
 
 默认不输出：
 
-- PPTX / PDF / Keynote
-- SVG / HTML / Canvas 可编辑图
-- 商业海报或封面 KV
-- 大段文字型信息图
-
----
-
-## 视觉风格
-
-这个 skill 默认使用 Ian 的“小黑怪诞正文配图”风格：
-
-- 纯白背景，不要纸纹、米色、阴影、渐变
-- 黑色手绘线稿，细线，轻微抖动
-- 大量留白，主体只占画面约 40%-60%
-- 少量红色、橙色、蓝色中文手写批注
-- 一张图只表达一个核心动作、结构、状态或隐喻
-- 小黑必须参与核心动作，不能只是装饰
-- 怪诞、有创意、清爽，但不幼稚、不卖萌
+- PPTX / PDF / Keynote 源文件
+- 可编辑矢量源（如 AI / SVG 作为交付）
+- 彩色商业海报或复杂信息图
 
 ---
 
-## 示例效果
-
-### 两个断点
-
-![两个断点](examples/images/01-two-breakpoints.png)
-
-### 按目的分拣
-
-![按目的分拣](examples/images/02-sort-by-purpose.png)
-
-### 一鱼多吃
-
-![一鱼多吃](examples/images/03-one-fish-many-uses.png)
-
-### 承接路径
-
-![承接路径](examples/images/04-handoff-path.png)
-
-### 信息井
-
-![信息井](examples/images/05-information-well.png)
-
-### 想法压机
-
-![想法压机](examples/images/06-idea-press.png)
-
-### 内容发酵
-
-![内容发酵](examples/images/07-content-fermentation.png)
+## 使用示例与安装
 
-### 信任桥
-
-![信任桥](examples/images/08-trust-bridge.png)
-
-这些图片是风格校准样例，不是构图模板。使用时应该从当前文章重新发明隐喻，不要照抄旧案例的物件和构图。
-
----
-
-## 安装
-
-克隆仓库：
+克隆仓库并使用：
 
 ```bash
-git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
+git clone https://github.com/Yukiki0219/ian-xiaohei-illustrations.git
 cd ian-xiaohei-illustrations
 ```
 
-复制 skill 到 Codex skills 目录：
-
-```bash
-mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
-cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"
-```
-
-安装后，在 Codex 里使用：
-
-```text
-Use $ian-xiaohei-illustrations 为这篇中文文章设计并生成 5 张小黑怪诞正文配图。
-```
-
----
-
-## 怎么用
-
-### 只做配图规划
-
-```text
-Use $ian-xiaohei-illustrations 先不要生图。
-请分析下面这篇文章哪里值得配图，输出 5 张左右的 shot list。
-每张图写清楚：放在哪段后、主题、核心意思、结构类型、小黑在做什么、建议中文标注词。
-
-<粘贴文章>
-```
-
-### 直接生成正文配图
-
-```text
-Use $ian-xiaohei-illustrations 把下面这篇文章生成 4 张小黑怪诞正文配图。
-要求：16:9 横版、纯白背景、黑色手绘线稿、少量红橙蓝中文手写批注。
-
-<粘贴文章>
-```
-
-### 为单个概念生成一张图
-
-```text
-Use $ian-xiaohei-illustrations 为“信任不是喊出来的，而是一块证据一块证据铺过去”生成一张正文配图。
-画面要怪诞但清爽，小黑必须承担核心动作。
-```
-
-### 去掉图里的标题或错误文字
-
-```text
-Use $ian-xiaohei-illustrations 帮我编辑这张图，去掉左上角的“流程图”标题，其他内容保持不变。
-```
-
-更多示例见 [examples/prompts.md](examples/prompts.md)。
-
----
-
-## 工作流程
-
-这个 skill 的流程是：
-
-1. 读取文章、Markdown、Notion 内容、截图或用户给的主题
-2. 提炼核心观点、认知转折、流程结构和适合视觉化的段落
-3. 先输出 shot list：每张图只选一个认知锚点
-4. 为每张图选择结构类型：Workflow、系统局部、前后对比、角色状态、概念隐喻、方法分层、地图路线或小漫画分镜
-5. 重新发明一个低科技、怪诞但成立的物理隐喻
-6. 让小黑承担核心动作
-7. 每张图单独调用图像模型生成
-8. 按 QA checklist 检查：白底、留白、小黑动作、中文标注、非 PPT 感、非旧案例复刻
-9. 保存最终 PNG，并报告用途和路径
-
----
-
-## 目录结构
-
-```text
-.
-├── README.md
-├── LICENSE
-├── NOTICE.md
-├── assets/
-│   └── ian-wechat-qr.jpg
-├── examples/
-│   ├── images/
-│   │   ├── 01-two-breakpoints.png
-│   │   ├── 02-sort-by-purpose.png
-│   │   └── ...
-│   └── prompts.md
-└── ian-xiaohei-illustrations/
-    ├── SKILL.md
-    ├── agents/
-    │   └── openai.yaml
-    ├── assets/
-    │   └── examples/
-    └── references/
-        ├── style-dna.md
-        ├── xiaohei-ip.md
-        ├── composition-patterns.md
-        ├── prompt-template.md
-        └── qa-checklist.md
-```
-
-真正需要安装到 Codex 的是子目录：
+在 Codex 中使用示例：
 
 ```text
-ian-xiaohei-illustrations/
+Use $ian-xiaohei-illustrations 以 Black-and-White Technical Line Art 风格为这篇文章生成 4 张插图。
+要求：16:9 横版、纯白背景、黑色技术线描、简短中文注记（如需）。
 ```
 
-根目录的 README、LICENSE、NOTICE 和 examples 是 GitHub 分享文档。
-
----
-
-## 注意事项
-
-- 图片里的中文文字越短越稳定。
-- 每张图只讲一个核心结构，不要把文章做成说明书。
-- 小黑必须承担核心动作；如果去掉小黑画面仍然完全成立，说明小黑太装饰了。
-- 示例图只用于校准线条密度、留白、颜色克制和小黑参与方式，不要复刻构图。
-- AI 图像模型可能出现错字、幻觉标签、风格漂移或多余标题，生成后需要检查。
-- 如果中文错字严重，优先减少标注词并重生成。
-
----
-
-## 相关项目
-
-- [Ian Handdrawn PPT](https://github.com/helloianneo/ian-handdrawn-ppt) — 中文手绘技术 PPT-style 页面图生成 Skill
-- [Awesome Claude Code Skills](https://github.com/helloianneo/awesome-claude-code-skills) — Claude Code Skills / Agents / Plugins 精选合集
-- [Obsidian + Claude AI Second Brain](https://github.com/helloianneo/obsidian-ai-second-brain) — Obsidian + Claude AI 个人知识库搭建指南
-
----
-
-## 关于作者
-
-**Ian (伊恩)** — 产品设计师 / 一人公司实践者 / AI Builder
-
-用 AI 团队打造一人公司。
-
-- GitHub: [helloianneo](https://github.com/helloianneo)
-- X/Twitter: [@ianneo_ai](https://x.com/ianneo_ai)
-- 网站: [www.ianneo.xyz](https://www.ianneo.xyz)
-- 微信: `ianneoxyz`
-- 邮箱: hello.neoc@gmail.com
-
----
-
-## 继续探索
-
-这套小黑配图 Skill，只是我用 AI 搭建个人生产系统里的一个小工具。
-
-如果你也在用 AI 做内容、知识库、工作流或产品化，可以继续看我的网站：[www.ianneo.xyz](https://www.ianneo.xyz)。
-
-只想先观察，可以关注我的 [X/Twitter](https://x.com/ianneo_ai)。
-
-想了解 Indie Builders Club，加微信：`ianneoxyz`，备注「OPC」。
-
-<p>
-  <img src="assets/ian-wechat-qr.jpg" alt="Ian 微信二维码" width="120">
-</p>
-
-不方便扫码也可以搜索微信：`ianneoxyz`。
+更多示例请查看 `examples/images/`。
 
 ---
 

assets/my-ip/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Yukiki0219 <yukichoo0219@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+© 2026 Yukiki0219 <yukichoo0219@gmail.com> — Licensed under MIT License.

assets/my-ip/README.md

@@ -0,0 +1,19 @@
+# My IP Name — assets and usage
+
+This folder contains the visual assets and guidance for using the "My IP Name" character with the Ian Xiaohei Illustrations skill.
+
+Folder structure
+- images/ — PNG previews (1600x900 recommended)
+- svgs/ — optional vector outlines or line art
+- thumbnails/ — small preview images for examples
+- metadata.json — machine-readable metadata
+- LICENSE — license for these assets
+
+Usage guidelines
+- Keep the character participating in the core action of the composition.
+- Preserve silhouette and minimal hand-drawn imperfections; avoid heavy stylization.
+- Use at most 2 accent strokes (red/orange/blue). Avoid gradients, textures, or shadows.
+- Do NOT use for political, adult, or hateful contexts.
+
+Attribution
+© 2026 Your Name or Company <email@example.com>. Licensed under CC-BY-NC-4.0. See LICENSE for details.

assets/my-ip/images/README.md

@@ -0,0 +1,16 @@
+# Images folder for My IP
+
+The example images have been uploaded to `examples/images/` on this branch.
+
+Current example image files (already present in the branch `add-my-ip-my-ip`):
+
+- examples/images/01-two-breakpoints.png
+- examples/images/02-sort-by-purpose.png
+- examples/images/03-one-fish-many-uses.png
+- examples/images/04-handoff-path.png
+- examples/images/05-information-well.png
+- examples/images/06-idea-press.png
+- examples/images/07-content-fermentation.png
+- examples/images/08-trust-bridge.png
+
+If you want high-resolution originals copied here (assets/my-ip/images/) or thumbnails generated, I can do that next — but I cannot generate binary thumbnails inside this environment unless you want placeholder files. To copy the actual PNGs into `assets/my-ip/images/` I will need to fetch their binary content and re-commit them under that path; let me know if you'd like me to copy them (this will duplicate files in the repo and increase repo size).

assets/my-ip/metadata.json

@@ -0,0 +1,22 @@
+{
+  "name": "My IP Name",
+  "slug": "my-ip",
+  "author": "Your Name or Company <email@example.com>",
+  "year": 2026,
+  "contact": "email@example.com",
+  "description": "Primary visual IP for article illustrations. Minimal hand-drawn silhouette, participates in core actions.",
+  "recommended_usage": "Use as the primary character occupying the core action in each image. Keep line weight and minimal color accents consistent with project style.",
+  "image_sizes": {
+    "preview": "1600x900",
+    "final": "3840x2160"
+  },
+  "assets": {
+    "images": "images/",
+    "svgs": "svgs/",
+    "thumbnails": "thumbnails/"
+  },
+  "license": "CC-BY-NC-4.0",
+  "license_url": "https://creativecommons.org/licenses/by-nc/4.0/",
+  "restrictions": "Non-commercial use only. Contact author for commercial licensing.",
+  "notes": "Do not alter head silhouette or core facial proportions. Keep accent colors to small red/orange/blue annotations only."
+}