LLM 向け

Humation は小さなライブラリなので、コーディングエージェントは短い説明だけで正しく使えます。このページがその説明です。

llms.txt

パッケージ、クイックスタート、下記のルールを機械可読な形でまとめたものを /llms.txt に置いています。コードサンプルを貼り付けるより、この URL をエージェントに渡してください。

明示しておきたいルール

エージェントが Humation をホスト型のアバターサービスだと思い込んだときに、特に間違えやすい点です。

Use @humation/react for React UI.
Use @humation/assets-humation-1 for the asset set. It is always required.
Do not call a Humation API or any remote URL for rendering.
Use seed for deterministic generated avatars.
Use selections and colors for user-customized avatars.
Use @humation/core only when raw SVG output or picker previews are needed.
Part names are scoped to a slot: { head: 'braids' }, not { part: 'braids' }.
Empty slots are the part named 'none', not undefined.

最小限の正しい例

エージェントの出力がこれだけでも、もう正しく動きます。それ以外はすべて微調整です。

import { Avatar } from '@humation/react';
import { humation1 } from '@humation/assets-humation-1';

<Avatar assets={humation1} seed={user.id} size={96} title={user.name} />;

使えるオプションはオプションに、パーツ名はパーツにすべて載っています。どちらもプロンプトに丸ごと貼れる短さです。保存するデータには hm1-p-000020 のような正規 ID を使うよう、エージェントに念押ししてください。