netsuite-ai-connector-instructions — скилл для Claude Code: правила
Скилл задаёт ИИ порядок выбора инструментов NetSuite, формат вывода и правила безопасности SuiteQL. Нужен, если агент ходит в живой аккаунт через MCP-коннектор.
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-codeЧто делает netsuite-ai-connector-instructions
Скилл включается в сессию с NetSuite AI Service Connector и дальше применяется к каждому ответу. Он описывает обязательную очерёдность инструментов: сначала стандартные отчёты, потом сохранённые поиски, затем работа с записями, и только в конце — свой SuiteQL. Агент не должен молча уходить в кастомный запрос: если ни отчёт, ни поиск не подошли, он спрашивает у вас разрешение.
Внутри — таблицы форматирования чисел, шаблоны ссылок на транзакции и сущности, порог, после которого ответ стоит собирать в React-артефакт, и справочник по типам записей NetSuite. Отдельный блок про бухгалтерию: нормальные сальдо счетов, двойная запись, закрытые периоды. Есть и жёсткие запреты — например, ROWNUM <= 1000 в любом запросе SuiteQL и запрет на автоматический повтор упавшего ns_createRecord: сначала проверьте запись в самой NetSuite.
Скилл рассчитан на работу через MCP-коннектор к живому аккаунту, поэтому без подключённого коннектора он ничего не даст. Часть про мультивалютность и мультидочерние компании опирается на поля вроде foreignamount и exchangerate, так что для одновалютного аккаунта эти правила просто не сработают.
Какие задачи решает
- выбрать отчёт вместо самодельного запроса к базе
- собрать дашборд по нескольким метрикам
- показать суммы в миллионах и процентах, а не сырыми числами
- сделать ссылки на счета и заказы кликабельными
- не сломать данные при создании записи через агента
Примеры запросов агенту
- Покажи выручку по дочерним компаниям за квартал
- Найди все неоплаченные счета клиента и дай ссылки на них
- Создай счёт на основе этого заказа
Как установить netsuite-ai-connector-instructions
1Через Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-code2Вручную: положить файлы
~/.claude/skills/netsuite-ai-connector-instructions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/netsuite-ai-connector-instructions/
1Через Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a codex2Вручную: положить файлы
.agents/skills/netsuite-ai-connector-instructions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a cursor2Вручную: положить файлы
.cursor/skills/netsuite-ai-connector-instructions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oracle/netsuite-suitecloud-sdk netsuite-ai-connector-instructions2Вручную: положить файлы
.github/skills/netsuite-ai-connector-instructions/SKILL.md1Через Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a gemini-cli2Командой платформы
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-ai-connector-instructionsВручную: положить файлы
.devin/skills/netsuite-ai-connector-instructions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о netsuite-ai-connector-instructions
Как установить netsuite-ai-connector-instructions в Claude?
Выполните npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-code. Файл скилла окажется в ~/.claude/skills/netsuite-ai-connector-instructions/SKILL.md.
Что делает netsuite-ai-connector-instructions?
Учит агента порядку обращения к инструментам NetSuite, формату чисел и ссылок, основам учёта и безопасной работе с SuiteQL в сессии с MCP-коннектором.
Почему SuiteQL идёт последним?
Скилл требует сначала проверить стандартные отчёты и сохранённые поиски, а кастомный запрос запускать только с вашего подтверждения и с ограничением ROWNUM <= 1000.
