create-glyph

pjt222

更新于 6 days ago

22 次查看

元aidesign

关于

This skill creates R-based pictogram glyphs for entity icons in the visualization layer using ggplot2 and a primitives library. It handles the entire workflow from concept and color strategy to registration, pipeline rendering, and verification of the neon-glow output. Use it when adding a new entity needing a visual icon, replacing an existing glyph, or batch-creating glyphs 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 原檔按域組
- 代：viz/R/agent_primitives.R
- 團：viz/R/team_primitives.R

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

敗： ggforce::geom_circle 誤→保 ggforce 裝。坐偏→記畫 100x100、(0,0) 於左下。交互試：

source("viz/R/utils.R"); source("viz/R/primitives.R")
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、於域塊內按字母序加 "skill-id" = "glyph_function_name", 代：開 viz/R/agent_glyphs.R、於 AGENT_GLYPHS 加同樣項團：開 viz/R/team_glyphs.R、於 TEAM_GLYPHS 加同樣項

驗目列無重 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 與 public/icons/cyberpunk/agents/<agent-id>.webp）

團： viz/data/team-icon-manifest.json（用 teamId 與 public/icons/cyberpunk/teams/<team-id>.webp）

得：有效 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 重渲
暈弱→以 --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
改後重渲：刪存標、用合構令重渲
滿時驗備態顯 "done"

得：終標通步六諸察。

敗： 3+ 迭後符仍不讀→考全異視喻（返步一）。

考

域與項色盤

58 域色（技）定於 viz/R/palettes.R（唯真源）。代與團色亦理於 palettes.R。cyberpunk 色盤於 get_cyberpunk_colors()。

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

加新域時於 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 於 hex 色
`brighten_hex(hex, factor)`	`(string, factor=1.3)`	亮 hex 色
`dim_hex(hex, factor)`	`(string, factor=0.4)`	暗 hex 色

驗

忌

忘 * s：硬碼素值比變時破
畫原惑：(0,0) 於左下、非左上
雙暈：渲器已施 ggfx::with_outer_glow()、勿於符函內加暈
層過多：過 8 層渲慢且視噪
ID 不合：符映、備、庫之項 ID 須皆合
JSON 末逗：備為嚴 JSON、末陣元後無逗
域色缺：域不於 get_cyberpunk_colors()→渲誤
誤原檔：技於 primitives*.R、代於 agent_primitives.R、團於 team_primitives.R

參

enhance-glyph — 精存符視質
audit-icon-pipeline — 察缺符標
render-icon-pipeline — 全端對端行渲流
ornament-style-mono — 補 AI 基像生
ornament-style-color — 施於符飾填決之色理
create-skill — 觸符造之父流

GitHub 仓库

pjt222/agent-almanac

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

agentsagentskillsai-assisted-developmentclaude-codeskillsteams