ការដំឡើង (Installation)

ស្វែងយល់អំពីរបៀបដំឡើង AG Kit និងកំណត់រចនាសម្ព័ន្ធសម្រាប់ Gemini CLI និង Google Antigravity។

---

វិធីសាស្ត្រទី 1: Bun Git Dependency (lka) — ណែនាំសម្រាប់ Private Repos

ដោយសារ ag-kit ជា repository ឯកជន (private) អ្នកអាចដំឡើង CLI ផ្ទាល់ទៅក្នុង package.json devDependencies តាមរយៈ SSH ដោយមិនចាំបាច់បង់ប្រាក់សម្រាប់ private npm ឬកំណត់ token .npmrc លើ GitHub Packages ឡើយ។

ផ្លូវកាត់ PowerShell lka (The lka PowerShell Shortcut)

បន្ថែមអនុគមន៍នេះទៅកាន់ឯកសារ PowerShell $PROFILE របស់អ្នក (Microsoft.PowerShell_profile.ps1)៖

# AG Kit Bun Installer & Runner (lka)
function Link-Agent {
    [CmdletBinding()]
    param(
        [switch]$Init
    )

    $packageUri = 'git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli'
    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8

    Write-Host 'Adding @houching/ag-kit via bun...' -ForegroundColor Cyan
    bun add -d $packageUri

    if ($LASTEXITCODE -eq 0) {
        Write-Host "$([char]0x2705) Successfully added @houching/ag-kit to package.json" -ForegroundColor Green

        # Initialize .agents if not present or explicitly requested
        if ((-not (Test-Path .agents)) -or $Init) {
            Write-Host 'Initializing .agents runtime...' -ForegroundColor Cyan
            bunx ag-kit init
        }
    } else {
        Write-Error 'Failed to install @houching/ag-kit via bun.'
    }
}
Set-Alias lka Link-Agent

ការប្រើប្រាស់ (Usage)

នៅក្នុងថតគម្រោងណាមួយ គ្រាន់តែដំណើរការ៖

agent-session

$

lka

Adding @houching/ag-kit via bun…

✅ Successfully added @houching/ag-kit to package.json

Initializing .agents runtime…

Created .agents/ (30 agents, 40 skills, 10 workflows)

ដំណើរការនេះ៖

1. បន្ថែម @houching/ag-kit ទៅក្នុង devDependencies នៃ package.json ដោយប្រើ git+ssh។
2. ដំណើរការ bunx ag-kit init ដោយស្វ័យប្រវត្ត ប្រសិនបើ .agents/ មិនទាន់មានក្នុងថតបច្ចុប្បន្ន។

---

វិធីសាស្ត្រទី 2: ដំឡើងដោយដៃតាមរយៈ Bun / NPM Git URL

ប្រសិនបើមិនប្រើ PowerShell alias ទេ អ្នកអាចដំណើរការពាក្យបញ្ជាស្តង់ដារក្នុង shell ណាមួយក៏បាន៖

1

បន្ថែមទៅក្នុង project dependencies តាមរយៈ Git URL

bun add -d git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli
# ឬប្រើ npm
npm install -D git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli

2

ចាប់ផ្តើមដំណើរការ toolkit

bunx ag-kit init

---

រចនាសម្ព័ន្ធថតឯកសារ (Directory Structure)

បន្ទាប់ពី initialization គម្រោងរបស់អ្នកនឹងមាន .agents/ runtime ស្តង់ដារ៖

.agents/
├── agent/           # 20 Specialist AI Agents
├── skills/          # 45 Domain-specific skills
├── workflows/       # 13 Slash commands
├── rules/           # Workspace and tier rules
├── hooks/           # Native Antigravity safety gates & doctor
├── memory/          # Persistent cross-session project memory
├── ARCHITECTURE.md  # Architectural reference map
└── antigravity.json # Antigravity runtime declaration

💡

ការដកចេញពី Git (Git Exclusion)

ប្រសិនបើអ្នកមិនចង់ commit .agents/ ទៅក្នុង repository ទេ អ្នកអាចបន្ថែមវាទៅក្នុង .git/info/exclude ឬ .gitignore_global។