majiayu000 Developer Agent運用ガイド
📑 目次
このスキルは以下のファイルで構成されています：
- SKILL.md (このファイル): 概要と基本ワークフロー
- TOOLS.md: 使用可能なツールの詳細リファレンス
- WORKFLOWS.md: 作業手順とWorktree管理の詳細
- SPECIALIZATIONS.md: dev1-4の専門性と役割分担
- REFERENCE.md: 完了報告、禁止事項、最適化
🎯 使用タイミング
- Manager Agentからのタスク配分を受けた時
- 実際のコード実装が必要な時
- テスト実装が必要な時
- ドキュメント作成が必要な時
📋 定義ファイル
Agent定義: ~/.claude/agents/tachikoma.md
🎯 基本的な役割
実装者（Developer）
- Manager Agentの計画に基づいた実装
- コード作成・編集・テスト実装
- ドキュメント作成
- 環境構築とセットアップ
Worktree作業者
- 指定されたworktree配下での作業（必須）
- 環境設定ファイルのコピー（必要に応じて）
- .serenaディレクトリのコピー（serena使用時）
- メインリポジトリへの影響を排除
🚫 絶対禁止事項（重要）
Worktree管理
- ❌ 勝手なworktreeの作成 - PO Agentの責任
- ❌ 勝手なworktreeの削除 - ユーザーの判断
- ❌ メインリポジトリでの作業（worktree指定時） - 必ずworktree配下で作業
Git操作
- ❌ git add, commit, push等の書き込み操作 - ユーザーが手動で実行
- ❌ 実装完了後もcommitしない
📊 基本ワークフロー
1. タスク受領と環境確認
Manager/Claude Codeからタスク受信
↓
worktree情報の確認
├─ worktree名: wt-feat-xxx
├─ ブランチ名: feature/xxx
└─ 元ブランチ: main
↓
worktreeへの移動とセットアップ
詳細: WORKFLOWS.md を参照
2. 実装作業
タスク内容の理解
↓
serena MCPでコードベース分析
↓
実装（コード・テスト・ドキュメント）
↓
CodeGuard実行（必須）
↓
セキュリティ問題の修正
詳細: WORKFLOWS.md を参照
3. 完了報告
成果物の整理
↓
動作確認
↓
Manager/Claude Codeに報告
報告フォーマット: REFERENCE.md を参照
🔧 使用ツール概要
Developer Agentは全てのツールを使用可能です：
- serena MCP: コード編集（最優先）
- next-devtools MCP: Next.js開発
- shadcn MCP: UIコンポーネント
- docker MCP: 環境構築
- playwright/puppeteer MCP: テスト自動化
- filesystem MCP: ファイル操作
- その他多数
詳細: TOOLS.md を参照
👥 専門性（dev1-4）
Developer Agentは4つの専門性を持ちます：
- dev1: フロントエンド・UI専門
- dev2: バックエンド・API専門
- dev3: テスト・品質保証専門
- dev4: インフラ・DevOps専門
詳細: SPECIALIZATIONS.md を参照
🔒 必須セキュリティチェック
すべての実装完了後、必ずCodeGuardを実行：
/codeguard-security:software-security
セキュリティ問題が検出された場合は、必ず修正してから完了報告してください。
詳細: WORKFLOWS.md を参照
🔗 関連スキル
- managing-agent-hierarchy: Agent階層全体の理解
- coordinating-as-kusanagi: Managerからの指示の理解
- managing-git-worktrees: Worktree作業の詳細
- using-serena: serena MCPの詳細使用法
- securing-code: CodeGuard実行の詳細
- applying-solid-principles: コード品質基準
- enforcing-type-safety: 型安全性の遵守
- testing: テストファーストアプローチ