CCJKでのチームコラボレーション:共有AIワークフロー
チーム環境でCCJKをセットアップする方法を学びます。設定、スキル、ベストプラクティスを開発チーム全体で共有します。
C
CCJK TeamCCJKでのチームコラボレーション:共有AIワークフロー
複数の開発者がAIアシスタントを使用する場合、一貫性が重要になります。CCJKは、チームコラボレーションのための強力な機能を提供し、全員が同じパターンとプラクティスに従うことを保証します。
チーム設定のセットアップ
プロジェクトレベルの設定
リポジトリに共有設定を作成:
# .claude/config.yaml
version: "1.0"
team: "your-team-name"
# 共有モデル設定
model:
default: claude-sonnet-4-20250514
fallback: claude-haiku
# プロジェクトコンテキスト
context:
description: |
以下で構築されたEコマースプラットフォーム:
- Next.js 14(App Router)
- TypeScript(strictモード)
- PostgreSQL + Prisma
- キャッシング用Redis
- Tailwind CSS
conventions:
- フックを使用した関数コンポーネントを使用
- Airbnbスタイルガイドに従う
- すべてのビジネスロジックにテストを書く
- Conventional Commitsを使用
# 共有無視パターン
ignore:
- node_modules/
- .next/
- coverage/
- "*.log"
- .env*
チーム権限
チームメンバーができることを定義:
# .claude/permissions.yaml
roles:
developer:
read: ["src/**", "tests/**", "docs/**"]
write: ["src/**", "tests/**"]
execute: ["npm test", "npm run lint", "npm run build"]
senior:
extends: developer
write: ["src/**", "tests/**", "config/**"]
execute: ["npm run migrate", "npm run deploy:staging"]
lead:
extends: senior
write: ["**"]
execute: ["**"]
# チームメンバーのデフォルトロール
default_role: developer
共有スキルライブラリ
チームスキルの作成
チーム固有のスキルライブラリを構築:
# .claude/skills/team/create-feature.yaml
name: create-feature
description: チーム規約に従って新機能を作成
version: 1.0.0
author: Team Lead
parameters:
- name: name
description: 機能名(kebab-case)
required: true
pattern: "^[a-z][a-z0-9-]*$"
- name: type
description: 機能タイプ
default: page
options: [page, component, api, service]
prompt: |
チーム規約に従って「{{name}}」という{{type}}機能を作成してください:
プロジェクト構造:
- ページはsrc/app/に配置
- コンポーネントはsrc/components/に配置
- APIルートはsrc/app/api/に配置
- サービスはsrc/services/に配置
要件:
- 厳密な型を持つTypeScript
- ユニットテストを含める
- Storybookストーリーを追加(コンポーネントの場合)
- コードベースの既存パターンに従う
一貫性のために類似の既存機能を参照してください。
スキルカテゴリ
目的別にスキルを整理:
.claude/skills/
├── team/
│ ├── create-feature.yaml
│ ├── create-api-endpoint.yaml
│ └── create-component.yaml
├── review/
│ ├── code-review.yaml
│ ├── security-review.yaml
│ └── performance-review.yaml
├── docs/
│ ├── api-docs.yaml
│ ├── component-docs.yaml
│ └── readme-update.yaml
└── testing/
├── unit-test.yaml
├── integration-test.yaml
└── e2e-test.yaml
コーディング標準の強制
スタイルガイドの統合
# .claude/style-guide.yaml
language: typescript
framework: react
rules:
naming:
components: PascalCase
functions: camelCase
constants: UPPER_SNAKE_CASE
files: kebab-case
structure:
max_file_lines: 300
max_function_lines: 50
max_parameters: 4
imports:
order:
- react
- external
- internal
- relative
group_separator: true
comments:
require_jsdoc: true
require_inline: false
testing:
min_coverage: 80
require_tests_for:
- components
- services
- utils
自動レビューチェック
# .claude/review-checklist.yaml
checks:
- name: TypeScript型
description: すべての関数とコンポーネントに適切な型定義があるか
severity: error
- name: テストカバレッジ
description: 新しいコードに80%以上のテストカバレッジがあるか
severity: warning
- name: アクセシビリティ
description: コンポーネントがWCAG 2.1 AA標準に準拠しているか
severity: error
- name: パフォーマンス
description: 不要な再レンダリングやメモリリークがないか
severity: warning
- name: セキュリティ
description: 一般的な脆弱性(XSS、SQLインジェクションなど)がないか
severity: error
- name: ドキュメント
description: 公開APIにドキュメントがあるか
severity: warning
ワークフローの標準化
プルリクエストテンプレート
# .claude/templates/pull-request.md
## 変更内容
<!-- 変更内容を簡潔に説明 -->
## 変更の種類
- [ ] 新機能
- [ ] バグ修正
- [ ] リファクタリング
- [ ] ドキュメント更新
- [ ] パフォーマンス改善
## チェックリスト
- [ ] コードがスタイルガイドに従っている
- [ ] テストを追加/更新した
- [ ] ドキュメントを更新した
- [ ] 破壊的変更がない(またはマイグレーションガイドを追加)
- [ ] AIレビューを実行した(`/review`)
## AIレビュー結果
```bash
/review --comprehensive
<!-- AIレビューの結果をここに貼り付け -->
テスト
<!-- テスト方法を説明 -->スクリーンショット
<!-- 該当する場合、スクリーンショットを追加 -->
### コミットメッセージ規約
```yaml
# .claude/commit-conventions.yaml
format: conventional-commits
types:
- feat: 新機能
- fix: バグ修正
- docs: ドキュメントのみの変更
- style: コードの意味に影響しない変更(空白、フォーマットなど)
- refactor: バグ修正も機能追加もしないコード変更
- perf: パフォーマンスを向上させるコード変更
- test: 欠落しているテストの追加または既存のテストの修正
- chore: ビルドプロセスまたは補助ツールの変更
scopes:
- auth: 認証関連
- api: APIエンドポイント
- ui: ユーザーインターフェース
- db: データベース
- config: 設定
examples:
- "feat(auth): JWTトークンリフレッシュを実装"
- "fix(api): ユーザー作成時の検証エラーを修正"
- "docs(readme): インストール手順を更新"
ナレッジ共有
チームドキュメント
# .claude/team-docs.yaml
documentation:
architecture:
path: docs/architecture/
auto_update: true
sections:
- overview
- data-flow
- api-design
- security
onboarding:
path: docs/onboarding/
includes:
- setup-guide.md
- coding-standards.md
- common-tasks.md
- troubleshooting.md
decisions:
path: docs/decisions/
format: adr # Architecture Decision Records
template: .claude/templates/adr.md
ベストプラクティスライブラリ
# .claude/best-practices/react-components.md
## Reactコンポーネントのベストプラクティス
### 1. コンポーネント構造
```typescript
// ✅ 良い例:明確な構造
interface Props {
title: string;
onSubmit: (data: FormData) => void;
}
export function MyComponent({ title, onSubmit }: Props) {
// フック
const [state, setState] = useState();
// イベントハンドラー
const handleSubmit = useCallback(() => {
// ...
}, []);
// レンダリング
return <div>{/* ... */}</div>;
}
2. パフォーマンス最適化
useMemoで高コストな計算をメモ化useCallbackでイベントハンドラーをメモ化React.memoで不要な再レンダリングを防止
3. アクセシビリティ
- セマンティックHTMLを使用
- ARIA属性を適切に追加
- キーボードナビゲーションをサポート
## コミュニケーションプロトコル
### AIレビューフィードバック
```yaml
# .claude/feedback-protocol.yaml
review_process:
1_ai_review:
trigger: pull_request_opened
action: /review --comprehensive
output: comment_on_pr
2_developer_response:
required: true
options:
- accept: 変更を適用
- discuss: 議論が必要
- reject: 理由を説明
3_team_review:
required_for:
- critical_severity_issues
- architectural_changes
- breaking_changes
4_approval:
minimum_approvals: 2
required_checks:
- ai_review_passed
- tests_passed
- no_merge_conflicts
コードレビューガイドライン
# .claude/guidelines/code-review.md
## コードレビューガイドライン
### レビュアーとして
1. **建設的であること**
- 問題を指摘するだけでなく、解決策を提案
- ポジティブなフィードバックも含める
2. **優先順位をつける**
- Critical:セキュリティ、バグ、破壊的変更
- Major:パフォーマンス、保守性
- Minor:スタイル、命名
3. **AIを活用**
- `/review`で初期レビューを実行
- AIの提案を検証
- 人間の判断を追加
### 作成者として
1. **自己レビュー**
- PRを作成する前に`/review`を実行
- 明らかな問題を修正
2. **コンテキストを提供**
- 変更の理由を説明
- トレードオフを文書化
- テスト戦略を共有
3. **フィードバックに対応**
- タイムリーに応答
- 議論をオープンに保つ
- 学びを文書化
チームメトリクス
パフォーマンス追跡
# .claude/metrics.yaml
tracking:
code_quality:
- test_coverage
- code_complexity
- duplication_rate
- technical_debt
ai_usage:
- reviews_per_week
- suggestions_accepted
- time_saved
- issues_prevented
team_velocity:
- features_delivered
- bugs_fixed
- review_turnaround
- deployment_frequency
reports:
frequency: weekly
recipients:
- team_lead
- engineering_manager
format: markdown
include_trends: true
ダッシュボード
// .claude/dashboard/config.ts
export const dashboardConfig = {
widgets: [
{
type: 'ai-review-stats',
title: 'AIレビュー統計',
metrics: ['total_reviews', 'issues_found', 'time_saved']
},
{
type: 'code-quality',
title: 'コード品質トレンド',
metrics: ['coverage', 'complexity', 'duplication']
},
{
type: 'team-activity',
title: 'チームアクティビティ',
metrics: ['commits', 'prs', 'reviews']
}
],
refresh_interval: 3600, // 1時間
export_formats: ['pdf', 'html', 'json']
};
オンボーディング
新メンバー向けセットアップ
#!/bin/bash
# .claude/scripts/onboard.sh
echo "🎉 チームへようこそ!CCJKをセットアップします..."
# CCJKをインストール
npm install -g ccjk
# チーム設定をクローン
git clone https://github.com/your-team/ccjk-config.git ~/.claude/team
# シンボリックリンクを作成
ln -s ~/.claude/team/config.yaml ~/.claude/config.yaml
ln -s ~/.claude/team/skills ~/.claude/skills
# APIキーを設定
echo "Anthropic APIキーを入力してください:"
read -s API_KEY
echo "export ANTHROPIC_API_KEY=$API_KEY" >> ~/.bashrc
# 検証
ccjk --version
ccjk skills list
echo "✅ セットアップ完了!"
echo "次のステップ:"
echo "1. docs/onboarding/setup-guide.mdを読む"
echo "2. /tutorial を実行してチュートリアルを開始"
echo "3. 最初のPRを作成して/reviewを試す"
トレーニング資料
# .claude/training/getting-started.md
## CCJKを使い始める
### 基本コマンド
```bash
# コードレビュー
/review
# コミットメッセージ生成
/commit
# テスト生成
/test src/components/Button.tsx
# ドキュメント生成
/doc src/api/
チームスキル
# 新機能を作成
/create-feature --name user-profile --type page
# APIエンドポイントを作成
/create-api-endpoint --name users --methods GET,POST
# コンポーネントを作成
/create-component --name Button --type functional
ベストプラクティス
-
PRを作成する前に
/reviewを実行- テストを書く
- ドキュメントを更新
-
レビュー中
- AIの提案を検討
- チームメンバーと議論
- 学びを共有
-
マージ後
- デプロイを監視
- メトリクスを確認
- フィードバックを収集
## トラブルシューティング
### 一般的な問題
```yaml
# .claude/troubleshooting.yaml
issues:
- problem: "AIレビューが遅い"
solutions:
- スコープを制限(--scope src/specific/)
- 小さなPRに分割
- キャッシングを有効化
- problem: "設定が同期されない"
solutions:
- git pullで最新の設定を取得
- シンボリックリンクを確認
- 設定ファイルの構文を検証
- problem: "権限エラー"
solutions:
- ロールを確認(.claude/permissions.yaml)
- チームリードに連絡
- ローカル設定を確認
- problem: "スキルが見つからない"
solutions:
- スキルディレクトリを確認
- ccjk skills listを実行
- スキルリポジトリを更新
セキュリティとコンプライアンス
チームセキュリティポリシー
# .claude/security-policy.yaml
policies:
data_handling:
- no_production_data: true
- anonymize_examples: true
- encrypt_sensitive: true
access_control:
- require_2fa: true
- session_timeout: 3600
- audit_logging: true
code_review:
- security_scan: required
- dependency_check: required
- license_compliance: required
incident_response:
- report_to: security@company.com
- escalation_time: 1h
- documentation: required
まとめ
効果的なチームコラボレーションには:
- 共有設定:一貫した動作のためにチーム設定を使用
- スキルライブラリ:再利用可能なスキルを構築して共有
- 標準化:コーディング標準とワークフローを強制
- ナレッジ共有:ドキュメントとベストプラクティスを維持
- メトリクス追跡:パフォーマンスと改善を測定
- オンボーディング:新メンバーを迅速に立ち上げる
CCJKをチームワークフローに統合することで、一貫性、品質、生産性を向上させることができます。
次へ:CI/CD統合でAI支援ワークフローを自動化する方法を学びます。
よくある質問
チーム設定を個人設定で上書きできますか?
はい、ローカル設定(~/.claude/config.yaml)はプロジェクト設定を上書きします。
チームスキルを非公開にできますか?
はい、プライベートGitリポジトリでスキルをホストし、チームメンバーのみにアクセスを制限できます。
異なるチームで異なる設定を使用できますか?
はい、プロジェクトごとに異なる設定を持つことができます。CCJKは最も近い.claude/ディレクトリを使用します。
チームメトリクスはどのように追跡されますか?
CCJKは使用統計をローカルに記録します。チームダッシュボードのために集約できます。
タグ
#team#collaboration#workflow#configuration#enterprise
関連記事
AIエージェントを理解する:自律的なコーディングアシスタント
CCJKのAIエージェントが、複雑な複数ステップの開発タスクを自律的に処理する方法を探索します。高レベルの意思決定に集中できます。
Jan 8, 202514 min
823#ai-agents#automation#workflow
マルチプロバイダーサポート:AIバックエンドを選択
CCJKは複数のAIプロバイダーをサポートしています。Claude、GPT-4、その他のモデルを設定して切り替える方法を学びます。
Jan 1, 202511 min
1441#providers#configuration#openai
AI支援開発のための高度なプロンプトエンジニアリング
AIコーディングアシスタントで生産性を最大化するための効果的なプロンプトの作成技術をマスターします。エキスパート開発者が使用する実証済みのテクニックを学びます。
Jan 9, 202515 min
1248#prompt-engineering#ai#best-practices