이 도구에 대하여
Laravel Tackle은 Laravel을 위한 AI 에이전트 하네스입니다. 코드베이스를 읽고, 테스트를 실행하고, PR을 검토하고, 의존성을 업그레이드하고, 실패한 작업을 복구하는 코딩 에이전트를 제공하며 Composer를 통해 설치됩니다.
주요 기능
- 코딩 에이전트:
CodingAgent를 구현하는 클래스는 프롬프트를 받아 도구를 호출하고 결과를 반환합니다. - 명령 스위트:
ai:code,ai:upgrade,ai:eval,ai:explain,ai:fix,ai:onboard,ai:respond,ai:review,ai:run,ai:test. - 의존성 업그레이드:
ai:upgrade는 격리된 worktree에서 Composer 의존성의 안전한 메이저 버전 업그레이드를 감사, 계획, 해결, 수정, 검증하고 PR로 제공합니다. - 코드 리뷰:
ai:review는 읽기 전용 에이전트로 git diff를 검토하고 실제 문제를 심각도 수준과 함께 표시합니다. - 테스트 생성:
ai:test는 모든 클래스나 메서드에 대한 Pest 테스트 파일을 생성합니다. - 문제 수정:
ai:fix는 붙여넣은 예외, Sentry 문제(--sentry=ID) 또는 GitHub 문제(--issue=N)를 받아 에이전트가 진단, 패치, 검증합니다. - CI 및 cron:
ai:run은 터미널 없이 동일한 에이전트를 실행하여 하나의 작업, JSON 결과, 종료 코드를 반환합니다. - PR 상호작용:
ai:respond는 풀 리퀘스트에 남긴/tackle댓글에 따라 요청된 변경을 적용하고 PR 브랜치에 푸시하며 스레드에 답변합니다. - 개발자 온보딩:
ai:onboard는 코드베이스의 안내식 읽기 전용 투어를 제공하고 질문에 답변합니다. - 벤치마킹:
ai:eval은 시드된 버그에 대해 에이전트를 벤치마킹합니다 — 수정률, 오수정률, 토큰, 비용.
아키텍처 및 안전
laravel/ai위에 구축되었으며 마찬가지로 제공자에 구애받지 않습니다. Tackle은 도구 호출을 지원하는 모든laravel/ai제공자에서 실행됩니다.- 모든 에이전트는 동일한 도구 인프라와 안전 계층을 통해 실행됩니다.
NetworkExfiltrationGuard는 에이전트 작성 코드의 아웃바운드 HTTP,curl ... | sh, 외부 curl/wget과 같은 유출 전송을 플래그합니다. 모드는 block(기본), confirm, off입니다.
사용 및 구성
- Composer를 통해 설치.
- 구성 게시:
php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider". php artisan ai:code를 실행하고 작은 테스트 작업을 입력하여 연결을 확인합니다.- 메이저 업그레이드는 긴 세션입니다 — 시작 전에
AI_CODE_BUDGET을 기본 $1 이상으로 높이는 것을 고려하세요. laravel/ai >=0.1 <0.11이 필요합니다.laravel/ai 0.1.x자체는 PHP ^8.4를 요구하며 PHP 8.3에서는 Composer가 0.2 이상을 해결합니다.
오픈 소스 및 상업화
- 오픈 소스, 무료.
- 학습 곡선: 중간.
기능 및 사용 사례
[ ] Publish the laravel/ai config: php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"[ ] Run php artisan ai:code and type a small test task to confirm everything connects.4' } - run: composer install --no-interaction --no-scripts - run: | php artisan ai:upgrade pestphp/pest \ --headless --output=json --no-worktree \ --ref-issue=${{ githuba human stays the trigger — read it and run php artisan ai:upgrade <package> to turn it into a PR, or wire up the unattended mode belowAgentsClasses implementing CodingAgent that receive a prompt, call tools, and return a resultai:evalBenchmarks the agent against seeded bugs — fix rate, false-fix rate, tokens, costai:explainExplains what a file, class, or method does in plain Englishai:fixA focused fix session: paste an exception, point it at a Sentry issue (--sentry=ID) or GitHub issue (--issue=N), and the agent diagnoses, patches, and verifies the fixai:onboardOnboards a new developer: a guided, read-only tour of the codebase — what it is, how it's put together, how to run it, where to be careful — then answers their questionsai:respondActs on a /tackle comment left on a pull request: applies the requested change, pushes it to the PR branch, and replies in the threadai:reviewA read-only agent that reviews git diffs and surfaces real issues with severity levelsai:runThe same agent with no terminal attached: one task, a JSON result, and an exit code — for CI and cron