create-glyph

pjt222

更新于 2 days ago

6 次查看

元aidesign

关于

The `create-glyph` skill generates R-based pictogram icons for entities in a force-graph visualization using ggplot2 and a primitives library. It handles the entire workflow from concept and color strategy to layer composition, manifest registration, and neon-glow output verification. Use this skill when adding a new entity needing an icon, replacing an existing glyph, or batch-creating icons for a new domain.

快速安装

Claude Code

技能文档

建字符

為 viz/ 視層之技、行者、團之標建 R 之字符圖。每字符為純 ggplot2 之函，於 100x100 畫布繪可識之形，以霓光渲至透底 WebP。

用時

新技、行者、團已增，需視標
現字符需替或重設
為新域批建字符
為實體概念原型視喻

入

必要：實體類——skill、agent 或 team
必要：實體 ID（如 create-glyph、mystic、r-package-review）與域（技者）
必要：視概——字符當示何
可選：參字符以量繁度
可選：自訂 --glow-sigma 值（默 4）

法

第一步：概——設視喻

識欲標之實體而擇視喻。

讀實體源文件以解其核心概念：
- 技：skills/<id>/SKILL.md
- 行者：agents/<id>.md
- 團：teams/<id>.md
擇喻類：
- 實物：試驗之瓶、安全之盾
- 抽象：合併之箭、迭代之旋
- 合成：組 2-3 簡形（如文件+筆）
參現字符以校繁度：

Complexity Tiers:
+----------+--------+-------------------------------------------+
| Tier     | Layers | Examples                                  |
+----------+--------+-------------------------------------------+
| Simple   | 2      | glyph_flame, glyph_heartbeat              |
| Moderate | 3-5    | glyph_document, glyph_experiment_flask    |
| Complex  | 6+     | glyph_ship_wheel, glyph_bridge_cpp        |
+----------+--------+-------------------------------------------+

定函名：glyph_<descriptive_name>（snake_case，唯一）

得：清心圖，有 2-6 劃之層。

敗則： 若概過抽，退至相關實物。察同域現字符以取靈感。

第二步：構——書字符函

書生 ggplot2 層之 R 函。

函簽（不可變之契）：

glyph_<name> <- function(cx, cy, s, col, bright) {
  # cx, cy = center coordinates (50, 50 on 100x100 canvas)
  # s = scale factor (1.0 = fill ~70% of canvas)
  # col = domain color hex (e.g., "#ff88dd" for design)
  # bright = brightened variant of col (auto-computed by renderer)
  # Returns: list() of ggplot2 layers
}

施縮因 * s 於諸維以一致縮：

r <- 20 * s        # radius
hw <- 15 * s       # half-width
lw <- .lw(s)       # line width (default base 2.5)
lw_thin <- .lw(s, 1.2)  # thinner line width

以現原建幾何：

幾何	用
`ggplot2::geom_polygon(data, .aes(x, y), ...)`	填形
`ggplot2::geom_path(data, .aes(x, y), ...)`	開線／曲
`ggplot2::geom_segment(data, .aes(x, xend, y, yend), ...)`	段、箭
`ggplot2::geom_rect(data, .aes(xmin, xmax, ymin, ymax), ...)`	矩形
`ggforce::geom_circle(data, .aes(x0, y0, r), ...)`	圓

施色策：

Alpha Guide:
+----------------------+------------+--------------------------+
| Purpose              | Alpha      | Example                  |
+----------------------+------------+--------------------------+
| Large fill (body)    | 0.08-0.15  | hex_with_alpha(col, 0.1) |
| Medium fill (accent) | 0.15-0.25  | hex_with_alpha(col, 0.2) |
| Small fill (detail)  | 0.25-0.35  | hex_with_alpha(bright, 0.3) |
| Outline stroke       | 1.0        | color = bright           |
| Secondary stroke     | 1.0        | color = col              |
| No fill              | ---        | fill = NA                |
+----------------------+------------+--------------------------+

返平 list() 之層（渲引遍歷而各包以光）
按實體類置函於宜原文件：
- 技：按域分於 19 原文件：
  - primitives.R — bushcraft、compliance、containerization、data-serialization、defensive
  - primitives_2.R — devops、general、git、mcp-integration
  - primitives_3.R — mlops、observability、PM、r-packages、reporting、review、web-dev、esoteric、design
  - 新域續 primitives_4.R 至 primitives_19.R
- 行者：viz/R/agent_primitives.R
- 團：viz/R/team_primitives.R

得：可行 R 函返 2-6 ggplot2 層之列。

敗則： 若 ggforce::geom_circle 致訛，確 ggforce 已裝。若坐標偏，記畫布 100x100，(0,0) 於左下。互動試函：

source("viz/R/utils.R"); source("viz/R/primitives.R")  # etc.
layers <- glyph_<name>(50, 50, 1.0, "#ff88dd", "#ffa8f0")
p <- ggplot2::ggplot() + ggplot2::coord_fixed(xlim=c(0,100), ylim=c(0,100)) +
     ggplot2::theme_void()
for (l in layers) p <- p + l
print(p)

第三步：入——映實體至字符

於宜字符映文件加實體-字符之映。

技者：

開 viz/R/glyphs.R
尋目標域之註釋段（如 # -- design (3)）
於域塊內按字母序加項：
```
"skill-id" = "glyph_function_name",
```
若用則更域計於註釋

行者：

開 viz/R/agent_glyphs.R
於 AGENT_GLYPHS 尋字母位
加項：
```
"agent-id" = "glyph_function_name",
```

團：

開 viz/R/team_glyphs.R
於 TEAM_GLYPHS 尋字母位
加項：
```
"team-id" = "glyph_function_name",
```
驗目標列無重 ID

得：宜 *_GLYPHS 列含新映。

敗則： 若後建報「No glyph mapped」，察實體 ID 精合清單與籍。

第四步：清單——增標項

於宜清單文件註冊標。

技者： viz/data/icon-manifest.json

{
  "skillId": "skill-id",
  "domain": "domain-name",
  "prompt": "<domain basePrompt>, <descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/<domain>/<skill-id>.webp",
  "status": "pending"
}

行者： viz/data/agent-icon-manifest.json

{
  "agentId": "agent-id",
  "prompt": "<agent-specific descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/agents/<agent-id>.webp",
  "status": "pending"
}

團： viz/data/team-icon-manifest.json

{
  "teamId": "team-id",
  "prompt": "<team-specific descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/teams/<team-id>.webp",
  "status": "pending"
}

得：合法 JSON，新項置於同類兄弟間。

敗則： 驗 JSON 語法。常誤：末陣元後拖逗號、缺引號。

第五步：渲——生標

運標管以渲新字符。宜以 build.sh 為入——其處平台察與 R 二進擇。全旗與管構參 render-icon-pipeline。

# From project root — renders all palettes, standard + HD, skips existing icons
bash viz/build.sh --only <domain> --skip-existing          # skills
bash viz/build.sh --type agent --only <id> --skip-existing # agents
bash viz/build.sh --type team --only <id> --skip-existing  # teams

# Dry run first:
bash viz/build.sh --only <domain> --dry-run

build.sh 運全管（palette → data → manifest → render → terminal glyphs）。非渲步加十秒而確諸數當。

出位：

技：viz/public/icons/<palette>/<domain>/<skill-id>.webp
行者：viz/public/icons/<palette>/agents/<agent-id>.webp
團：viz/public/icons/<palette>/teams/<team-id>.webp

得：誌示 OK: <entity> (seed=XXXXX, XX.XKB) 而 WebP 文件存。

敗則：

"No glyph mapped" — 第三步映缺或有誤
"Unknown domain" — 域不在 palettes.R 之 get_palette_colors()
R 包訛——先運 install.packages(c("ggplot2", "ggforce", "ggfx", "ragg", "magick"))
若渲崩，互動試字符函（參第二步之退）

第六步：驗——視察

察渲出合質準。

驗文件存且尺合：

ls -la viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Expected: 15-80 KB typical range

以像觀開 WebP 以察：
- 全尺（1024x1024）形清
- 霓光存而不蓋
- 底透（無黑白矩）
- 畫布邊無切
察小尺（標於力圖渲於 ~40-160px）：
- 形仍可識
- 細不成噪
- 光不掩形

得：清可識之字符圖，均霓光於透底。

敗則：

光過強：以 --glow-sigma 2 重渲（默 4）
光過弱：以 --glow-sigma 8 重渲
小尺不可讀：簡字符（減層、粗筆、增 .lw(s, base) 基值）
邊切：減形尺或移中心

第七步：迭——若需修

調而重渲。

常調：
- 粗筆：增 .lw(s, base)——試 base = 3.0 或 3.5
- 填更顯：增 alpha 由 0.10 至 0.15-0.20
- 形比：調 s 之乘（如 20 * s -> 24 * s）
- 加／減細層：總層守 2-6 為最佳

變後重渲：

# Delete the existing icon first, then re-render
rm viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Use the appropriate build command from Step 5

滿意則驗清單狀為 "done"（建本成時自動更）

得：終標過第六步諸驗。

敗則： 若三次以上迭仍不可讀，考全改視喻（返第一步）。

參考

域與實體色譜

諸 58 域色（技用）定於 viz/R/palettes.R（單一真源）。行者與團色亦管於 palettes.R。賽博朋克譜（手調霓色）於 get_cyberpunk_colors()。viridis 族譜以 viridisLite 自動生。

查色：

source("viz/R/palettes.R")
get_palette_colors("cyberpunk")$domains[["design"]]   # skill domain
get_palette_colors("cyberpunk")$agents[["mystic"]]     # agent
get_palette_colors("cyberpunk")$teams[["tending"]]     # team

增新域時，於 palettes.R 三處加之：

PALETTE_DOMAIN_ORDER（字母）
get_cyberpunk_colors() 域列
運 bash viz/build.sh 重生譜、數、清單

字符函錄

全函錄參原源：

技：viz/R/primitives.R 至 viz/R/primitives_19.R（按域分）
行者：viz/R/agent_primitives.R
團：viz/R/team_primitives.R

助函

函	簽	用
`.lw(s, base)`	`(scale, base=2.5)`	縮感之線寬
`.aes(...)`	`ggplot2::aes` 別	美學映簡
`hex_with_alpha(hex, alpha)`	`(string, 0-1)`	加 alpha 於十六色
`brighten_hex(hex, factor)`	`(string, factor=1.3)`	亮十六色
`dim_hex(hex, factor)`	`(string, factor=0.4)`	暗十六色

驗

陷

忘 * s：硬碼像素值縮時破。皆乘 s。
畫布源混：(0,0) 於左下非左上。y 高則上。
雙光：渲引已施 ggfx::with_outer_glow() 於每層。字符函內勿加光。
層過多：每層獨包光。逾八層則渲慢而視噪。
ID 不合：字符映、清單、籍之實體 ID 須精合。
JSON 拖逗：清單為嚴 JSON。末陣元後勿拖逗。
缺域色：若域不在 palettes.R 之 get_cyberpunk_colors()，渲誤。先加色再重生。
原文件誤：技於按域分之 primitives*.R，行者於 agent_primitives.R，團於 team_primitives.R。

參

enhance-glyph — 改現字符視質、修渲問、增細層
audit-icon-pipeline — 察缺字符與標以知所需建者
render-icon-pipeline — 端至端運全渲管
ornament-style-mono — 補 AI 之像生（Z-Image 對 R 碼字符）
ornament-style-color — 可施於字符點填決之色論
create-skill — 加新技時觸字符建之父流

GitHub 仓库

pjt222/agent-almanac

路径: i18n/wenyan/skills/create-glyph

agentsagentskillsai-assisted-developmentclaude-codeskillsteams