Этап 4: Настройка правил

Теория

Зачем нужны правила?

Правила говорят OpenCode: - Как писать код (стиль, формат) - Какие команды использовать - Чего избегать (опасные операции)

Типы правил

Тип	Файл	Где хранится
Проектные	AGENTS.md	Корень проекта (в Git)
Глобальные	AGENTS.md	~/.config/opencode/
Конфигурация	opencode.json	Корень проекта

AGENTS.md vs opencode.json

• AGENTS.md — инструкции на естественном языке
• opencode.json — настройки агентов, провайдеров, прав

---

Практика

Шаг 1: Отредактируйте AGENTS.md

Откройте файл AGENTS.md в корне проекта и добавьте правила:

# Правила проекта

## Стиль кода
- Используй TypeScript strict mode
- Форматируй код через Prettier
- Пиши комментарии на русском языке

## Команды
- Запуск: npm start
- Тесты: npm test
- Линтинг: npm run lint

## Запреты
- Не используй any в TypeScript
- Не удаляй файлы без подтверждения

Шаг 2: Создайте глобальные правила

Создайте файл для личных правил (не в Git):

1. Откройте Проводник и перейдите в папку вашего профиля (например, C:\Users\ВашеИмя\)
2. Откройте папку .config\opencode (если её нет — создайте через правый клик → Создать → Папку)
3. Нажмите правой кнопкой мыши в папке → Создать → Текстовый документ
4. Назовите файл AGENTS.md и сохраните его через Блокнот

Добавьте личные правила:

# Мои личные правила

## Язык
- Всегда отвечай на русском языке
- Объясняй просто, без сложных терминов

## Формат
- Показывай код в блоках
- Давай краткие объяснения

Шаг 3: Настройте opencode.json

Создайте файл opencode.json в корне проекта:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/big-pickle",
  "small_model": "opencode/gpt-5-nano",
  "instructions": ["AGENTS.md", "CONTRIBUTING.md"],
  "agent": {
    "build": {
      "permission": {
        "edit": "allow",
        "bash": {
          "npm *": "allow",
          "git *": "ask",
          "rm *": "deny"
        }
      }
    },
    "plan": {
      "permission": {
        "edit": "deny",
        "bash": "deny"
      }
    }
  }
}

Шаг 4: Настройте права доступа (permissions)

Permissions контролируют, что агенты могут делать:

Право	Описание
edit	Изменение файлов
bash	Запуск команд
read	Чтение файлов

Примеры настройки:

Разрешить npm, спрашивать при git, запретить удаление:

"bash": {
  "npm *": "allow",
  "git *": "ask",
  "rm *": "deny"
}

Шаг 5: Проверьте работу правил

1. Запустите OpenCode
2. Попросите создать файл: Создай файл test.ts с функцией hello
3. OpenCode должен создать файл
4. Попросите удалить файл: Удали файл test.ts
5. Должно появиться подтверждение

---

Задание

1. Отредактируйте AGENTS.md — добавьте стилистические правила
2. Создайте глобальные правила в ~/.config/opencode/AGENTS.md
3. Создайте opencode.json с настройками агентов
4. Настройте permissions для bash-команд
5. Проверьте, что правила работают

---

Чек-лист

• [ ] AGENTS.md отредактирован
• [ ] Глобальные правила созданы
• [ ] opencode.json создан
• [ ] Permissions настроены
• [ ] Правила работают правильно

---

Примеры правил

Стиль кода

## Стиль
- Используй 2 пробела для отступов
- Пиши функции короткими
- Давай осмысленные имена переменных

Команды

## Команды
- Сборка: make build
- Тесты: make test
- Деплой: make deploy

Запреты

## Запреты
- Не коммить секреты
- Не изменяй конфиги без спроса
- Не делай force push

---

Советы

1. Храните AGENTS.md в Git — правила должны быть у всей команды
2. Глобальные правила — личные — не коммитьте их
3. Начинайте просто — добавляйте правила по мере необходимости

---

Предыдущий этап: Создание проекта Следующий этап: Тестовый проект