intent-engineering — MCP-сервер для Claude Code
Проверяет спецификации задач для ИИ-агентов по чек-листу из 25 пунктов, собирает новые по шаблону и советует, как переделать старые промпты.
claude mcp add intent-engineering -- npx -y @swins/intent-engineering-mcpЧто делает intent-engineering
Сервер отдаёт агенту три инструмента. audit_intent_spec принимает текст спецификации или путь к файлу и возвращает оценку из 25, замечания по разделам, найденные анти-паттерны и три главные правки. generate_intent_spec_scaffold собирает заготовку YAML нужного вида — пустую, минимальную или полную из девяти разделов. assess_retrofit_level смотрит на готовый промпт или SKILL.md и предлагает уровень переделки L1, L2 или L3 с обоснованием.
Проверки строятся на каноническом скилле intent-engineering: чек-лист из 25 пунктов, пять фатальных анти-паттернов, четыре уровня автономности и шаблон на девять разделов. Сервер ничего не пишет на диск: только читает и рекомендует. Чтение файлов проходит через защиту — белый список расширений, разыменование символических ссылок, ограничение корнем и потолок по размеру. Раньше сервер открывал любой переданный путь, и это была настоящая дыра.
Нужен Node 20+ и клиент, который умеет MCP. Транспорт только stdio, поэтому сервер живёт в процессе клиента и для облачных агентов не годится: автор обещает SSE в версии 1. Разбор заголовков жёсткий, таблица синонимов описана в документации. И ещё: автоматика узнаёт равнозначную цель в тексте, но не придумывает её за вас.
Какие задачи решает
- поймать расплывчатую цель до того, как агент начнёт по ней работать
- получить разбор спецификации по разделу, а не общую оценку
- собрать заготовку спецификации с нужным уровнем детализации
- решить, стоит ли переписывать старый промпт или
SKILL.md - проверить, нет ли в тексте фатальных анти-паттернов
Примеры запросов агенту
- Прогони
audit_intent_specпо файлуspecs/checkout-agent.md - Сделай заготовку через
generate_intent_spec_scaffoldс видом level-1-mvr - Оцени через
assess_retrofit_level, обязательно ли переделывать этотSKILL.md
Как установить intent-engineering
Командой платформы
claude mcp add intent-engineering -- npx -y @swins/intent-engineering-mcpКомандой платформы
codex mcp add intent-engineering -- npx -y @swins/intent-engineering-mcpФайл настроек
{
"mcpServers": {
"intent-engineering": {
"command": "npx",
"args": [
"-y",
"@swins/intent-engineering-mcp"
]
}
}
}Файл настроек
{
"servers": {
"intent-engineering": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@swins/intent-engineering-mcp"
]
}
}
}Командой платформы
gemini mcp add intent-engineering npx -y @swins/intent-engineering-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о intent-engineering
Как установить intent-engineering в Claude Code?
Одной командой: claude mcp add intent-engineering -- npx -y @swins/intent-engineering-mcp. После этого сервер со своими инструментами появится в новой сессии.
Что делает intent-engineering?
Аудит спецификаций по чек-листу из 25 пунктов, генерация заготовок YAML и совет по уровню переделки для существующих промптов. Всё это через три инструмента MCP.
Сервер меняет мои файлы?
Нет, он только читает и рекомендует. Запись на диск не входит в набор инструментов.
