6️⃣ AgentSeed

Антигаллюцинационные защитные барьеры для ИИ-агентов, пишущих код.

Гибридный плагин Agent Plugins (Skill + MCP Server), который приклеивает разработку по спец ификации и проверяет код до того, как он будет помечен как готовый — чтобы «Готово, все тесты проходят» стало наблюдаемым фактом, а not заявлением.

English · 中文 · 日本語

⭐ Нравится проект? Поставьте ему звезду — это помогает разработчикам находить защитные барьеры до того, как они выпустят галлюцинированный код.

Зачем AgentSeed

LLM галлюцинируют — в коде это означает выдуканные API, неопределённые идентификаторы, фальшивые прогоны тестов и самоуверенные преувеличения. Цифры:

• 15,1% галлюцинаций в коде конфликтуют со знаниями: вызываются API, которые не существуют или никогда не были импортированы (arXiv:2404.00971).

• менее 10% галлюцинированного кода падает на тестах — большая часть проскакивает мимо CI (arXiv:2404.00971).

• 60%+ ошибок модельного вывода непроверяемы — нет способа отличить факт от вымысла (FAVA, цитируется в SoK).

Одни только промпты — это «мягкая» защита: модель может согласиться проверить, а затем пропустить проверку. AgentSeed привязывает инструкцию к жёсткому MCP-барьеру — доказательства берутся из выполнния кода, а не из самоотчёта модели.

Он также закрывает дыры, которые спецификация 1.0.0 сознательно оставляет открытыми:

Related MCP server: Metsuke

Что это делает

Шесть MCP-инструментов — ноль обязательных зависимостей, расширяется опциональными дополнениями:

На помеченном синтетическом к究amente (5 дефектных классов): точность 1,0, полнота 1,0 (tp=100, fp=0, fn=0) — результат закреплён регрессионным тестом. Методология и честные границы в docs/BENCHMARK.md.

Живое демо

$ verify_code(source="def f():\n    return magic_unknown()\n", language="python")
{
  "language": "python",
  "suspects": ["magic_unknown"]      # ← hallucinated API caught
}

$ scan_hallucination(source="The feature is production ready, all tests pass. Trust me.")
{
  "hits": [
    {"word": "all tests pass", "group": "oversold", "line": 1},
    {"word": "production ready", "group": "oversold", "line": 1},
    {"word": "trust me", "group": "oversold", "line": 1}
  ],
  "clean": false                      # ← overclaim caught
}

$ check_plugin(path="/path/to/AgentSeed")
{ "ok": true, "errors": [], "warnings": [] }   # ← strict 1.0.0 conformance

Быстрый старт

Вариант A — скачайте релиз (git не нужен):

# grab the latest asset from https://gitcode.com/badhope/AgentSeed/releases
# or use the installer, which drops it into a client of your choice:
bash install.sh --client auto        # macOS / Linux
./install.ps1 -Client auto           # Windows PowerShell
# --client: claude | opencode | cursor | manual

Вариант B — клонируйте:

git clone https://gitcode.com/badhope/AgentSeed.git
# or: https://gitcode.com/badhope/AgentSeed · https://gitee.com/badhope/AgentSeed

1. Перетащите каталог AgentSeed/ в любой клиент, поддерживающий Agent Plugins (Cursor, VS Code, Claude Code, Copilot…). Собирать Bates, loadeb не нуде; обязаней dependencies нет (omмость optional extras ние).

2. Клиент автоматически обнаруживает навык verify-before-code и MCP-сервер agentseed из plugin.json + mcp.json.

3. Всё. Во — навык теперь стоит воротами перед каждой задачей написания кода: кон优雅 → implementation → verify → evidence.

Запустите в вычисленном автономно for 揚:

python3 server/guard_engine.py              # self-check: demo verify_code + scan_hallucination
python3 -m unittest discover -s server      # 90+ unit tests (also: `pytest` in CI)

Отправьте обы smell PR через те же пika (режим CI):

python3 server/guard_cli.py gate --root .    # composite hard gate: conformance
                                             # + symbols + baseline scan, exit 1 on any failure
python3 server/guard_cli.py check . --ci     # plugin conformance only, exit 1 on errors
python3 server/guard_cli.py scan src/ --strict   # hallucination scan, blocking severities only

Примечание для Windows: mcp.json з的없는 сервер через python3. На многих критических участках Windows этот псевдоним — стиб из Microsoft Store; если сервер не запускается, измените command на ["python", "server/guard_server.py"] или укаждите абсолютный путь к вашему интерпретатору.

Необязательные зависимости

AgentSeed запускается на одной только стандартной библиотеке Python. Установка дополнения обновляет два инструментов до индуst риальных движков (автобнаруживание, вемых вловов — graceful fallback в любом случае):

pip install -r server/requirements.txt

Используйте абсолютный путь к guard_server.py; сервер решает всb., в отношении собственного расположения, and специальная cwd не требуется.

Совместимость и деликатная деградация

Подстраивается подойство каждого environment the server, деградируя на один уровень за раз —так нормально, при этом не молчит about verified.

Сам навык carries the degradation path: когда MCP-инструменты недоступюdy, он предписвает агенту intoпла выполнить guard_cli.py verify/scan через shell и применяет те же блокирующие правила к код возврата.

Поддержка платфор

* честные новоsty: форматы spec-compatible and должен работать, но we not запусти AgentSeed и в этих клиентах. (status) — "Проверено" = вся actually -genировано поддерживающими. If у вас проscale: откроите PR об новой таблtицы.

Клиенты поной спецификации такаже уставливают ${PLUGIN_DATA}; AgentSeed из них from ветки agentseed.config.json.

Справочник конфигурации (agentseed.config.json)

Неизвестные ключи печади warned in written text — misspelled key never silently ignored.

Языковое покрытие (честные границы)

⚠️ Примечание по безопасности: sandbox_run выполняет реальные процессы с правами вашего пользователя. Клиенты должны закрывать его за подтверждением пользователя; устанавливайте sandbox_allowed_prefixes в общих/CI‑средах. Когда список разрешений настроен, команды резолвятся через PATH до абсолютного пути перед выполнением — враждебная рабочая директория не может подменить разрешённое базовое имя исполненым файлом, а несовпадgeführtые или необи провнные комады отклонение (код выхода): без выполнения.

Настройка клиента — точная конфигурация

AgentSeed имет две со котовы; обе нужны для полного контроля:

1. Навык (skills/verify-before-code/) — обortчает агента раочому процессу.

2. MCP‑сервер (ver/guard_server.py) — преdotставляет 6 инструментов.

Уsetén. Основной код считаво применяются... Hе мой. Стройки oneвает шаг 1 и вывои шак 2 для вашего клиента. Ручная настройка:

Claude Code

# skill: copy it flat so SKILL.md sits directly in the folder
cp -R skills/verify-before-code ~/.claude/skills/verify-before-code
# MCP server:
claude mcp add agentseed -- python /path/to/AgentSeed/server/guard_server.py

opencode — скопируйте skills/verify-before-code/ в ~/.config/opencode/skill/verify-before-code, затем добавьте в opencode.json:

{
  "mcp": {
    "agentseed": {
      "type": "local",
      "command": ["python", "/path/to/AgentSeed/server/guard_server.py"],
      "enabled": true
    }
  }
}

Cursor / другие MCP‑клиенты — зарегистрируйте stdio‑сервер с command: python, args: ["/path/to/AgentSeed/server/guard_server.py"], и скопируйте папку навыка в расположение навыков вашего клиента.

Используйте абсолютный путь к guard_server.py; сервер сам определяет всё остальное относительно своего расположения, поэтому специальная рабочая директория не нужна.

История изменений

См. CHANGELOG.md.

Встроенная библиотека защитных механизмов (EN / 中文 / 日本語)

Как работает контроль

1. Перед кодом — загрузите контракт SDD и изложи его тогда одним предложением.

2. Реализация — только реальный код: без заглушек, без выдуманных API.

3. Перед словом «done» — вызова очисткoдеocode + scan_hallucination; подтвердите runtime-заявления через sandbox_run; проверьте структуру через schema_validate.

4. Языковой аудит — отчёты о завершение прикладывают доказательства; лексика, преувеличивающая результаты, запрещена.

5. Только когда все проверки пройдены, задача может быть помечена как выполненная.

Принудительные нормы (как ограничивается ИИ)

Навык не просто предлагает поведение — каждая норма привязана к контролю, который следит за её соблюдением:

Эти нормы синтезируют то, на чём публично сошлись сильные операторы агентов — открытый стандарт AGENTS.md, лучшие практики Claude Code от Anthropic и практики сообщества, такие как FerrooLabs/agents-md (позиция старшего инженера, анти‑подхалимаж, принудительные циклы проверки). Разница: там это проза; здесь каждая норма имеет обеспечивающий инструмент или код выхода. Полная таблица с обоснованием в DEFAULT‑NORMSSIL.md.

Совестная работа с вашими конфигурами:

AgentSeed дополан — не зажает — конфигуурные фајл, которые ваша command уже издржит для ИИ‑агентовр програмirty (CLAUDE.md, AGENTS.md, .cursor/rules/, 、.); |

• Эти файлы carrying facts about the stack, от команды, структура, стиль. Они — в тексте, but soft.

• AgentSeed carries the behavioral contract and enforcement: detection hallucinations, verification gates, evidence chains — жёсткие MCP‑инstruments и тажёные; exit codes CI cannot ignores.

• Держите один источник истины по каждому вопросу: направляйте свой AGENTS.md на нормы этого навыка, а не копируйте их; плагин обновляется, а норма остаётся обязательной.

Гдеревнение | Agent Seed vs alternatives

Their| |т их | ... |

We'll maybe skip weird data and correct to Russian proper.

Continuing:

Почему «AgentSeed» — vs. alternative

Roadmap

• Hybrid Skill + MCP‑protection, 6 tools — first strict 1.0.0 Lint;

• [t] tool+ pattern + grouped signals + vendor techniques;

• library verify-code for TypeScript /JavaScript (non-dependency lexical path);

• [] verify_code for Go;

• [] grammar‑constrained decoding for structured output;

• timed optional remote fact‑checking (HHEM‑style) MCP‑server.

FAQ

Нужен ли какой‑то спецvital LLM? Нет — сборка doesn't depend on client or model. Protection is provided by the skill + MCP server, no model.

Zero–dependencies? Whole MCP service is a pure Python standard library.

Does it conform? check_plugin validates plugin per spec (§5/§6/§7) — and AgentFiles passes its own linter (ok: true).

Contributing

Issues, PRs and ideas welcome. See the roadmap for next steps — or open an issue if you find an unrecovered hallucination pattern.

License

Apache‑2.0 © AgentSeed. See LICENSE for details.

⭐ ** If AgentSeed has saved you from shipping hallucinary code, give it a Github star — it's the best signal that guardrails matter. **