Skip to content

ガイド: プロジェクトセットアップの自動化

新しいプロジェクトを始めるとき、素晴らしいアイデアをコードに落とし込む前に、いくつもの定型作業が待ち受けています。CI/CDパイプラインの構築、LinterやFormatterの設定、Gitのコミットフック、PRテンプレート... これらはプロジェクトの品質を維持するために不可欠ですが、毎回ゼロから作るのは手間がかかります。

このガイドでは、@psmメンションを使って、これらの定型的な設定ファイル生成をClaude Codeから自動化し、素早く本質的な開発に取り掛かるための方法を紹介します。

🎯 このガイドで達成できること

  • プロジェクトの言語やフレームワークに応じたCI/CD(GitHub Actions)ワークフローを生成する。
  • pre-commitフックの設定を生成し、コード品質をローカルで維持する仕組みを導入する。
  • LinterやFormatterの設定ファイル、.gitignore、PRテンプレートなどを効率的に作成する。

Step 1: CI/CDワークフローを生成する

継続的インテグレーション(CI)は、現代の開発に不可欠です。MCPにプロジェクトの要件を自然言語で伝えるだけで、基本的なGitHub Actionsのワークフローを生成できます。

シナリオ: Pythonプロジェクトで、push時にテストとカバレッジレポートを実行したい。

@psm Pythonプロジェクト用のGitHub Actionsワークフローを生成してください。`uv`を使い、`pytest`でテストを実行し、`coverage.py`でカバレッジを計測するステップを含めてください。

MCPは、リクエストに応じたYAMLファイルを生成します。これを.github/workflows/ci.ymlとして保存すれば、すぐにCIパイプラインが稼働し始めます。

Step 2: pre-commitフックで品質を維持する

コミット前に自動的にLinterやFormatterを実行するpre-commitフックは、コードベースの品質を一定に保つための強力なツールです。

シナリオ: TypeScriptとYAMLファイルに対して、コミット前にフォーマットとLintを実行したい。

@psm TypeScriptとYAMLファイルのための`.pre-commit-config.yaml`を生成してください。TypeScriptには`prettier`と`eslint`を、YAMLには`prettier`を適用してください。

生成された.pre-commit-config.yamlと、簡単なセットアップ手順(pre-commit install)に従うだけで、チーム全体のコードスタイルを統一できます。

Step 3: 各種設定ファイルを生成する

Linterの設定、.gitignore、PRテンプレートなど、プロジェクトに必要な様々な設定ファイルも同様に生成できます。

Linter設定

@psm Pythonプロジェクト用の`.ruff.toml`を生成してください。セキュリティ関連のルールを含む、厳格な設定でお願いします。

.gitignore

@psm Next.js (TypeScript) プロジェクトのための`.gitignore`ファイルを生成してください。macOSやVSCodeなどの一般的なOS/IDE設定ファイルも除外対象に含めてください。

PRテンプレート

@psm GitHubのPull Requestテンプレート(`.github/pull_request_template.md`)を生成してください。「変更の概要」「関連イシュー」「破壊的変更の有無」のセクションと、セルフレビュー用のチェックリストを含めてください。

まとめ

このガイドで紹介したように、MCPに「何がしたいか」を伝えるだけで、プロジェクトセットアップに関わる多くの定型作業を自動化できます。

これらの作業を効率化することで、チームはより多くの時間を、プロダクトの価値を直接生み出すコーディングに集中できるようになります。

MIT License