Швидкий старт

Опублікуйте інструкцію, а потім прочитайте її так, як це робить агент. Близько п’яти хвилин, у терміналі. (Не хочете користуватися терміналом? Пишіть і публікуйте в редакторі.)

1. Встановіть CLI

Shell
npm install -g instruction.md
instruction --version

Усе, що працює без мережі (команди validate, format, deliver, digest), доступне без облікового запису.

2. Напишіть документ

Shell
instruction init support-agent --template agent

Ця команда створює заготовку support-agent.md. Найпростіший документ виглядає так:

support-agent.md
---
spec: "1"
title: Support agent
---
# Support agent

You answer billing questions for Acme.

MUST[verify-identity]: verify the customer's identity before discussing an account.
BECAUSE: an account holds another person's data.

3. Подивіться, що отримає агент

Shell
instruction validate support-agent.md
instruction deliver support-agent.md environment=staging

У цьому й полягає суть специфікації: байти визначено, тож те, що ви бачите тут, отримує кожна програма-читач, яка їй відповідає. instruction validate перелічує все в документі, через що публікацію було б відхилено. Шаблон agent оголошує обов’язковий параметр environment; deliver приймає його значення у вигляді name=value і вписує його в текст.

4. Увійдіть і опублікуйте

Shell
instruction login
instruction push support-agent.md --visibility public --publish --message "first version"

Тепер у вас є незмінна версія та посилання (ref) @latest, яке на неї вказує. Документ має канонічний ідентифікатор і адресу, за якою стежать агенти: instruction://<you>/support-agent.

5. Прочитайте її як агент

Shell
instruction watch instruction://<you>/support-agent@latest --out AGENT.md

Ця команда стежить за посиланням: вона записує доставлений документ і переписує його щоразу, коли ви публікуєте. Зупиніть її клавішами Ctrl-C. Агент робить те саме через MCP, без періодичних запитів, за підпискою (потік subscriptions/listen; саме так про зміну дізнається і watch).

6. Опублікуйте зміну

Shell
instruction push support-agent.md --to <id> --publish --message "tighten the refund rule"

Усе, що стежить за @latest, отримає її. Якщо вам потрібне посилання, яке пересувається лише свідомо, публікуйте в @stable і спрямуйте агентів на нього.

Далі