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
トラブル対応
Antigravity Kit のスラッシュコマンドが .agent フォルダをインストールした後に IDE のドロップダウンに表示されないのはなぜですか?

Git で無視されている .agent/ ディレクトリ内にあるスラッシュコマンドファイルは、IDE によって無視される場合があります。プロジェクトのメインの .gitignore ファイルから .agent/ エントリを削除し、代わりにローカルの .git/info/exclude に追加してください。

1. .gitignore から .agent/ の行を削除します。
2. .git/info/exclude に .agent/ を追加します。

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

これにより、.agent/ はローカルで未追跡のまま維持されつつ、IDE が /plan、/brainstorm、/debug などのコマンドを検出できるようになります。ドロップダウンがすぐに更新されない場合は、IDE を再読み込みするか再起動してください。

参照 Issue #27