Instalace AI vývojáře mcptask_runner

Čtyři odpovědi o stroji a jeden příkaz, který musí doběhnout čistě. První, co runner na Rails projektu udělá, je zavolat binstuby projektu — a ty fungují až ve chvíli, kdy jsou gemy nainstalované.

ruby --version

Verze, kterou pojmenovává .ruby-version projektu, ne ta, kterou přináší operační systém — na nesoulad si bundle install stěžuje jako na první věc.

bundle --version

Bundler se instaluje s Ruby, takže obvykle odpoví hned, jak odpoví řádek nad ním.

bin/rails --version

Binstub projektu, ne globální rails: je to verze, se kterou projekt skutečně startuje.

bundle install

Tohle musí doběhnout čistě dřív, než runner vůbec začne. Nativní rozšíření, které se tady nepodaří přeložit, se nepodaří přeložit ani v žádném běhu bez dozoru — ve tři ráno, kdy se nikdo nedívá.

bin/rails assets:precompile RAILS_ENV=test

Tento řádek za vás runner nepřidá: je frameworkově neutrální a žádný Rails-specifický příkaz do promptu neposílá. Pokud systémové testy potřebují přeložené CSS, uveďte tento krok v CLAUDE.md nebo v bin/ci svého projektu, jinak budou testy padat.

Ruby on Rails je jediný framework, který mění instalační kanál — wrapper gem místo Homebrew, curlu nebo scoopu. To patří na další obrazovku; tady s tím není co dělat.

Python 3, virtualenv, který je opravdu aktivní, a django-admin, který odpovídá zevnitř. Prostřední bod je místo, kde se to láme: instalace do systémového Pythonu vypadá, že prošla, a pak ve chvíli, kdy runner zavolá, není k nalezení.

python3 --version

Pod jménem python3 — na stroji, kde python pořád ukazuje na 2.x, je to jediné jméno, které odpovídá spolehlivě.

source .venv/bin/activate && which python

Cesta musí vést dovnitř projektu. Když se vypíše /usr/bin/python, virtualenv aktivní není a všechno níž se nainstaluje do systémového Pythonu.

django-admin --version

Spusťte s aktivním virtualenvem. Verze vypsaná z globální instalace není ta, se kterou projekt běží.

PHP, Composer a artisan. Všechny tři odpoví během vteřiny a třetí navíc dokazuje, že stojíte v kořeni projektu — artisan je soubor v projektu, ne příkaz v PATH.

php --version

Verze, kterou si žádá composer.json projektu — Laravel 11 chce 8.2 nebo novější.

composer --version

Composer instaluje závislosti projektu stejně, jako to pro Ruby dělá bundler, takže ho runner potřebuje dřív, než může cokoli spustit.

php artisan --version

Spouštějte z kořene projektu. Když se nevypíše nic, je to obvykle špatný adresář, ne chybějící Laravel.

Runner spouští vlastní npm skripty projektu, takže odpovědět musí dvě věci: samotný Node a package manager, který pojmenovává lockfile.

node --version

Stačí jakékoli aktuální LTS — kontroluje se, že se verze vůbec vypíše.

ls package-lock.json pnpm-lock.yaml yarn.lock 2>/dev/null

Lockfile, který se vypíše, pojmenovává package manager projektu: package-lock.json je npm (instaluje se s Nodem), pnpm-lock.yaml je pnpm, yarn.lock je yarn. Nainstalujte právě ten — špatný tip je tady první matoucí chyba.

Node.js projekt dostane na další obrazovce druhý instalační kanál: npx @mcptask/cli init — npm wrapper. OS kanál výše pořád funguje; výběr mezi nimi patří další obrazovce.

React běží na Nodu, takže toolchain je stejný, jaký kontroluje obyčejný Node.js projekt — stejný Node, stejný package manager, nic navíc se neinstaluje. Jediný poctivý rozdíl je vstupní bod, který projekt sám deklaruje pro develop a test.

node --version

Stačí jakékoli aktuální LTS — kontroluje se, že se verze vůbec vypíše.

ls package-lock.json pnpm-lock.yaml yarn.lock 2>/dev/null

Stejné jako u Node.js — lockfile, který se vypíše, pojmenovává package manager, který se má nainstalovat.

node -p "Object.keys(require('./package.json').scripts)"

Tohle jsou příkazy, které runner nakonec zavolá — dev server a test vstup vycházejí z tohoto seznamu, takže v něm dev a test musí být.

React projekt dostane na další obrazovce stejný npm kanál jako Node.js projekt: npx @mcptask/cli init.

JDK a build tool, který projekt nese s sebou — Gradle nebo Maven rozhoduje projekt, ne vy, a ten špatný padne na prvním spuštění.

java -version

Verze se vypisuje na stderr, takže se ukáže tak jako tak — kontroluje se, že vůbec odpovědělo JDK.

ls build.gradle build.gradle.kts pom.xml 2>/dev/null

Soubor, který se vypíše, pojmenovává build tool: soubor Gradle znamená Gradle, pom.xml znamená Maven.

./gradlew --version

Použijte wrapper projektu, ne systémovou instalaci — nese ho každý Gradle projekt a fixuje verzi, se kterou se projekt builduje. Maven projekt řekne místo toho ./mvnw --version.

Android je Java projekt plus build toolchain: JDK, pak Gradle, pak Android SDK — a pokud jsou testy projektu instrumentation testy, musí být dosažitelné i zařízení nebo emulátor.

java -version

Gradle běží na JDK, takže tahle odpověď otevírá všechno pod ní.

./gradlew --version

Každý Android build jde přes Gradle — na rozdíl od obyčejného Java projektu tu žádná Maven varianta k detekci není.

adb --version

adb je součást platform-tools SDK, takže vypsaná verze dokazuje, že SDK je nainstalované.

adb devices

Stačí jeden vypsaný emulátor nebo zařízení — záleží na tom jen tehdy, když projekt spouští instrumentation testy, a nic jiného na téhle stránce si chybějícího nevšimne.

Samotné Xcode, jeho command line tools a xcodebuild — všechny tři existují jen na macOS, proto vám picker tenhle framework nikde jinde nenabídl.

xcode-select -p

Cesta k nástrojům příkazové řádky. Dokud Xcode není nainstalované, stačí i odpověď /Library/Developer/CommandLineTools, pro další krok už ale Xcode nainstalované být musí.

xcodebuild -version

Jedna odpověď za Xcode i jeho ovladač xcodebuild — a verze musí být ta, se kterou projekt builduje, ne nejnovější, kterou App Store nabízí.

xcrun simctl list devices available | grep -c iPhone

Cokoli nad nulu stačí — záleží na tom jen tehdy, když testy projektu startují simulátor.

Nic nad rámec kontrol výše. To je celá odpověď, ne blok, který se nenačetl: projekt stavěný Makefilem, shellovým skriptem nebo ničím nemá žádný frameworkový toolchain ke kontrole, takže git s originem na GitHubu, Bitbucket Cloudu nebo GitLabu a přihlášené kódovací CLI jsou celý seznam.