レシピ: チームオンボーディング
新しいチームメンバーの AI Skill 環境を5分以内でセットアップする。
シナリオ
新しい開発者がチームに参加します。彼らに必要なものは:
- 組織全体の Skill(コーディング標準、レビューガイドライン)
- プロジェクト固有の Skill(ドメイン知識、アーキテクチャルール)
- 自分の AI ツール(Claude Code、Cursor など)すべてで動作すること
解決策
ステップ 1: オンボーディングスクリプトを作成する
チームの wiki やリポジトリに scripts/setup-skills.sh として保存します。
#!/bin/bash
set -e
echo "Installing skillshare..."
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
echo "Initializing..."
skillshare init
echo "Installing organization skills..."
skillshare install your-org/org-skills
echo "Running security audit..."
skillshare audit
echo "Syncing to all AI tools..."
skillshare sync
echo "Done! Run 'skillshare list' to see installed skills."
ステップ 2: 新入社員がスクリプトを実行する
curl -fsSL https://your-org.github.io/setup-skills.sh | sh
またはスクリプトがチームのリポジトリにある場合:
git clone your-org/team-tools
./team-tools/scripts/setup-skills.sh
ステップ 3: プロジェクト固有のセットアップ
新入社員がプロジェクトを clone するとき:
cd your-project
skillshare sync -p
これによりプロジェクトスコープの Skill が自動的に取得されます。
ステップ 4: すべてが動作することを確認する
# Global の Skill を確認する
skillshare list
# プロジェクトの Skill を確認する
skillshare list -p
# Sync のステータスを確認する
skillshare status
確認
skillshare listが組織の Skill を表示するskillshare statusがすべての Target が Sync されていることを示す- Claude Code / Cursor を開くと Skill が読み込まれていることが分かる
バリエーション
- Dev Container でのオンボーディング: チームが Dev Container を使っている場合、
.devcontainer/DockerfileとpostCreateCommandに skillshare を追加すれば、コンテナ起動時に Skill が準備される - Homebrew ベースのインストール: macOS/Linux チームでは
curl | shの代わりにbrew install skillshareを使う - Hub による発見: 新入社員に自分たちの Hub を案内する:
skillshare search --hub https://your-org.github.io/skillshare-hub.json