OpenSource-Hub

ag-kit

프레임워크

vudovn/ag-kit

Antigravity 우선의 에이전트 엔지니어링 툴킷으로, 규칙, 스킬, 워크플로우 및 보안 훅을 포함합니다.

개요

AG Kit은 Antigravity에서 에이전트를 구축하기 위한 완전한 워크스페이스 계약을 제공하며, 20개의 전문가 에이전트, 47개의 스킬, 13개의 워크플로, 6개의 규칙 및 네이티브 보안 훅을 포함하고, 보안 업데이트, 롤백 및 MCP 통합을 지원합니다.

README 미리보기

\n  \n\n\nAG KIT\n\n\n  Antigravity-first agent engineering kit with rules, skills, specialist agents, workflows, persistent memory, MCP guidance, orchestration, and a native safety hook.\n\n\n\n  \n  \n  \n\n\n\n  Primary runtime: Google Antigravity\n  Tiếng Việt · Migration guide · Production checklist · Security\n\n\n---\n\n## Production profile\n\nAG Kit installs a complete `.agents/` workspace contract. Antigravity is the supported production runtime for this release. Other tools may read the Markdown components, but runtime behavior outside Antigravity is not part of the production compatibility guarantee.\n\n| Capability | Production implementation |\n| --- | --- |\n| Rules and skill discovery | `.agents/rules/`, `.agents/skills/`, `.agents/workflows/` |\n| Specialist routing | 20 role definitions and intelligent-routing skills |\n| Persistent context | `.agents/memory/` and context-compression guidance |\n| Orchestration | `/coordinate`, `/orchestrate`, Antigravity `/agents` and `/tasks` |\n| MCP | Workspace config plus explicit, backup-aware sync helper |\n| Tool safety | Native `PreToolUse` gate for high-confidence destructive commands |\n| Packaging | Local Antigravity plugin bundle with a SHA-256 content inventory |\n| Validation | Toolkit CI, Antigravity Doctor, regression tests, Dependency Review, CLI and web checks |\n\nThe native hook is deliberately narrow. It blocks root-filesystem deletion, drive formatting, and raw-disk overwrite patterns while allowing normal project cleanup such as deleting `dist/` or `node_modules/`. It does not replace Antigravity permissions, workspace trust, sandboxing, or human approval.\n\n## Requirements\n\n- Node.js 22 or newer for repository-level Antigravity tooling.\n- Python 3.10 or newer for AG Kit validators and utility scripts.\n- A trusted Google Antigravity workspace.\n- Git for safe update, review, and rollback workflows.\n\nThe published CLI currently supports Node.js 18 or newer; the Antigravity integration 

FAQ (2)

문제 해결
Windows에서 npx @vudovn/ag-kit init 또는 update를 실행할 때 발생하는 'EIO: Access is denied' 오류를 해결하는 방법은?

이 오류는 CLI가 .agent 디렉터리에 대해 동기식 fs.rmSync() 및 fs.cpSync() 작업을 사용하기 때문에 발생합니다. Windows Defender, IDE 또는 파일 감시 프로그램이 해당 디렉터리를 잠시 잠글 수 있으며, 이로 인해 Node.js가 EIO, Access is denied 오류로 실패합니다.

동기식 파일 시스템 호출을 Windows 파일 잠금 재시도 처리 기능이 포함된 fs-extra의 비동기 메서드로 교체하여 문제를 해결하세요:

import fse from 'fs-extra';

await fse.remove(targetAgentDir);
await fse.copy(sourceAgentDir, targetAgentDir, { overwrite: true });

호출하는 함수들을 async로 만들고 existsSync와 같은 관련 동기식 검사를 다음과 같이 교체하세요:

if (!(await fse.pathExists(sourceAgentDir))) {
  throw new Error(`Could not find ${AGENT_FOLDER} folder in source repository!`);
}

fs-extra는 이미 패키지 종속성에 포함되어 있으므로 새로운 종속성을 추가할 필요가 없습니다. 임시 해결 방법으로, 프로젝트를 감시 중인 IDE나 터미널을 닫고 Windows Defender에서 .agent 폴더를 허용한 후 다시 실행하세요:

npx @vudovn/ag-kit init

원본 Issue #53
문제 해결
.agent 폴더를 설치한 후 IDE 드롭다운에 Antigravity Kit 슬래시 명령이 표시되지 않는 이유는 무엇인가요?

IDE는 Git에서 무시하는 .agent/ 디렉터리에 있는 슬래시 명령 파일을 인식하지 못할 수 있습니다. 프로젝트의 메인 .gitignore 파일에서 .agent/ 항목을 제거한 다음, 대신 로컬의 .git/info/exclude에 추가하세요:

1. .gitignore에서 .agent/ 줄을 삭제하세요.
2. .agent/를 .git/info/exclude에 추가하세요:

echo ".agent/" >> .git/info/exclude

이렇게 하면 .agent/가 로컬에서 추적되지 않은 상태로 유지되면서도 IDE가 /plan, /brainstorm, /debug 및 기타 명령을 감지할 수 있습니다. 드롭다운이 즉시 업데이트되지 않으면 IDE를 새로 고치거나 다시 시작하세요.

원본 Issue #27