create-glyph

pjt222

Mis à jour 2 days ago

3 vues

Métaaidesign

À propos

Cette compétence crée des glyphes pictogrammes basés sur R pour les entités de la couche de visualisation en utilisant ggplot2 et une bibliothèque de primitives. Elle gère l'ensemble du flux de travail, de l'esquisse conceptuelle et de la stratégie de couleur jusqu'à l'enregistrement, au rendu par pipeline et à la vérification visuelle de la sortie à lueur néon. Utilisez-la pour ajouter de nouvelles entités nécessitant des icônes, remplacer des glyphes existants ou créer en lot pour un nouveau domaine.

Installation rapide

Claude Code

Recommandé

Principal

npx skills add pjt222/agent-almanac -a claude-code

Commande PluginAlternatif

/plugin add https://github.com/pjt222/agent-almanac

Git CloneAlternatif

git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/create-glyph

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

造字符

於 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）。非渲染步約加 10 秒，然確保所有資料為新。

輸出位：

技能：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) 之 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"（建構腳本於成功時自動更之）

預期： 終圖示通過步驟六之所有驗證。

失敗時： 若 3+ 迭代後字符仍不清，考慮全異之視覺隱喻（返步驟一）。

參考

領域與實體色板

所有 58 領域色（技能用）於 viz/R/palettes.R 定義（單一真源）。代理與團隊之色亦於 palettes.R 管。cyberpunk 色板（手調霓虹色）於 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() 之 domains 清單
行 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()。勿於字符函式內加光
層過多：各層單獨包光。過 8 層令渲染緩而視雜
ID 不合：字符映射、清單、註冊中之實體 ID 須完全相合
JSON 尾逗：清單為嚴 JSON。末陣列元素後無尾逗
領域色缺：若領域不於 palettes.R 之 get_cyberpunk_colors()，渲染將誤。先加色，再重生
原語檔誤：技能於按領域之 primitives*.R，代理於 agent_primitives.R，團隊於 team_primitives.R

Dépôt GitHub

pjt222/agent-almanac

Chemin: i18n/wenyan-lite/skills/create-glyph

agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence

create-glyph

À propos

Installation rapide

Claude Code

Documentation

造字符

適用時機

輸入

步驟

步驟一：概念——設計視覺隱喻

步驟二：構成——寫字符函式

步驟三：註冊——映實體於字符

步驟四：清單——加圖示項

步驟五：渲染——生圖示

步驟六：驗——視覺察

步驟七：迭代——按需精修

參考

領域與實體色板

字符函式目錄

輔助函式

驗證清單

常見陷阱

相關技能

Dépôt GitHub

Compétences associées

content-collections

polymarket

creating-opencode-plugins

sglang