BeClaude

quizknock

New
1Community RegistryGeneralby sk8metalme

Interactive quiz generation for learning reinforcement

Community PluginView Source

Overview

Claude Code の設定ファイルを簡単に配布・セットアップできるシステムです。

📋 概要

このプロジェクトでは、Claude Code公式プラグインシステムとグローバル設定配布スクリプトを提供しています。

📌 グローバル設定のインストール: プラグインで配布できないCLAUDE.mdとhooksは install-global.sh でインストールしてください。詳細は グローバル設定 セクションを参照してください。

🔌 プラグイン配布（推奨）

Claude Code公式プラグインシステムを使用した配布方式です。

ステップ1: マーケットプレイスの追加

Claude Code のチャットで以下のコマンドを実行：

bash
/plugin marketplace add sk8metalme/ai-agent-setup

既にマーケットプレイスを追加済みの場合、エラーメッセージが表示されます（問題ありません）。

ステップ2: 推奨プラグインのインストール

基本的な開発環境を整えるため、以下のプラグインをインストール：

bash
# 推奨: 要件を深堀りして明確化（ultrathink機能）
/plugin install deep-dive@ai-agent-setup

# 推奨: 会話履歴から自動学習（繰り返しミス防止）
/plugin install guardrail-builder@ai-agent-setup

# 推奨: 開発ワークフロー統合（計画、PR、CHANGELOG）
/plugin install development-toolkit@ai-agent-setup

ステップ3: 追加プラグインのインストール（必要に応じて）

使用するツールや言語に応じて、追加のプラグインをインストール：

bash
# Jujutsu (jj) を使用する場合
/plugin install jujutsu-workflow@ai-agent-setup

# CI/CDトラブルシューティングが必要な場合
/plugin install ci-cd-tools@ai-agent-setup

# OSSライセンス管理が必要な場合
/plugin install oss-compliance@ai-agent-setup

# バージョン監査が必要な場合
/plugin install version-audit@ai-agent-setup

# UI/UXレビューが必要な場合
/plugin install design-review@ai-agent-setup

# E2E開発計画が必要な場合
/plugin install e2e-planning@ai-agent-setup

# 学習支援クイズが必要な場合
/plugin install quizknock@ai-agent-setup

# 日次知識自動同期が必要な場合
/plugin install daily-knowledge-sync@ai-agent-setup

# 言語別プラグイン（該当する言語のみ）
/plugin install lang-java-spring@ai-agent-setup  # Java + Spring Boot
/plugin install lang-python@ai-agent-setup       # Python + FastAPI
/plugin install lang-php@ai-agent-setup          # PHP + Slim
/plugin install lang-perl@ai-agent-setup         # Perl + Mojolicious

ステップ4: インストール確認

インストールが成功したことを確認：

bash
# インストール済みプラグインの確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins | keys'

# または、キャッシュディレクトリを確認
ls -la ~/.claude/plugins/cache/ai-agent-setup/

高優先度（推奨）:

プラグイン説明提供機能キーワード
deep-dive再帰的な深堀りで要件を明確化<br>推測を排除し、品質・信頼性を向上📚スキル: 1個deep-dive, requirements, questioning, ultrathink
guardrail-builder会話履歴から自動学習し.claude/rules/に個別ファイルで保存<br>1ルール1MD構造、自動読み込み、繰り返しミス防止📚スキル: 1個guardrail, learning, rules, memory
development-toolkit開発ワークフロー統合（計画・PR・CHANGELOG）<br>日常的な開発作業の推奨ツール📋コマンド: 6個<br>📚スキル: 3個<br>🤖エージェント: 2個<br>🪝フック: 2個development, workflow, pr, changelog, planning
jujutsu-workflowJujutsuバージョン管理ワークフロー<br>.jjディレクトリやjjコマンド使用時に推奨📚スキル: 1個<br>📄ドキュメント: 1個jujutsu, jj, version-control, git-alternative, vcs

中優先度（機能別）:

プラグイン説明提供機能キーワード
ci-cd-toolsCI/CDトラブルシューティング・GitHub Actions支援<br>ビルド失敗、ワークフロー問題の診断📚スキル: 1個ci-cd, github-actions, troubleshooting, deployment
oss-complianceOSSライセンスチェック・監査<br>ライセンス競合の検出、依存関係追跡📚スキル: 1個<br>🤖エージェント: 1個oss, license, compliance, legal, audit
version-audit技術スタックバージョン監査・EOLチェック<br>古い依存関係やセキュリティ脆弱性の特定📚スキル: 1個<br>🤖エージェント: 1個version, audit, eol, security, dependencies
design-reviewUI/UXデザインレビュー・アクセシビリティチェック<br>ユーザビリティ、アクセシビリティ標準の評価📚スキル: 1個<br>🤖エージェント: 1個design, ui, ux, accessibility, a11y, review
e2e-planningE2Eファースト開発計画・Walking Skeleton設計<br>エンドツーエンドの実装戦略ガイド📚スキル: 1個<br>🤖エージェント: 1個e2e, planning, walking-skeleton, architecture
quizknockインタラクティブクイズ生成・学習支援<br>トピック調査、5問セット出題、統計表示、復習機能📚スキル: 1個quiz, learning, education, assessment, review
daily-knowledge-sync日次会話ログから知識を自動抽出・同期<br>エラー解決、コーディングパターン、ドメイン知識を自動分類・GitHub同期📚スキル: 1個knowledge, learning, automation, daily, sync

低優先度（言語別）:

プラグイン説明提供機能キーワード
lang-java-springJava + Spring Boot開発支援<br>ベストプラクティス、パターン、トラブルシューティング📚スキル: 1個<br>🌐言語設定: 1個java, spring, spring-boot, development
lang-pythonPython + FastAPI開発支援<br>モダンなPythonパターン、非同期プログラミング、API設計📚スキル: 1個<br>🌐言語設定: 1個python, fastapi, async, development
lang-phpPHP + Slim Framework開発支援<br>モダンなPHP開発プラクティス、RESTful API設計📚スキル: 1個<br>🌐言語設定: 1個php, slim, framework, development
lang-perlPerl + Mojolicious開発支援<br>Perlベストプラクティス、モダンなWeb開発📚スキル: 1個<br>🌐言語設定: 1個perl, mojolicious, development

プラグインを最新バージョンに更新：

bash
# 特定のプラグインを更新
/plugin update development-toolkit@ai-agent-setup

# すべてのプラグインを一括更新
/plugin update --all

# 更新確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins["development-toolkit@ai-agent-setup"][0].lastUpdated'

プラグインが不要になった場合：

bash
# 特定のプラグインをアンインストール
/plugin uninstall development-toolkit@ai-agent-setup

# マーケットプレイスごと削除（すべてのプラグインが削除されます）
/plugin marketplace remove ai-agent-setup

# アンインストール確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins | keys'

🤖 スキル & エージェント

スキル（知識ライブラリ）

  • •deep-dive: 再帰的な深堀りで要件を明確化、推測を排除
  • •guardrail-builder: 会話履歴から自動学習、.claude/rules/に個別ファイルで保存（1ルール1MD、自動読み込み）
  • •jujutsu: Jujutsuバージョン管理のベストプラクティス
  • •ci-cd: GitHub Actions/Screwdriverのトラブルシューティング
  • •oss-license: OSSライセンスコンプライアンスガイド
  • •stable-version: LTS/EOL管理、バージョンアップグレード判断
  • •e2e-first-planning: Walking Skeleton、MVP計画策定
  • •design-review: アクセシビリティ、レスポンシブ、パフォーマンス評価
  • •changelog: CHANGELOG/リリースノート生成、Conventional Commits、SemVer
  • •java-spring: Java + Spring Boot開発支援
  • •php: PHP開発支援
  • •perl: Perl開発支援
  • •python: Python開発支援

エージェント（実行アシスタント）

  • •pr-resolver: PRレビューコメントの自動resolve
  • •oss-license-checker: 依存パッケージライセンス監査、代替提案
  • •stable-version-auditor: 技術スタックバージョン監査、リスク評価
  • •e2e-first-planner: E2E開発計画の自動生成
  • •design-reviewer: UI/UXデザインの自動レビュー
  • •changelog-generator: CHANGELOG.md自動生成、GitHub Releases作成支援

🚀 クイックスタート

1. グローバル設定のインストール

bash
# リポジトリをクローン
git clone https://github.com/sk8metalme/ai-agent-setup.git
cd ai-agent-setup

# グローバル設定（CLAUDE.md、hooks、settings.json）をインストール
./install-global.sh

これにより以下がインストールされます：

  • •~/.claude/CLAUDE.md - @import記載済みのグローバル設定
  • •~/.claude/base/CLAUDE-base.md - 基本コーディング原則
  • •~/.claude/security/CLAUDE-security-policy.md - セキュリティポリシー
  • •~/.claude/team/CLAUDE-team-standards.md - チーム開発標準
  • •~/.claude/hooks/*.sh - hooksスクリプト（通知、ブランチ保護、秘密情報保護）
  • •~/.claude/settings.json - 共通設定をマージ（permissions, hooks, git, security 等）
  • •~/.claude/settings.local.example.json - 環境依存設定サンプル（env, theme 等）

settings.template.json には statusLine 設定が含まれています。以下のツールが必要です：

bash
# ccstatusline のインストール（Claude Code ステータス表示）
npm install -g ccstatusline

statusLine では以下の情報を表示します：

  • •現在のディレクトリ: 作業ディレクトリの最後の2セグメント（例: git/ai-agent-setup）
  • •モデル名: Sonnet 4.5など
  • •コンテキスト使用量: トークン数と割合
  • •Gitブランチ名: 現在のブランチ
  • •Git変更状況: 追加・削除行数

ccstatusline のカスタマイズは ~/.config/ccstatusline/settings.json で可能です。

これらのツールがインストールされていない場合、install-global.sh が通知してインストール方法を案内します。

複数PCで同じ設定を使用する場合：

bash
# PC-A で設定変更後
cd ~/Work/git/ai-agent-setup
git add global/
git commit -m "feat: update claude settings"
git push

# PC-B で同期
cd ~/Work/git/ai-agent-setup
git pull
./install-global.sh

注意: プラグインは手動でインストールする必要があります（settings.json の enabledPlugins は自動追加されません）。

2. プラグインシステムを使ったインストール（推奨）

bash
# 1. マーケットプレイスを追加
/plugin marketplace add sk8metalme/ai-agent-setup

# 2. 推奨プラグインをインストール
/plugin install development-toolkit@ai-agent-setup

# 3. 必要に応じて言語別プラグインをインストール
/plugin install lang-python@ai-agent-setup  # Python開発の場合
/plugin install lang-java-spring@ai-agent-setup  # Java開発の場合

# 4. その他の機能プラグイン（必要に応じて）
/plugin install jujutsu-workflow@ai-agent-setup  # Jujutsu使用時
/plugin install ci-cd-tools@ai-agent-setup  # CI/CDツール使用時

🎯 対応言語・フレームワーク

言語フレームワーク特徴
JavaSpring Boot 3.x + Gradleエンタープライズ開発、NullAway、Rocky Linux
PHPSlim Framework + Composer軽量API、Monolog、Phake、MySQL/Oracle
PerlMojolicious + Modern Perlスクリプト・Web、モダンPerl機能
PythonFastAPI + Poetry高速API、型ヒント、非同期処理

🗂️ プラグイン管理の詳細

プラグイン管理ファイル

プラグインは ~/.claude/plugins/ ディレクトリで管理されます：

code
~/.claude/plugins/
├── installed_plugins.json      # インストール済みプラグインのリスト
├── known_marketplaces.json     # 登録済みマーケットプレイス
├── install-counts-cache.json   # インストール統計
├── config.json                 # プラグインシステム設定
├── cache/                      # プラグイン実体のキャッシュ
│   └── <marketplace>/          # マーケットプレイス別
│       └── <plugin-name>/      # プラグイン名別
│           └── <version>/      # バージョン別
│               ├── .claude-plugin/
│               │   └── plugin.json      # プラグインメタデータ
│               ├── commands/            # コマンド定義（.mdファイル）
│               ├── skills/              # スキル定義（.mdファイル）
│               ├── agents/              # エージェント定義（.mdファイル）
│               ├── languages/           # 言語別設定（CLAUDE-*.md）
│               ├── resources/           # リソースファイル
│               ├── hooks/               # フックスクリプト（.sh）
│               └── scripts/             # ユーティリティスクリプト
└── marketplaces/               # マーケットプレイスのキャッシュ
    └── <marketplace>/
        └── marketplace.json

インストール確認方法

インストール済みプラグインは以下で確認できます：

bash
# 方法1: プラグイン管理ファイルを確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins | keys'

# 方法2: キャッシュディレクトリを確認
ls -la ~/.claude/plugins/cache/ai-agent-setup/

# 方法3: 特定プラグインの詳細を確認
cat ~/.claude/plugins/installed_plugins.json | jq '.plugins["development-toolkit@ai-agent-setup"]'

トラブルシューティング

プラグインが認識されない場合:

bash
# 1. インストール済みプラグインを確認
cat ~/.claude/plugins/installed_plugins.json

# 2. Claude Codeを再起動

# 3. プラグインを再インストール
/plugin uninstall development-toolkit@ai-agent-setup
/plugin install development-toolkit@ai-agent-setup

マーケットプレイスが見つからない場合:

bash
# マーケットプレイスを確認
cat ~/.claude/plugins/known_marketplaces.json

# マーケットプレイスを再登録
/plugin marketplace remove ai-agent-setup
/plugin marketplace add sk8metalme/ai-agent-setup

📁 プラグインシステムによるファイル配置

プラグインインストール後、Claude Codeが自動的に以下の場所にファイルを配置します：

ユーザーホームディレクトリ（グローバル設定）

プラグインで管理されるファイルは ~/.claude/plugins/cache/<marketplace>/<plugin-name>/<version>/ に配置されます。

code
~/.claude/
├── plugins/                                    # プラグイン管理ディレクトリ
│   ├── installed_plugins.json                 # インストール済みプラグインリスト
│   ├── known_marketplaces.json                # 登録済みマーケットプレイス
│   └── cache/                                 # プラグインキャッシュ
│       └── ai-agent-setup/                    # マーケットプレイス名
│           ├── development-toolkit/
│           │   └── 1.0.0/
│           │       ├── commands/
│           │       ├── skills/
│           │       ├── agents/
│           │       └── scripts/
│           ├── lang-python/
│           │   └── 1.0.0/
│           │       ├── skills/
│           │       └── languages/
│           └── ...                            # その他のプラグイン
├── CLAUDE.md                                  # ユーザー固有設定（install-global.shでインストール）
├── base/CLAUDE-base.md                        # 基本設定（install-global.shでインストール）
├── security/CLAUDE-security-policy.md        # セキュリティポリシー（install-global.shでインストール）
├── team/CLAUDE-team-standards.md             # チーム標準（install-global.shでインストール）
├── hooks/                                     # hooksスクリプト（install-global.shでインストール）
└── settings.json                              # Claude Code設定

配布用テンプレート（本プロジェクト）

このリポジトリ内の構造：

code
ai-agent-setup/
├── global/                      # グローバル設定（install-global.shで配布）
│   ├── CLAUDE.md               # @import記載済みテンプレート
│   ├── base/CLAUDE-base.md      # 基本設定
│   ├── security/CLAUDE-security-policy.md # セキュリティポリシー
│   ├── team/CLAUDE-team-standards.md      # チーム標準
│   └── hooks/                   # hooksスクリプト
│       ├── notify.sh
│       ├── protect-branch.sh
│       └── protect-branch.conf
├── plugins/                     # プラグインソース（SSoT）
│   ├── development-toolkit/
│   ├── deep-dive/               # 深堀りスキル
│   ├── lang-python/
│   └── ...（全12個のプラグイン）
├── .claude/                     # プロジェクトテンプレート（最小限）
│   ├── CLAUDE.md               # プラグインインストールガイド
│   ├── settings.json           # 基本設定
│   └── README.md               # 設定説明
├── install-global.sh           # グローバル設定配布スクリプト
└── install-project.sh          # プロジェクト設定配布スクリプト

プロジェクト設定（Claude Code）

code
my-project/
├── .claude/                  # Claude設定（プロジェクト固有）
│   ├── CLAUDE.md             # メインエントリーポイント
│   ├── settings.json         # Claude Code設定
│   ├── commands/             # コマンドファイル
│   │   ├── dev.md           # 開発コマンド
│   │   ├── documentation.md # ドキュメント化コマンド
│   │   └── plan.md          # 計画コマンド
│   ├── base/CLAUDE-base.md   # 基本設定
│   ├── skills/               # スキル（知識ライブラリ）
│   ├── agents/               # エージェント（実行アシスタント）
│   ├── languages/            # 言語別設定
│   ├── security/             # セキュリティポリシー
│   └── team/                 # チーム標準
└── src/                      # ソースコード

🔧 設定の特徴

共通設定

  • •言語: 日本語での応答
  • •コード品質: クリーンコード、SOLID原則
  • •テスト: カバレッジ95%以上
  • •セキュリティ: 入力検証、機密情報保護
  • •批判的思考: より良い判断のための否定的意見も含む

Claude設定（settings.json）

  • •セキュリティ: 危険コマンド拒否、機密情報スキャン
  • •Git統合: コミットテンプレート、保護ブランチ設定
  • •チーム設定: レビュアー、コードオーナー管理
  • •権限管理: 安全なコマンドのみ許可
  • •開発ツール: bash, read, edit, write, glob, grep有効

コマンドファイル（commands/）

  • •@dev: TDD開発、コードレビュー、リファクタリング支援
  • •@documentation: 世界レベルのドキュメント化戦略・テンプレート
  • •@plan: プロジェクト計画、要件定義、リスク管理
  • •実践的テンプレート: 即座に使える包括的なドキュメント体系

スキル & エージェント

  • •jujutsu: ブランチ管理、コミット戦略、PR作成ガイド
  • •ci-cd: GitHub Actions/Screwdriverログ確認、トラブルシューティング
  • •oss-license: MIT/Apache/GPL等の分類、license-checker使用法
  • •stable-version: LTS判断、EOL対応、endoflife.date API活用
  • •e2e-first-planning: Walking Skeleton → MVP、縦割りタスク分割
  • •design-review: WCAG 2.1 AA、Core Web Vitals、レスポンシブ確認
  • •changelog: Keep a Changelog形式、Conventional Commits、SemVer、自動生成ツール（conventional-changelog/standard-version/git-chglog）
  • •言語別スキル: Java/PHP/Perl/Python開発のベストプラクティス
  • •pr-resolver: GitHub GraphQL APIでPRコメント自動resolve
  • •oss-license-checker: プロジェクトタイプ判定、ライセンス監査、代替提案
  • •stable-version-auditor: 技術スタック検出、リスク評価（Critical/Warning/Info）
  • •e2e-first-planner: ユーザーストーリーからE2Eスライス生成、計画出力
  • •design-reviewer: Playwright MCP連携、ブレークポイント別レビュー
  • •changelog-generator: git/jjコミット履歴解析、CHANGELOG.md生成、バージョン提案、GitHub Releases作成支援

プロジェクト用Claude設定

  • •プロジェクト最適化: プロジェクト固有のワークフロー対応
  • •チーム協業: プロジェクトメンバー全員で統一設定
  • •設定の優先順位: プロジェクト設定 > グローバル設定
  • •保護ブランチ拡張: developブランチも追加保護
  • •ディレクトリ別管理: src/, tests/, docs/, config/別のコードオーナー

言語別設定

  • •Gradle 8.x、Rocky Linux 9
  • •NullAway（Null安全性チェック）
  • •JUnit 5 + Mockito
  • •Spring Security + JWT
  • •PHP 8.2+、PSR-12準拠
  • •Slim Framework（Laravelなし）
  • •PHPUnit + Phake（モック）
  • •Monolog（ロギング）
  • •MySQL/Oracle対応
  • •Perl 5.32+、モダンPerl
  • •Mojolicious、Moo/Moose
  • •Test::More + Test::Exception
  • •DBI（MySQL/Oracle）
  • •Python 3.9+、型ヒント必須
  • •FastAPI、Pydantic
  • •pytest + pytest-asyncio
  • •SQLAlchemy（MySQL/PostgreSQL）

📚 ドキュメント

🏢 エンタープライズ向け

プライベートリポジトリでの配布を行う場合は、インストーラースクリプト内の REPO_URL を変更してください：

bash
# install-global.sh または install-project.sh の先頭で変更
REPO_URL="https://raw.githubusercontent.com/your-org/your-repo/main"

🤝 コントリビューション

  1. このリポジトリをフォーク
  2. 機能ブランチを作成 (git checkout -b feature/amazing-feature)
  3. 変更をコミット (git commit -m 'Add amazing feature')
  4. ブランチをプッシュ (git push origin feature/amazing-feature)
  5. プルリクエストを作成

📄 ライセンス

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

注意: このシステムは機密情報を含まず、設定ファイルのみを管理します。APIキーやパスワードなどの機密情報は別途管理してください。

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/quizknock.md https://raw.githubusercontent.com/sk8metalme/ai-agent-setup/main/SKILL.md
3
Invoke in Claude Code
/quizknock
View source on GitHub

Frequently Asked Questions

What is quizknock?

Interactive quiz generation for learning reinforcement

How to install quizknock?

To install quizknock, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /quizknock.

What is quizknock best for?

quizknock is a community categorized under General. Created by sk8metalme.