最新ニュースと検証レポートで、AI の導入をお手伝いします。

相談する

検証レポート作る人向け

海外の部品集で、Claude に社内の管理画面を作らせた。つまずき7つを自分で報告してきた

読むのに約7分

「佐藤 健一」のしるしが「佐健」に。AI は画面を見て直し、つまずき7つを一覧で報告してきた。

この記事で分かったこと

  • 海外の部品集を日本語で使うと、小さなずれが出る「佐藤 健一」さんのしるしが「佐健」になった。AI が自分で画面を見て気づき、「佐」に直した
  • 「正直に報告して」と頼むと、つまずきが一覧で返る7つ返ってきた。日本語のずれが1つ、できたての道具らしい所が4つ、安全の確かめが2つ
  • 止まった自動の処理を、読んでから判断した部品集を取り寄せたときに止まった処理。中身を読み、動かさないと決めた
  • 部品集を使うと、時間は約2倍4分0秒と1分52秒。できたファイルは 1.3MB と 236KB。画面1つ、1回ずつの記録

貼って使える頼み文だけ見る

「佐藤 健一」さんの名前の横に出る丸いしるしが、「佐健」になっていました。海外の会社が作った「画面の部品集」で、AI に社内の画面を作らせたときのことです。

AI は、できた画面を自分で開いてこれに気づき、直していました。この記事は画面を作る人向けですが、 プログラムを書かない人にも役に立つ話が2つあったので、そこを中心に書きます。

「今日の担当」の一覧。直す前は、丸の中が「佐健」「田翔」「高美」。直したあとは「佐」「田」「高」

頼んだのは、工事の予定を見る画面を1つ

舞台は、架空の会社「みなと設備」です。水道や空調の工事の予定を、社内で見る画面を頼みました。

  • 上に、今週の件数などの数字を4つ
  • その下に、工事の一覧を10件(日付、現場、担当、内容、状態)
  • 右に、今日の担当の一覧
  • 状態(予定、作業中など)で絞りこめること

「部品集」は、ボタン、表、カードといった画面の部品を、ひとそろいにしたものです。同じ部品で組めば、だれが作っても同じ見た目になります。作る人のあいだでは「デザインシステム」と呼ばれます。

使わせたのは、Meta が GitHub で公開している Astryx(アストリクス)という部品集です。試したのは 0.7.12 という版で、まだ 1.0 になっていません。付いてきた説明書には、「AI と一緒に作るなら」という案内がありました。

同じ注文で、2回やりました。

2回の頼み方のちがい

Astryx の回

  • 見た目の部品には Astryx を使って
  • 使い方は、取り寄せたものの中の説明で確かめて
  • うまく使えなかった所は、正直に報告して

部品集なしの回

  • 部品集は使わないで
  • 見た目は、自分で書いて

Astryx の回の3つ目の一文が、この記事の主役です。

どちらの画面も、動いた

上が Astryx の部品で組んだ画面、下が部品集なしの画面です。会社も、人の名前も、工事も、すべて架空です。

Astryx の部品で作った画面。白い地に、数字のカード4つ、一覧、右に今日の担当

部品集を使わずに作った画面。紺の帯、色つきの線が入ったカード、今日の工事に薄い黄色

どちらも、「保留」のボタンを押すと、一覧が保留の工事だけになりました。これは、こちらでも開いて確かめました。

Astryx の画面は、白い地に細い線。大きなサービスの管理画面で見かける、くせのない見た目です。

部品集なしの画面は、AI が自分で決めた見た目です。上に紺の帯を引き、今日の工事の行を薄い黄色にしています。

同じ場所を大きくすると、ちがいがよく分かります。

数字のカードの拡大。Astryx は細い線だけ。部品集なしは、上に色の線があり、数字が太い

件数がちがうのは、架空のデータを AI が回ごとに作ったためです。見た目だけを比べてください。

絞りこみのボタンと、状態のしるしの拡大。Astryx はこい色でぬりつぶしたしるし。部品集なしは、うすい色の地に色の字

1つの画面だけなら、部品集なしのほうが、目の行く場所がはっきりしていました。これは、こちらの感想です。

日本語の名前を入れたら、しるしが「佐健」になった

ここが、技術者でない人にも覚えておいてほしい1つ目です。

名前の横の丸いしるしは、写真がないときに、名前の頭文字を出す部品です。英語の名前なら、John Doe は「JD」になります。

頭文字のしるしの説明図。John Doe は JD。佐藤 健一は「佐健」。名字だけを渡すと「佐」

同じ仕組みに「佐藤 健一」を入れると、名字の1字目と名前の1字目がつながって「佐健」になります。こわれているわけではありません。ただ、日本の会社の画面では見かけない書き方です。

AI は、できた画面を自分で開いて、画像に撮って見ました。そこで気づいています。作業の記録には、こう残っていました。

the avatar initials read oddly (“佐健”) (しるしの頭文字が、変に読める)

AI は、名字だけを部品に渡すように直しました。報告には、こう書いてあります。

「佐藤 健一」が「佐健」と表示されてしまいます。名字だけを渡して「佐」と出るようにしました。

海外で作られた道具を日本語で使うと、こういう小さなずれが出ます。作る人に頼む側も、名前、日付、金額が画面でどう出ているかは、自分の目で見ておく値打ちがあります。

AI が自分の画面を見て直した所は、もう1つありました。

一覧の「今日」のしるし。直す前は「今…」と切れている。直したあとは「今日」と読める

日付の列がせまくて、「今日」のしるしが「今…」と切れていました。AI は列の幅を広げて直しています。

どちらも、プログラムを読むだけでは分からず、画面を見て初めて分かることです。

部品集なしの回は、できた画面を開いていません。AI は報告(英語で返ってきました)に、こう書いています。

I haven’t opened it in a browser, so the look and the filter buttons haven’t been checked by eye yet. (ブラウザでは開いていません。見た目と絞りこみのボタンは、まだ目で確かめていません)

確かめていないことを、確かめていないと書いてきた点はよい所です。ただ、頼む側としては「できた画面を開いて、目で確かめて」と一言足すべきでした。

「正直に報告して」と頼んだら、つまずきが7つ返ってきた

2つ目の学びです。

初めての道具なので、うまくいかない所が出るだろうと考えました。そこで、先に「うまく使えなかった所は、正直に報告してください」と頼んでおきました。

返ってきた報告の、実物です。

AI の報告の実物(一部)。「Astryx でうまくいかなかった所・注意点」として、1から7まで番号つきで並んでいる

7つを、こちらで3つに分けました。

7つのつまずきの色分け。日本語で使うと出るずれが1つ、できたての道具らしい所が4つ、安全の確かめが2つ

青の4つは、作る人向けの話です。短く書きます。

  • 1番:説明書が2つあり、片方に書いてある部品の名前(XDSTheme)が、実物にはなかった。AI は、もう片方の説明書と、付属の道具の説明に合わせた
  • 2番:見た目を細かく変える仕組み(StyleX)は、追加の準備が要る。今回は準備をせず、でき上がった部品だけで組んだ
  • 3番:付属の道具が勧めてくるひな形は、その準備と、別の部品も入れないと使えない。ひな形は使わず、部品を1つずつ組み合わせた
  • 5番:仕上げの変換(ビルド)のときに「ファイルが大きい」と注意が出た。エラーではないので、そのままにした

この一覧があると、あとで人が引きつぐときに、「どこを使っていないか」「どこがあやしいか」から読み始められます。この一文を足さなかったら同じ一覧が返ってきたかは、試していません。

止まった自動の処理を、読んでから「動かさない」と決めた

緑の2つは、安全の話です。作る人でなくても、知っておいてよい所です。

部品集を取り寄せると、その直後に自動で動こうとする処理が付いていることがあります。今回は、取り寄せに使う道具(npm)の安全の仕組みが、それを止めました。

取り寄せたときに出た注意の実物と、AI の動き。止まったことに気づく、中身を読む、動かさないと決める

AI は、「止まったから、許可して動かす」とはしませんでした。先に、その処理の中身を開いて読んでいます。報告には、こうあります。

中身は astryx init を勧めるメッセージを出すだけでした。astryx init は AGENTS.md や CLAUDE.md を書き足すコマンドで、今回は不要なので実行していません。

AGENTS.md と CLAUDE.md は、AI への指示を書いておくファイルです。知らない道具に、そこを書きかえさせなかった、ということです。

6番も同じ向きの判断です。英字の書体は、外のサイトから読みこむ作りでした。AI は「社内画面なので外部への通信を避け」、パソコンに入っている書体で表示しています。

知らない道具が自動でやろうとすることは、読んでから通す。 この順番は、人が作業するときも同じです。

部品集を使った回は、時間が約2倍かかった

2回の比べは、図1枚にまとめます。

横棒の図。時間は4分0秒と1分52秒。命令の回数は23回と4回。ファイルの大きさは 1.3MB と 236KB

Astryx の回は、時間の多くを「使い方を調べる」ことに使っていました。23回の命令のうち13回は、説明を読んで、部品の名前と使い方を調べるものでした。

ファイルが大きいのは、部品集のぶんです。社内で数人が使う画面なら、気にする大きさではありません。

画面が1つだけなら、部品集なしのほうが早くできました。部品集の値打ちは、画面が10、20と増えて、見た目をそろえたくなったときに出るはずです。そこは、画面1つを1回ずつ作っただけの今回の実験では、確かめていません。

気をつけること

使う前に知っておくこと
気づいたこと 中身
1回ずつ、画面1つだけ 同じ注文でもう一度頼めば、組み方も、時間も、つまずきの数も変わる
1.0 になる前の版 試したのは 0.7.12。説明書の食い違いは、この時点の話。直っているかもしれない
持ち味の一部は使っていない 見た目を細かく変える仕組みと、付属のひな形は使わなかった。使えば、結果は変わる
確かめたのは2つだけ 開いて表示されることと、絞りこみが動くこと。スマホの幅や、キーボードだけでの操作は見ていない
作る人向けの道具 使うには、React(画面を組み立てるための、よく使われる仕組み)の知識が要る。プログラムを書かない人が、そのまま使えるものではない
場所をとる Astryx の回は、取り寄せた部品が 214MB、取り寄せの控えが 301MB、作業フォルダに入った

自分でやるなら:貼って使える頼み文

初めての道具を AI に使わせるときに、頼みの終わりに足す文です。【 】の所を書きかえてください。部品集にかぎらず使えます。

【使わせたい道具の名前】を使ってください。
使い方は、取り寄せたものの中の説明で確かめてください。
うまく使えなかった所は、正直に報告してください。
できた画面は、自分で開いて、目で確かめてください。
取り寄せのときに自動で動こうとするものは、中身を読んでから判断してください。
画面に出る日本語(人の名前、日付、金額)が、おかしくないかも見てください。

3行目までは、今回じっさいに頼んだ文と同じ中身です。4行目からは、今回の結果を見て足したもので、まだ試していません。

報告が返ってきたら見る所
  • 「使わなかったもの」「やらなかったこと」が書いてあるか
  • 人の名前、日付、金額が、画面でどう出ているか
  • AI が、できた画面を自分で開いて確かめたか
  • 自動で動こうとしたものを、どう扱ったか

実験の記録

実際に頼んだ文を開く

2回に共通の文です。

架空の会社「みなと設備」の、工事の予定を見る社内の管理画面を、React で作ってください。画面は1つ。上に今週の件数などの数字が4つ、その下に工事の一覧(日付、現場、担当、内容、状態)が10件、右に「今日の担当」の一覧。状態で絞りこめること。データは架空のものを画面の中に直接書いてください。npm run build でビルドが通り、dist/ に出ること。Vite を使ってください。

Astryx の回は、こう続けました。

見た目の部品には、Meta が公開しているデザインシステム Astryx(npm の @astryxdesign/core、@astryxdesign/theme-neutral、@stylexjs/stylex。CLI は @astryxdesign/cli)を使ってください。使い方は、入れたパッケージの中の説明や CLI で確かめてください。うまく使えなかった所は、正直に報告してください。

部品集なしの回は、こう続けました。

見た目の部品のライブラリは使わず、自分で CSS を書いてください。

どちらも、最後にこの文を足しています。

今日は2026年11月10日です。このフォルダの外には何も書かないでください。道具を入れる必要があるときは、このフォルダの中に入れてください。

言葉の説明:Vite は、画面のプログラムを仕上げの形に変換する道具。npm は、部品を取り寄せる道具。CLI は、文字で命令を打って使う道具。CSS は、見た目を決める書き方です。

AI の報告の「うまくいかなかった所」を全文で開く
  1. 説明書どうしで食い違いがありました。 テーマのパッケージの README には XDSTheme を使うと書いてあります。ところが実際のパッケージにあるのは Theme でした。core の README と CLI の説明は Theme なので、そちらに合わせました。
  2. StyleX は、パッケージを入れただけで、自分では使っていません。 自分で StyleX の書き方を使うには、ビルドの設定に StyleX 用の変換の仕組みを足す必要があります。今回はそれをせず、Astryx のでき上がった CSS と部品の設定だけで見た目を作りました。そのため、部品の xstyle という見た目の調整機能は使っていません。
  3. CLI が勧めるひな形は使いませんでした。 CLI は table-filter などのひな形を勧めてきます。ただ、これには StyleX の変換の仕組みと、別のパッケージ(lucide-react)が必要です。そこで、ひな形は使わず、部品(Layout、Grid、Card、Table、Badge、SegmentedControl、List、Avatar)を組み合わせて作りました。
  4. アバターの頭文字が日本語の名前に合いませんでした。 「佐藤 健一」が「佐健」と表示されてしまいます。名字だけを渡して「佐」と出るようにしました。
  5. ビルド時に「ファイルが大きい」という注意が出ます。 JS が約 830KB あるためです。エラーではなく、ビルドは成功しています。
  6. 英字のフォントは読みこんでいません。 テーマが使う英字フォント(Figtree)は、外部のサイトから読みこむ必要があります。社内画面なので外部への通信を避け、OS に入っているフォントで表示しています。
  7. インストール時の自動処理は止まりました。 npm の安全のための仕組みで止まりましたが、中身は astryx init を勧めるメッセージを出すだけでした。astryx init は AGENTS.md や CLAUDE.md を書き足すコマンドで、今回は不要なので実行していません。
2回の数字を開く
項目 Astryx 部品集なし
かかった時間 4分0秒 1分52秒
AI が打った命令 23回 4回
できたファイル 1.3MB 236KB
取り寄せた部品 214MB 39MB
AI の利用料の目安 約1.12ドル 約0.36ドル

使ったモデルは、どちらも claude-opus-5-5 です。ファイルの大きさは、でき上がりのフォルダを 2026年11月11日に測り直した値です。絞りこみが動くことも、同じ日に、2つの画面を開いて確かめ直しました。

試したもの
Meta が公開している画面の部品集 Astryx(0.7.12。1.0 になる前の版)と Claude Code
試し方
同じ画面を、Astryx の部品で作る回と、部品集なしで作る回で、1回ずつ
結果
どちらも画面ができ、絞りこみも動いた。Astryx の回は、つまずきを7つ報告した
かかった時間
Astryx 4分0秒、部品集なし 1分52秒