ពាក្យបញ្ជា និងជម្រើស (Commands & Options)
@houching/ag-kit CLI គ្រប់គ្រងការដំឡើង ការថែទាំ និងការផ្ទៀងផ្ទាត់នៃ .agents/ runtime នៅក្នុង repository គម្រោងរបស់អ្នក។
ពាក្យបញ្ជា (Commands)
Section titled “ពាក្យបញ្ជា (Commands)”ag-kit init
Section titled “ag-kit init”ចាប់ផ្តើមដំណើរការ AG Kit ក្នុងថតការងារបច្ចុប្បន្ន ដោយបង្កើតថត .agents និងឯកសារ manifest.json។
agent-session
$
bunx ag-kit init
✔ Initialized AG Kit runtime
បានបង្កើត .agents/ (30 agents, 40 skills, 10 workflows)
បានបង្កើត manifest.json & manifest.lock.json
ឥរិយាបថ (Behavior)
- • សរសេរនិយមន័យ agent និងការណែនាំលំនាំដើមទៅកាន់
.agents/ - • បង្កើត
manifest.jsonនិងmanifest.lock.json - • បញ្ឈប់ដោយសុវត្ថិភាពប្រសិនបើ
.agents/មានរួចហើយ លើកលែងតែមានការបញ្ជាក់–force
ag-kit update
Section titled “ag-kit update”អាប់ដេតថត .agents ដែលមានស្រាប់ជាមួយនិយមន័យ toolkit ចុងក្រោយបំផុត។
agent-session
$
bunx ag-kit update
⚠️
សេចក្តីជូនដំណឹងអំពីការកែប្រែដោយផ្ទាល់
ការកែប្រែឯកសារគ្រប់គ្រងដោយ kit ដោយផ្ទាល់អាចបណ្តាលឱ្យមានជម្លោះ update។ សូមប្រើប្រាស់ local overrides ឬការកំណត់ agent ផ្ទាល់ខ្លួនតាមដែលអាចធ្វើទៅបាន។
ឥរិយាបថ (Behavior)
- • បង្កើត backup មុនពេល update ដោយស្វ័យប្រវត្តក្នុង
.agents/.ag-kit/backups/ - • ប្រើប្រាស់យុទ្ធសាស្ត្រ
mergeតាមលំនាំដើម៖ រក្សាការកែប្រែក្នុងស្រុករបស់អ្នក និងរក្សាទុកច្បាប់ចម្លងថ្មីដែលមានជម្លោះក្នុង.agents/.ag-kit/conflicts/ - • គាំទ្រ
–strategy replaceសម្រាប់ការធ្វើសមកាលកម្ម upstream ស្អាតដូចដើម
ag-kit rollback
Section titled “ag-kit rollback”ស្តារ .agents/ ទៅកាន់ស្ថានភាពមុនពីការ backup ស្វ័យប្រវត្តិ។
agent-session
$
bunx ag-kit rollback
? ស្តារ backup 2026-07-26T16-03-21 ឡើងវិញ? (y/N) y
បានស្តារ backup 2026-07-26T16-03-21 រួចរាល់
Pre-rollback backup: .agents/.ag-kit/backups/…
ឥរិយាបថ (Behavior)
- • បង្ហាញបញ្ជី backup ដែលបានបង្កើតក្នុងអំឡុងពេល
initឬupdateកន្លងមក - • ស្នើសុំការបញ្ជាក់មុនពេលស្តារឯកសារឡើងវិញ
- • បង្កើត backup នៃស្ថានភាពបច្ចុប្បន្នមុនពេល rollback
ag-kit status
Section titled “ag-kit status”បង្ហាញស្ថានភាពបច្ចុប្បន្ននៃការដំឡើង AG Kit រួមទាំងកំណែ ឯកសារដែលបានកែប្រែ និងការត្រួតពិនិត្យភាពសុចរិត។
agent-session
$
bunx ag-kit status
Version: 1.0.0
Managed files: 142 total, 0 modified
Backups: 2 available in .agents/.ag-kit/backups/
Status: Clean
ជម្រើស និងទង់កំណត់ (Options & Flags)
Section titled “ជម្រើស និងទង់កំណត់ (Options & Flags)”| ជម្រើស | ការពិពណ៌នា |
|---|---|
-f, --force |
បង្ខំឱ្យសរសេរជាន់លើថត .agents ដែលមានស្រាប់ក្នុងកំឡុងពេល init ឬ update។ |
-p, --path <dir> |
ថតគោលដៅសម្រាប់ការដំឡើង (លំនាំដើមគឺថតការងារបច្ចុប្បន្ន)។ |
-b, --branch <name> |
មែកធាង Git ឬ tag ដែលត្រូវដំឡើង។ |
-q, --quiet |
បិទការបង្ហាញលទ្ធផលដែលមិនមែនជាកំហុសកំឡុងពេលដំណើរការ។ |
--dry-run |
មើលឯកសារសាកល្បងដែលនឹងត្រូវបង្កើត, update, ឬមានជម្លោះ ដោយមិនសរសេរទៅលើថាស។ |
--strategy <merge|replace> |
យុទ្ធសាស្ត្រសម្រាប់ការ update: merge (លំនាំដើម, រក្សាឯកសារផ្ទាល់ខ្លួន) ឬ replace (សរសេរជាន់ថ្មីទាំងអស់)។ |
--no-backup |
រំលងការបង្កើត backup ស្វ័យប្រវត្តមុនពេលកែប្រែឯកសារ។ |
--conflict-report <file> |
ផ្លូវឯកសារដែលត្រូវសរសេររបាយការណ៍ជម្លោះជា JSON។ |
ឧទាហរណ៍ទូទៅ (Common Examples)
Section titled “ឧទាហរណ៍ទូទៅ (Common Examples)”បង្ខំឱ្យដំឡើងឡើងវិញ
Section titled “បង្ខំឱ្យដំឡើងឡើងវិញ”bunx ag-kit init --forceការសាកល្បង Update ជាមុន (Dry Run)
Section titled “ការសាកល្បង Update ជាមុន (Dry Run)”bunx ag-kit update --dry-runការ Update ដោយប្រើ Replace Strategy
Section titled “ការ Update ដោយប្រើ Replace Strategy”bunx ag-kit update --strategy replaceការស្តារ Backup ជាក់លាក់ណាមួយ
Section titled “ការស្តារ Backup ជាក់លាក់ណាមួយ”bunx ag-kit rollback --backup 2026-07-26T16-03-21