Hono لوكلاء البرمجة

Hono مناسب جدًا للوكلاء البرمجيين (coding agents). الواجهة البرمجية (API) صغيرة ومبنية على معايير الويب، لذا يعرف الوكيل معظمها بالفعل. تسرد هذه الصفحة ما نقدمه لكي يعمل الوكلاء بشكل جيد مع Hono.

البدء

أنشئ مشروعًا، ثم شغّل وكيلك فيه.

npm create hono@next my-app

تأتي القوالب بما يحتاجه الوكيل: ملف AGENTS.md يخبر الوكيل بكيفية فحص التطبيق، و Hono CLI كاعتمادية تطوير. لا شيء آخر لإعداده.

التوثيق للوكلاء (agents)

كل صفحة في هذا الموقع متاحة بصيغة Markdown. يمكنك جلبها باستخدام Accept: text/markdown header:

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

للعثور على الصفحة الصحيحة، ابدأ من /llms.txt. يسرد كل صفحة مع وصف من سطر واحد. /llms-full.txt يحتوي على التوثيق بالكامل في ملف واحد، و /llms-small.txt نسخة أقصر.

مهارات Hono

مهارات Hono هي مهارات الوكيل لـ Hono. إن hono تمنح المهارة الوكيل مرجعًا سطريًا لواجهة API وطريقة اختبار الطلبات باستخدام Hono CLI. hono-jsx تغطي المهارة واجهة المستخدم بـ hono/jsx.

ثبِّتها باستخدام 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 يحمّل تطبيقك مباشرة، لذا يمكن للوكيل (agent) فحصه واختباره دون تشغيل خادم. كل أمر يطبع 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 يبدأ بملاحظة للوكيل (agent)، و hono <command> --help يحتوي على أمثلة. لا حاجة لإعداد آخر.

AGENTS.md

تتبع الوكلاء (Agents) الطريقة التي يحددها مشروعك لتشغيل الأمور والتحقق منها. سطر واحد في AGENTS.md كافٍ لدفعهم لاستخدام Hono CLI بدلاً من خادم التطوير. يتعلم الوكيل البقية من hono --help. قوالب create-hono تحتوي عليه بالفعل.

## Hono CLI

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

أو قل ذلك للوكيل (agent) مباشرة. السطر نفسه يعمل كمطالَبة (prompt).

ما مدى جودة استخدام الوكلاء لـ Hono؟

نحن نقيسه. راجع Agent DX للنتائج.