コーディングエージェント向けの Hono

Hono はコーディングエージェントに適しています。 API は小さく、 Web 標準の上に構築されているため、エージェントはそのほとんどをすでに知っています。 このページでは、エージェントが Hono でうまく動作するために私たちが提供するものを一覧にしています。

はじめに

プロジェクトを作成し、その中でエージェントを実行してください。

npm create hono@next my-app

テンプレートには、エージェントが必要とするものが含まれています。 アプリの確認方法をエージェントに伝える AGENTS.md と、開発依存関係としての Hono CLI です。 それ以外のセットアップは必要ありません。

エージェント向けのドキュメント

このサイトのすべてのページは Markdown として利用できます。 Accept: text/markdown ヘッダーで取得してください:

curl -H 'Accept: text/markdown' https://hono.dev/docs/api/routing

適切なページを見つけるには、 /llms.txt から始めてください。 すべてのページを1行の説明付きで一覧しています。 /llms-full.txt にはドキュメント全体が1つのファイルに含まれており、 /llms-small.txt はより短いバージョンです。

Hono スキル

Hono Skills は Hono 用の Agent Skills です。 hono スキルは、エージェントにインラインの API リファレンスと Hono CLI でリクエストをテストする方法を提供します。 hono-jsx スキルは hono/jsx を使った UI をカバーします。

skills.sh または GitHub CLI でインストールしてください。 どちらも、エージェントが読み取る場所にスキルを配置します。

# skills.sh
npx skills add honojs/skills

# GitHub CLI
gh skill install honojs/skills hono
gh skill install honojs/skills hono-jsx

Hono CLI

Hono CLI はアプリを直接読み込むため、エージェントはサーバーを起動せずに検査やテストができます。 すべてのコマンドは JSON を出力します。

hono routes          # all routes, without reading the source
hono request /users  # one request, through app.request()
hono batch -         # many requests with expectations, until "failed": 0
hono snapshot        # the current behavior, as batch lines
hono diff            # what changed vs the last commit

hono --help はエージェント向けの注記から始まり、 hono <command> --help には例が含まれています。 それ以外のセットアップは必要ありません。

AGENTS.md

エージェントは、プロジェクトが実行や確認の方法として指定した方法に従います。 AGENTS.md に1行書くだけで、開発サーバーの代わりに Hono CLI を使わせることができます。 残りは hono --help から学習します。 create-hono のテンプレートにはすでに含まれています。

## Hono CLI

Run `npx hono --help` first, and use the CLI instead of a dev server.

または、エージェントに直接伝えてください。 同じ1行がプロンプトとしても機能します。

エージェントは Hono をどの程度うまく使えますか?

私たちはそれを計測しています。 結果は Agent DX をご覧ください。