Agent-almanac audit-icon-pipeline

install

source · Clone the upstream repo

git clone https://github.com/pjt222/agent-almanac

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/ja/skills/audit-icon-pipeline" ~/.claude/skills/pjt222-agent-almanac-audit-icon-pipeline-84b043 && rm -rf "$T"

manifest: i18n/ja/skills/audit-icon-pipeline/SKILL.md

source content

アイコンパイプライン監査

レジストリとグリフマッピングファイル、アイコンディレクトリ、マニフェストを比較することで、欠落しているグリフ、欠落しているアイコン、古いマニフェストを検出する。スキル、エージェント、チームをカバーする構造化されたギャップレポートを生成する。

使用する場面

新しいスキル、エージェント、またはチームを追加した後、アイコンが必要かどうかを確認する場合
フルパイプラインレンダリングの前に、何が欠落しているかを特定する場合
レジストリ更新後にマニフェストが同期されていることを確認する場合
アイコンパイプラインの定期的なヘルスチェック

入力

任意: エンティティタイプフィルタ —
```
skill
```
、
```
agent
```
、
```
team
```
、または
```
all
```
（デフォルト:
```
all
```
）
任意: チェックするパレット（デフォルト:
```
cyberpunk
```
— リファレンスパレット）

手順

ステップ 1: レジストリの読み取り

信頼できるソースであるレジストリからすべてのエンティティIDを収集する。

```
skills/_registry.yml
```
を読み取り — すべてのドメインにわたるスキルIDを抽出する
```
agents/_registry.yml
```
を読み取り — すべてのエージェントIDを抽出する
```
teams/_registry.yml
```
を読み取り — すべてのチームIDを抽出する
カウントを記録する: スキル総数、エージェント総数、チーム総数

期待される結果:

total_skills

、

total_agents

、

total_teams

と一致するカウントを持つ3つのエンティティIDリスト。

失敗時の対応: レジストリファイルが見つからない場合は、パスを報告してそのエンティティタイプをスキップする。

ステップ 2: グリフマッピングの読み取り

グリフマッピングファイルからマッピング済みのエンティティIDをすべて収集する。

```
viz/R/glyphs.R
```
を読み取り —
```
SKILL_GLYPHS
```
リストからすべてのキーを抽出する
```
viz/R/agent_glyphs.R
```
を読み取り —
```
AGENT_GLYPHS
```
リストからすべてのキーを抽出する
```
viz/R/team_glyphs.R
```
を読み取り —
```
TEAM_GLYPHS
```
リストからすべてのキーを抽出する

期待される結果: マッピング済みIDの3つのリスト。

失敗時の対応: グリフファイルが見つからない場合は報告し、そのタイプのすべてのエンティティをマッピングなしとしてマークする。

ステップ 3: 欠落グリフの計算

レジストリIDとマッピング済みIDの差分を計算する。

欠落スキルグリフ:
```
registry_skill_ids - mapped_skill_ids
```
欠落エージェントグリフ:
```
registry_agent_ids - mapped_agent_ids
```
欠落チームグリフ:
```
registry_team_ids - mapped_team_ids
```

期待される結果: レジストリには存在するがグリフ関数がマッピングされていないエンティティIDのリスト。

失敗時の対応: 差分計算が失敗する場合は、レジストリとグリフファイル間のIDフォーマットが一致しているか確認する（例: アンダースコア対ハイフン）。

ステップ 4: レンダリング済みアイコンの確認

マッピング済みグリフに対応するレンダリング済みアイコンファイルがあるか確認する。

マッピング済みの各スキルIDについて、
```
viz/public/icons/<palette>/<domain>/<skillId>.webp
```
を確認する
マッピング済みの各エージェントIDについて、
```
viz/public/icons/<palette>/agents/<agentId>.webp
```
を確認する
マッピング済みの各チームIDについて、
```
viz/public/icons/<palette>/teams/<teamId>.webp
```
を確認する
```
viz/public/icons-hd/
```
内のHDバリアントも同じ構造で確認する

期待される結果: グリフはあるがレンダリング済みアイコンが欠落しているエンティティのリスト（標準およびHD）。

失敗時の対応: アイコンディレクトリが存在しない場合、パイプラインがまだ実行されていない — すべてを欠落として報告する。

ステップ 5: マニフェストの鮮度確認

マニフェストのカウントをレジストリのカウントと比較する。

```
viz/public/data/icon-manifest.json
```
を読み取り — エントリ数をカウントする
```
viz/public/data/agent-icon-manifest.json
```
を読み取り — エントリ数をカウントする
```
viz/public/data/team-icon-manifest.json
```
を読み取り — エントリ数をカウントする
レジストリの合計と比較する

期待される結果: マニフェストのカウントがレジストリのカウントと一致する。不一致は古いマニフェストを示す。

失敗時の対応: マニフェストファイルが存在しない場合、データパイプラインをまず実行する必要がある（

node build-data.js && node build-icon-manifest.js

）。

ステップ 6: ギャップレポートの生成

構造化されたサマリーを生成する。

出力を明確なテーブルまたはリスト形式でフォーマットする:

=== Icon Pipeline Audit ===

MISSING GLYPHS (no glyph function):
  Skills: 5 missing — [list]
  Agents: 2 missing — [list]
  Teams: 0 missing

MISSING ICONS (glyph exists, no rendered WebP):
  Standard (512px): 3 skills, 1 agent
  HD (1024px): 8 skills, 3 agents, 1 team

STALE MANIFESTS:
  icon-manifest.json: 320 entries vs 326 registry (stale)
  agent-icon-manifest.json: 66 entries vs 66 registry (OK)
  team-icon-manifest.json: 15 entries vs 15 registry (OK)

発見事項に基づいて次のアクションを提案する

期待される結果: 実行可能な次のステップを含む完全なギャップレポート。

失敗時の対応: すべてのチェックがギャップゼロで合格した場合、ポジティブな結果として「パイプライン完全同期」と報告する。

検証チェックリスト

3つのレジストリすべてが正常に読み取られている
3つのグリフマッピングファイルすべてが確認されている
標準とHDの両方のアイコンディレクトリがスキャンされている
マニフェストの鮮度が確認されている
カウントとエンティティリストを含むギャップレポートが生成されている
実行可能な次のステップが提供されている

よくある落とし穴

IDフォーマットの不一致: レジストリはケバブケース（
```
create-skill
```
）を使用するが、グリフマップではスネークケースのキーを使用する場合がある — 比較時に正規化を行うこと
パレットの前提: cyberpunkパレットのみのチェックではパレット固有のレンダリングギャップを見逃す
空のディレクトリ: ドメインディレクトリが存在するが空である場合、glob時に「アイコンが存在する」とカウントされる — ディレクトリの存在ではなく、ファイルの存在を確認すること
HDが未レンダリング: HDアイコンは別のディレクトリツリー（
```
icons-hd/
```
）にある — 標準アイコンと混同しないこと