gh skillで実現するマルチエージェント開発体制 — SKILL.mdのバージョン管理・CI/CD連携・エージェント別最適化の設計

name: team-skills
version: 2.1.0
description: "チーム共通コーディングスキル集"
maintainer: "platform-team@example.com"
 
agents:
  - claude-code
  - copilot
  - cursor
  - gemini-cli
 
# プロファイル: 役割別にスキルセットをグループ化
profiles:
  frontend:
    skills:
      - base/code-style.md
      - base/git-workflow.md
      - frontend/react-patterns.md
      - frontend/testing-frontend.md
    agents: [claude-code, copilot, cursor]
 
  backend:
    skills:
      - base/code-style.md
      - base/git-workflow.md
      - backend/api-design.md
      - backend/database-patterns.md
    agents: [claude-code, copilot, cursor, gemini-cli]
 
  fullstack:
    extends: [frontend, backend]
 
# エージェント固有の追加設定
agent_overrides:
  claude-code:
    append: agent-overrides/claude-code-specific.md
  copilot:
    append: agent-overrides/copilot-hints.md

## [2.1.0] - 2026-04-15
### Added
- `backend/database-patterns.md`: PostgreSQL jsonb型の扱い方を追加
  - Agents affected: Claude Code, Copilot, Cursor
- `agent-overrides/claude-code-specific.md`: PreToolUseフックの標準設定を追加
  - Agents affected: Claude Code only
 
### Changed
- `base/code-style.md`: TypeScript strictモードを必須に変更
  - Breaking change for agents: all
  - Migration guide: tsconfig.jsonにstrict:trueを追加してください
 
## [2.0.0] - 2026-03-01
### Removed
- `frontend/vue-patterns.md`: プロジェクトのReact統一に伴い削除

# .github/workflows/validate.yml
name: Validate Skills
 
on:
  pull_request:
    paths:
      - '**.md'
      - 'skill.yaml'
 
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup gh skill
        run: gh extension install github-actions/gh-skills
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
      - name: Validate skill.yaml structure
        run: gh skill validate
 
      - name: Check for broken internal links
        run: |
          # スキルファイル間の参照整合性チェック
          gh skill lint --check-links
 
      - name: Verify agent compatibility
        run: |
          # 各エージェントへのデプロイシミュレーション
          gh skill dry-run --agent claude-code
          gh skill dry-run --agent copilot
          gh skill dry-run --agent cursor
 
      - name: Check CHANGELOG updated
        run: |
          # スキルの変更時にCHANGELOGが更新されているか確認
          if git diff --name-only origin/main | grep -q "\.md$"; then
            if ! git diff --name-only origin/main | grep -q "CHANGELOG.md"; then
              echo "❌ スキルファイルが変更されましたが、CHANGELOGが更新されていません"
              exit 1
            fi
          fi

# .github/workflows/release.yml
name: Release Skills
 
on:
  push:
    tags:
      - 'v*'
 
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Create GitHub Release
        uses: actions/create-release@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          tag_name: ${{ github.ref }}
          release_name: Release ${{ github.ref }}
          body_path: CHANGELOG.md
 
      - name: Notify team via Slack
        run: |
          # チームへのSlack通知（スキルが更新されたことを知らせる）
          curl -X POST "${{ secrets.SLACK_WEBHOOK }}" \
            -d "{\"text\": \"🎯 team-skills ${{ github.ref }} がリリースされました。\ngh skill update team-skills で更新してください。\"}"

<!-- agent-overrides/claude-code-specific.md -->
## PreToolUseフック設定
 
以下のファイルへの書き込み前に必ず確認を取ること：
- `production.env`
- `database/migrations/`
- `src/auth/`
 
## ツール使用制限
 
本番環境（NODE_ENV=production）では以下のコマンドを実行しないこと：
- `npm run migrate`
- `git push --force`
- データベースへのDELETEクエリ
 
## ワークフロー定義
 
コードレビューを求められた場合、以下の順序で実行すること：
1. 型エラーのチェック（tsc --noEmit）
2. リントの実行（eslint src/）
3. テストの実行（npm test）
4. セキュリティスキャン（npm audit）

<!-- agent-overrides/copilot-hints.md -->
## コードスタイル
 
- TypeScriptを使用する。anyは使わない
- 関数はアロー関数を優先する
- コメントは日本語で書く
- エラーハンドリングは必ずcatch節を含める
 
## 禁止事項
 
- console.logをそのままコミットしない
- ハードコードされたURLや認証情報を書かない

# Cursorユーザー向け：既存の.cursorrulesとの統合
gh skill install team/team-skills --agent cursor --no-override-rules

# packages/frontend/skill.yaml
extends: ../../skill.yaml
name: frontend-skills
additional_skills:
  - skills/react-specific.md
  - skills/storybook-patterns.md