Agents Best Practices

agents-best-practices

Скилл проектирования агентных систем без привязки к вендору: архитектура цикла, инструменты, права, память и наблюдаемость

СкиллНизкий риск

denissergeevitch/agents-best-practices

Установка

npx skills add DenisSergeevitch/agents-best-practices -g

Флаг -g ставит скилл на уровне пользователя для всех проектов.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл помогает проектировать, собирать MVP, аудировать, рефакторить и объяснять агентные обвязки для любой предметной области. Он задает базовую архитектуру: модель предлагает действие, обвязка проверяет схему, решает про права, выполняет или ставит на паузу для подтверждения, возвращает структурированное наблюдение и обновляет контекст. Разбор охватывает дизайн инструментов, лимиты цикла, компакцию контекста, память, скиллы, внешние коннекторы, наблюдаемость, оценки и безопасность. Подход провайдер-нейтральный и годится не только для кодинг-агентов, но и для исследовательских, поддержки, операций, финансов, юридических и других процессов.

Для кого. Для инженеров и продуктовых команд, которые проектируют и разбирают агентные системы.

Подходит, если

  • Проектируете обвязку агента для новой предметной области
  • Аудируете существующего агента на надежность, стоимость и безопасность
  • Выбираете между прямыми циклами инструментов, хостовыми инструментами и SDK

Не подходит, если

  • Нужен обычный одноходовый текст, перевод или ответ на вопрос
  • Задача не связана с проектированием агента

Пример запроса к агенту

Спроектируй MVP-обвязку для агента, который читает CRM и черновики писем, с подтверждением отправки

Ограничения

Скилл дает архитектурные принципы и блюпринты, а не готовый код обвязки под конкретный фреймворк. Материал состоит только из инструкций и справочников.

Как отключить. Удалите папку agents-best-practices из каталога скиллов агента.

Проверка безопасности

  • Скилл состоит только из инструкций и справочников

Коротко о README

README представляет провайдер-нейтральный скилл для проектирования, генерации MVP, аудита и рефакторинга агентных обвязок. Установка через npx skills с глобальным флагом, готовым промптом для агента или ручным клонированием в каталог скиллов. Приводится семь типовых сценариев, от генерации блюпринта под домен до аудита существующего агента с порядком исправлений. Ключевая идея: модель предлагает действия, а обвязка их проверяет, авторизует, выполняет и записывает. Лицензия MIT.

SKILL.md

---
name: agents-best-practices
description: "Use this skill when designing, generating an MVP blueprint for, auditing, refactoring, or explaining an agentic harness for any domain. Covers provider-neutral agent architecture for OpenAI, Anthropic, and OpenAI-compatible APIs: agent loops, tool design, record provenance, interactive presentation, user-memory lifecycles, environment-adaptive tools, speculative tool execution, late-bound capabilities, permissions, system prompts, planning, goals, context compaction, memory, skills, MCP/external connectors, public-board communications, self-refining recursive harnesses, programmable context, continual refinement, observability, evals, prompt caching, agent-legible environments, feedback loops, and safety."
metadata:
  version: "1.7.0"
  scope: "provider-neutral-agent-harness"
  file_policy: "markdown-only"
---

# Agents Best Practices

Use this skill when the user asks how to build, improve, debug, or evaluate an agentic harness.

Частые вопросы

Только для кодинг-агентов?

Нет, принципы применимы к исследовательским, финансовым, юридическим, операционным и другим агентам.

Привязан ли скилл к одному API?

Нет, он провайдер-нейтральный и покрывает OpenAI, Anthropic и совместимые API.

Выбор редакции

Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами

CLIВысокий риск389,7 тыс.
Выбор редакции

Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам

CLIВысокий риск245,6 тыс.
Выбор редакции

Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования

CLIВысокий риск207,4 тыс.
Выбор редакции

Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента

ПлагинСредний риск170,4 тыс.