インストールしたら、いつもどおりに質問してください。
```
> Explain the TCP three-way handshake
> Map out how the modules in this repo fit together
> Redis or Memcached for our cache?
```
エージェントが短い Markdown の下書きを書き、スキルに同梱された CLI に渡します。約 50 ms 後には、ページができあがります。
https://github.com/user-attachments/assets/d3063a28-5dfd-4c44-a562-be901c49b249
エージェントは、ページの場合と同じ種類の下書きに加えて、ビートごとに 1 行のナレーションを書きます。それ以外は何もありません。
````markdown
## Both sides wait
```sequence
Client -> Server: SYN
Server -> Client: SYN-ACK
```
> The client sends a SYN to ask for a connection.
> The [Server] answers with a SYN-ACK.
````
`am video` がこれをプレーヤーのページに変換します。図はナレーションに合わせて一歩ずつ組み上がり、カメラは角かっこで名前を示したノードを追います。音声はページの中にあるので、オフラインでも再生できます。プレーヤーには、シーンの間を移動するチャプターストリップ、速度ボタン、ブラウザーの中で動画をエンコードしてダウンロードするエクスポートボタン(ローカルファイルまたは `localhost`、ffmpeg は不要)があります。MP4 ファイルが欲しい場合は `--mp4`(ffmpeg が必要)を、ページが自分でエンコードする WebM ファイルが欲しい場合は `--webm`(ffmpeg は不要)を追加します。エージェントが動画を作るのは、あなたが頼んだときだけです。詳しくは[動画ガイド](docs/video.md)をご覧ください。
## 設定
設定はスラッシュコマンドで変更します。手で編集する設定ファイルはありません。
| 場所 | 方法 |
| :--- | :--- |
| Claude Code(プラグインでのインストール) | `/answer-me-with-html:config` で何を変更するかを尋ねられます。`/answer-me-with-html:config open off` で直接変更します |
| すべてのエージェント | `/answer-me-with-html config open off`、または「ブラウザーを開かないで」と言うだけです |
| ターミナル | 表示は `am config`、変更は `am config set open off`、デフォルトに戻すには `am config reset` |
設定は `open`(ページをブラウザーで開く)、`theme`、`mode`(ライトまたはダーク)、`style`(文章チェック)、`scale`(ページの文字サイズ。図とグラフも合わせて大きくなります)、`pages_dir`(ページの出力先フォルダー)、`update_check`、`close_after_reply`(返信をコピーしたらタブを閉じる)、`voice`(動画のナレーション)です。デフォルトと値:[リファレンス](docs/reference.md#settings)。
## 常時モード(推奨)
常時モードでは、**すべての結論にページが付きます**。エージェントが結論、要約、計画、比較を示すときは、短いものでも、2 ~ 4 個のパネルからなる小さなページを追加し、返信の最後にそのパスを置きます。これらのページが自動で開くことはないので、作業を邪魔しません。雑談や、結論のない返信はそのままです。Claude Code は、プランモードではページを作りません。
デフォルトではオフです。おすすめします。ページを頼む必要がなくなり、短い答えも長い答えと同じくらい読みやすくなります。ページは `~/.answer-me-with-html/` にたまっていくので、`am clean` で消してください。オンにするには、次の文をエージェントに貼り付けて、`~/.claude/CLAUDE.md` や `AGENTS.md` などのルールファイルにルールを書いてもらいます。
> Turn on always-on mode for Answer me with HTML: add a global rule — "[answer-me-with-html always-on] Whenever a reply gives a conclusion, summary, plan, comparison, review or explanation, even a short one, also make a page with the answer-me-with-html skill (2 to 4 panels for routine answers), render it with --no-open before you write the reply, and end the reply with the page link in the format SKILL.md specifies for your host. Skip casual chat, one- or two-sentence replies with no conclusion, pure command output, and requests for plain text. An internal report to another agent is not a user reply: return the findings and evidence the parent asked for, and make no page unless the task explicitly asks for one."
オフにするには、そのルールを削除します。ページの数を減らしたい場合は、[控えめにする](docs/reference.md#less-proactive)をご覧ください。
## 更新と後片付け
更新は手動です。CLI は使われたときに、バックグラウンドで GitHub の新しいバージョンを 1 日に 1 回まで確認します。新しいバージョンがあれば、エージェントに 3 日に 1 回まで知らせます。あなたに関する情報は何も送信されません。更新するには、エージェントに「answer-me-with-html を更新して」と伝えます。ページは `~/.answer-me-with-html/` にたまっていきます。「ページを片付けて」と言えば、エージェントは何かを削除する前に確認します。ほかのインストール方法とすべてのオプション:[リファレンス](docs/reference.md#updating-and-cleaning-up)。
## 背景
Andrej Karpathy は、LLM がより多くの仕事をこなすようになるにつれ、その出力についていくことが難しくなると[投稿しました](https://x.com/karpathy/status/2105819303471976479)。図や Web ページは、長いテキストのかたまりよりもずっと頭に入りやすいものです。
私はエージェントに直接 HTML で答えるよう頼んでみました。ページは良いものでしたが、遅かったのです。まともなページに 1 ~ 2 分かかり、その大半は毎回ほとんど同じ数百行の CSS でした。図はさらにひどいものでした。モデルは SVG の座標を手で計算しなければならず、矢印が何もない場所を指していることもよくありました。
そこで Answer me with HTML は、その作業をモデルから取り除きます。モデルは内容を書きます。レイアウト、色、描画は CLI が担当します。
## しくみ
モデルが書くのは、これだけです。
````markdown
---
title: TCP three-way handshake
---
## A Three-way handshake {span=2}
```sequence num
Client -> Server: SYN, seq=x
Server -> Client: SYN+ACK, seq=y, ack=x+1
Client -> Server: ACK, ack=y+1
note Client, Server: ESTABLISHED
```
## C State changes {span=2}
```flow LR
(CLOSED) -> LISTEN: passive open
LISTEN -> SYN_RCVD: get SYN / send SYN+ACK
SYN_RCVD -> *ESTABLISHED: get ACK
```
````
残りは CLI が行います。テンプレートを選び、パネルを配置し、テーマを適用し、[dagre](https://github.com/dagrejs/dagre) でフローチャートをレイアウトし、ラベルの幅に合わせてシーケンス図の間隔を決めます。下書きの全体である [examples/tcp.en.md](examples/tcp.en.md) は、次のページになります。