軽微な変更
/new-minor-featureスキルを使った小規模な機能追加・バグ修正・クイックアップデートのステップバイステップワークフロー。
概要
単一の機能追加、バグ修正、1セッションで完了するクイックアップデートには、Claudeで**/new-minor-feature**スキルを使えます。プランモード、実装、ビルド検証、PR作成までガイドし、レビューとマージはGitHubであなたが行います。
このワークフローは次の場合に使います：
- 単一の機能追加やバグ修正
- UI調整やコンテンツ更新
- 1セッションで終わり、アーキテクチャの決定が不要な作業
タスクが複数日にわたる場合や構造化された計画が必要な場合は、代わりにフェーズ開発を使ってください。
/new-minor-featureスキル
/new-minor-featureスキルは、mainからプラン、Claudeと実装、ビルド検証、コミットとPR作成まで一連の流れを案内します。レビューとマージはClaudeは行いません。CIが通り、プレビューを確認したあと、あなたがGitHubで行います。
使い方
Claudeで次のように入力します：
スキルを実行text
/new-minor-feature続けて、やりたいこと（機能追加、バグ修正、ドキュメント更新など）と対象アプリを伝えます。Claudeがプランモードでリクエストとモノレポガイドライン（CLAUDE.md）を分析し、mainからフィーチャーブランチを作成してから、ステップごとに実装を進めます。
あなたが行うこと
- セッション開始 — アプリ名とやりたいことをClaudeに伝える。プランモードで
mainからフィーチャーブランチを作成してもらう。 - 実装 — Claudeと一緒に変更を加える。
- ビルド検証 — コミット前にClaudeにビルドを実行してもらう（必須。省略するとCIで失敗する）。
- コミットとPR作成 — 変更をコミットして
mainへのプルリクエストを作成してもらう。ClaudeがPRのURLを返す。 - レビューとマージ（あなた） — CIが通るのを待ち、PRをレビューし、PRコメントに投稿されるプレビューURLで動作を確認してからGitHubでマージ。レビューとマージはClaudeは行わない。
スキルの実行内容
裏側では、/new-minor-featureはあなたと一緒に次のステップを進めます。
ステップ1：プランとブランチ
| 実行内容 | 詳細 |
|---|---|
| ガイドラインを読む | ClaudeがCLAUDE.mdを読み、モノレポのルールを適用 |
| リクエストを分析 | Claudeが必要に応じて質問 |
| 計画を作成 | Claudeが実装計画を作成 |
| ブランチを作成 | Claudeがmainからフィーチャーブランチを作成（または実行用のgitコマンドを案内） |
例：セッションを開始
Claudeプロンプトmy-app-name: このアプリで作業したいです。
まず、プランモード（PLAN MODE）で私のリクエストとモノレポガイドライン（CLAUDE.md）を分析してください。mainブランチから開始し、以下のタスク用にフィーチャーブランチを作成してください。必要に応じて質問してください。
やりたいこと：
- [ ] 機能追加 / バグ修正 / ドキュメント更新
- [ ] [達成したいことを記述]
[追加のコンテキストや要件があればここに記載]
ステップ2：実装とビルド検証
| 実行内容 | 詳細 |
|---|---|
| 実装 | あなたとClaudeが変更を加える |
| ビルド実行 | 重要： コミット前にpnpm build:<app-name>を実行 — CIが走らせるのと同じチェック |
アプリをローカルで起動することはありません。動作確認はpush後、PRのプレビューURLで行います（ステップ4参照）。
Claudeにビルド検証を依頼
Claudeプロンプトコミット前に、my-app-nameのビルドを実行してすべて正しくコンパイルされることを確認してください。
ステップ3：コミットとPR作成
| 実行内容 | 詳細 |
|---|---|
| ステージングとコミット | Claudeがコンベンショナルなコミットメッセージを使用 |
| プッシュ | Claudeがリモートのフィーチャーブランチにプッシュ |
| PR作成 | Claudeがgh pr create --base main --fillを実行し、PRのURLを返す |
ClaudeにコミットとPR作成を依頼
Claudeプロンプトビルドが通りました。変更をコミットして、mainへのプルリクエストを作成してください。
コミットメッセージの形式
| プレフィックス | 用途 |
|---|---|
feat: | 新機能 |
fix: | バグ修正 |
docs: | ドキュメント |
chore: | メンテナンス |
ステップ4・5：あなたの作業 — レビューとマージ
PRが開いたあと：
- CI — リント、型チェック、ビルドが自動で実行される。すべてのチェックが通る（緑）まで待つ。
- レビュー — PRの説明と差分を確認し、必要ならPRを編集。レビューと承認はClaudeは行わない。行うのはあなた。
- プレビュー — プレビューデプロイが実行される（ステージング + Neon DBブランチ）。PRコメントにプレビューURLが記載される。そのURLで変更をテストする。
- マージ — 承認とチェック通過後、GitHubでPRを
mainにマージ。マージはClaudeは行わない。行うのはあなた。マージ後、変更は自動で本番にデプロイされる。
まとめチェックリスト
- プランモード使用済み；
mainからフィーチャーブランチ作成済み - 変更実装済み；
pnpm build:<app-name>がローカルで通っている - コンベンショナルなプレフィックスでコミット済み；プッシュ済み；
mainへのPR作成済み - あなた：CI通過；プレビューURLで動作確認済み；GitHubでPRマージ済み
手動で実行する場合
スキルを使わずに進めたい場合：
ブランチ作成、開発、コミットとPRbash
# mainに切り替えて最新を取得
git checkout main
git pull origin main
git checkout -b feature/your-feature-name
# 変更後：ビルドを実行
pnpm build:your-app-name
# ステージング、コミット、プッシュ、PR作成
git add .
git commit -m "feat: 新機能の説明"
git push -u origin feature/your-feature-name
gh pr create --base main --fillその後、CIを待ち、レビューし、プレビューでテストしてから、GitHubでPRをマージします。
クイズ
Quiz
変更をコミットする前に何をすべきですか？
避けるべき一般的なミス
- ❌
mainに直接コミットする - ❌
pnpm build:<app-name>をスキップする - ❌ ブランチ作成前に最新の変更をプルしない
- ❌ 不明確なコミットメッセージを使用する