AI PRの進め方

VibeProの通常ワークフローでは、PR作成を証跡の後ろに置きます。

1. Storyを定義または選択する

既知の機能追加や不具合修正では vibepro init を使います。

vibepro init /path/to/repo \
  --story-id story-<short-name> \
  --title "<title>" \
  --language ja

既存Storyがある場合は、選択前に一覧表示または対応付けを確認します。

vibepro story list /path/to/repo
vibepro story map /path/to/repo

2. 実装前に診断する

リポジトリやStoryに不確実性がある場合は広めに診断します。

vibepro check all /path/to/repo \
  --story-id <story-id> \
  --base <base-branch>

リスクが明確な場合は、対象を絞った診断を使います。

vibepro check ui /path/to/repo --story-id <story-id>
vibepro check security /path/to/repo --story-id <story-id>
vibepro check performance /path/to/repo --story-id <story-id>
vibepro check architecture /path/to/repo --story-id <story-id>
vibepro check pr-readiness /path/to/repo --story-id <story-id> --base <base-branch>

3. PR証跡を準備する

実装差分ができたら pr prepare を実行します。

vibepro pr prepare /path/to/repo \
  --base <base-branch> \
  --story-id <story-id>

このコマンドは変更を分類し、PR用の生成物を作り、次に実行すべきコマンドを出します。必須ゲートが未解決なら、次のコマンドはPR作成ではなく、レビュー、検証、または再準備へ戻るはずです。

4. 証跡を記録する

実際に実行した内容を記録します。

vibepro verify record /path/to/repo \
  --id <story-id> \
  --kind typecheck \
  --status pass \
  --command "npm run typecheck"

コマンドが実行できなかった場合は、pass を捏造せず、実際の状態を記録します。

5. VibeProのPR経路を使う

PR作成可能になったら:

vibepro pr create /path/to/repo \
  --base <base-branch> \
  --head <branch> \
  --story-id <story-id>

実際にPRを作らず、作成可能かだけ確認する場合:

vibepro pr ship /path/to/repo \
  --base <base-branch> \
  --head <branch> \
  --story-id <story-id> \
  --dry-run