agentforce-adlc
SalesforceAIResearch/agentforce-adlcНабор Claude Code скиллов для полного цикла работы с Agentforce: создание .agent-файлов через Agent Script DSL, деплой, тестирование и оптимизация на основе данных сессий. Встроенная LLM-проверка безопасности на каждом этапе.
Установка
git clone https://github.com/SalesforceAIResearch/agentforce-adlc.gitREADME
agentforce-adlc
Agent Development Life Cycle — сборка, деплой, тестирование и оптимизация Agentforce-агентов с помощью Claude Code скиллов и Agent Script DSL.
Что это такое?
agentforce-adlc предоставляет полный набор Claude Code скиллов для всего жизненного цикла Agentforce-агента — от требований до оптимизации в продакшене. Claude напрямую создаёт .agent-файлы, используя Agent Script DSL.
Ключевые особенности
- Прямое создание — Claude генерирует
.agent-файлы нативно, без конвертации из markdown - Полный цикл — создание, обнаружение, скаффолдинг, деплой, тестирование и оптимизация в одном инструменте
- Встроенная безопасность — LLM-проверка безопасности на всех этапах (создание, деплой, тест, оптимизация)
- Детерминированные агенты — Agent Script DSL обеспечивает гарантии на уровне кода (условия, охранные выражения, переходы)
- Анализ трассировок сессий — извлечение STDM-данных из Data Cloud для оптимизации на основе данных
- 3 консолидированных скилла — разработка, тестирование и наблюдаемость по стандарту agentskills.io
Пайплайн
User prompt
| /developing-agentforce
v
+--------------------------+
| Safety Review (Phase 0) |<-- LLM-driven, 7 categories
| .agent file generated |
+--------+-----------------+
| /developing-agentforce (discover)
v
+--------------------------+
| Check org for targets |--missing--> scaffold stubs
+--------+-----------------+
| /developing-agentforce (deploy)
v
+--------------------------+
| Safety Gate -> Validate |<-- Pre-publish check
| -> Publish -> Activate |
+--------+-----------------+
| /testing-agentforce
v
+--------------------------+
| Preview + Batch tests |<-- Safety probe utterances (adversarial)
| + Action execution |
+--------+-----------------+
| /observing-agentforce
v
+--------------------------+
| STDM session analysis |<-- Safety issue detection in traces
| -> Reproduce -> Improve |
+--------------------------+
Каждый скилл можно вызывать независимо. Запустите /testing-agentforce для существующего агента, не затрагивая этапы разработки. Запустите /observing-agentforce на данных продакшен-сессий без повторного деплоя.
Установка
Claude Code плагин (рекомендуется)
# Клонируйте репозиторий
git clone https://github.com/SalesforceAIResearch/agentforce-adlc.git
# Вариант A: Загрузить напрямую (для разработки)
claude --plugin-dir ./agentforce-adlc
# Вариант B: Установить через маркетплейс
claude plugin marketplace add ./agentforce-adlc
claude plugin install adlc@agentforce-adlcПри установке как плагина скиллы получают пространство имён: /adlc:developing-agentforce, /adlc:testing-agentforce, /adlc:observing-agentforce.
Установка копированием файлов (Cursor или устаревший Claude Code)
# Установка одной командой
curl -sSL https://raw.githubusercontent.com/SalesforceAIResearch/agentforce-adlc/main/tools/install.sh | bash
# Или из локального клона
python3 tools/install.py # Автоопределение Claude Code / Cursor
python3 tools/install.py --target cursor # Только CursorУправление после установки
# Управление плагином
claude plugin list # Список установленных плагинов
claude plugin update adlc@agentforce-adlc # Обновить плагин
claude plugin uninstall adlc@agentforce-adlc # Удалить плагин
# Управление при копировании файлов (устаревший способ)
python3 ~/.claude/adlc-install.py --status
python3 ~/.claude/adlc-install.py --update
python3 ~/.claude/adlc-install.py --uninstallПосле установки перезапустите IDE. Скиллы доступны в любом проекте.
Что и куда устанавливается
| Компонент | Плагин (Claude Code) | Копирование файлов (~/.claude/) | Копирование файлов (~/.cursor/) |
|---|---|---|---|
| Скиллы | Автообнаружение из skills/ | skills/*-agentforce/ | skills/*-agentforce/ |
| Агенты | Автообнаружение из agents/ | agents/adlc-*.md | Н/Д |
| Хуки | Через hooks/hooks.json | hooks/scripts/adlc-*.py | Н/Д |
| Настройки | settings.json (агент по умолчанию) | Записи в settings.json | Н/Д |
Установка плагина самодостаточна — файлы не копируются в ~/.claude/. Установщик с копированием файлов предназначен для Cursor и устаревших конфигураций Claude Code.
Предварительные требования
- Python 3.9+ — проверьте командой
python3 --version. Если версия старше, обновите:brew install python@3.13(macOS) /sudo apt install python3.13(Ubuntu) / python.org (Windows) - Salesforce CLI (
sf) v2.x — руководство по установке - Claude Code (
~/.claude/) или Cursor (~/.cursor/) — необходимо хотя бы одно - Salesforce org с включённым Agentforce
Быстрый старт
1. Сборка и деплой (/developing-agentforce)
Один скилл для полного рабочего процесса разработки — создание, обнаружение, скаффолдинг и деплой:
/developing-agentforce
Build a service agent that helps customers check order status,
request returns, and track shipments. It should verify identity
before showing order details. Deploy to my-org.
Скилл выполнит:
- Создание — сгенерирует
.agent-файл с топиками, действиями, переменными и детерминированной логикой - Обнаружение — проверит, какие Flow/Apex/Retriever-цели существуют в org
- Скаффолдинг — сгенерирует заглушки для отсутствующих целей (Flow XML, Apex-классы, тестовые классы, PermSets)
- Деплой — валидирует, публикует authoring bundle и активирует агента
Каждую фазу можно запустить отдельно (например, «только обнаружить цели для OrderService.agent»).
2. Тестирование агента (/testing-agentforce)
/testing-agentforce
Smoke test OrderService against my-org with these utterances:
- "Where is my order #12345?"
- "I want to return my recent purchase"
- "What's the shipping status?"
Запускает preview-сессии, анализирует трассировки и выводит отчёт о точности маршрутизации топиков и успешности выполнения действий. Также поддерживает пакетное тестирование через Testing Center и тестирование отдельных действий.
3. Наблюдение и оптимизация (/observing-agentforce)
/observing-agentforce
Analyze last week's sessions for OrderService in my-org.
Find failure patterns and suggest improvements.
Извлекает STDM-данные из Data Cloud, выявляет паттерны сбоев, воспроизводит проблемы и предлагает улучшения .agent-файла.
Структура репозитория
agentforce-adlc/
├── skills/
│ ├── developing-agentforce/ # Скилл разработки
│ ├── testing-agentforce/ # Скилл тестирования
│ └── observing-agentforce/ # Скилл наблюдаемости
├── agents/ # Конфигурации агентов
├── hooks/ # Хуки жизненного цикла
├── tools/ # Скрипты установки
└── settings.json
Лицензия
Apache 2.0 — подробности в файле LICENSE.