ASMN-96/ai-agents-skills-toolkit

ai-agents-skills-toolkit は何をしますか？

AIコードエージェント向けのバイブコーディングガバナンスツールキット。ソースの来歴、アクティベーション境界、検証の誠実性、リリース証跡をCodex、Claude Code、プロジェクト所有ワークフロー全体で管理します。

はじめに

このツールキットは、AIエージェントが自律的にコードを生成・変更する際の信頼性と透明性を確保するために設計されています。以下の4つの主要なガバナンス領域をカバーします。

• ソース来歴（Source Provenance）: 生成されたコードの出所と生成プロセスを追跡します。どのプロンプト、どのモデル、どの時点で生成されたかを記録します。
• アクティベーション境界（Activation Boundaries）: AIエージェントが変更・生成を許可されるスコープを定義します。安全な範囲を超えたアクションを防止します。
• 検証の誠実性（Validation Honesty）: 生成されたコードの検証プロセスを自動化し、その結果を改ざん不可能な形で記録します。単体テスト、静的解析、セキュリティスキャン結果を含みます。
• リリース証跡（Release Evidence）: 各リリースに対して、AIエージェントが関与したすべての変更とその検証結果を証跡として保存します。監査要件を満たします。

対応プラットフォーム

• Codex (OpenAI/Anthropic/Mistral等のコード生成AI)
• Claude Code (Anthropic Claudeを用いたコード編集エージェント)
• プロジェクト所有ワークフロー (カスタムCI/CDパイプラインや手動プロセス)

クイックスタート

# プロジェクトにツールキットを追加（例: npm）
npm install @asmn-96/ai-agents-skills-toolkit

または、プロジェクトのルートにai-governance.json設定ファイルを作成します：

{
  "provenance": {
    "enabled": true,
    "storage": ".ai-provenance/"
  },
  "boundaries": {
    "allowlist": ["src/**", "tests/**"],
    "denylist": ["node_modules/**", "dist/**", ".git/**"]
  },
  "validation": {
    "runner": "jest"
  },
  "evidence": {
    "format": "markdown"
  }
}

主な機能

1. ソース来歴の追跡

AIエージェントが生成したすべてのファイル変更を、以下のメタデータとともに記録します。

• エージェント名とバージョン
• 使用したモデル
• 時刻と日付
• 元のプロンプト要約

2. アクティベーション境界の設定

許可リストと拒否リストを使用して、AIエージェントが変更可能なパスを制御します。

3. バリデーション自動化

コード変更後に自動的にテストとチェックを実行し、結果を検証ログに保存します。

4. リリース証跡の生成

リリースタグごとに、関連するすべてのAI生成変更と検証結果を含むレポートを生成します。

詳細ドキュメント

詳細については、各サブディレクトリのドキュメントを参照してください。

• Provenance
• Boundaries
• Validation
• Evidence

ライセンス

MIT License - 詳細はLICENSEファイルを参照してください。