フィードバックと整合性チェック

生成した仕様書とモックアップの品質を向上させるためのフィードバック・チェック機能の使い方です。

フィードバック機能

フィードバックの送信

/teamkit:feedback YourFeature "住所フィールドを都道府県と市区町村に分割してください"

AIがフィードバック内容を分析し、影響範囲（workflow.yml、usecase.yml、ui.yml、screenflow.md）を特定して、feedback.md に詳細とTODOリストを作成します。

プレビューモード

/teamkit:feedback YourFeature -p "住所フィールドを分割してください"

-p または --preview オプションを付けると、フィードバック内容がすぐにモックアップに反映され、変更結果を視覚的に確認できます。プレビュー時のTODOは [p] マーカーで記録されます。

feedback.md の構成

## Comment
ユーザーからのフィードバック内容

## TODO
- [ ] 1. workflow.yml: 住所フィールドを都道府県と市区町村に分割
- [ ] 2. ui.yml: addressフィールドを2つのフィールドに変更

## Summary
影響範囲と次のアクションの概要

TODOマーカーの意味

マーカー 意味 説明
[ ] 未着手 まだ適用されていない
[o] 適用予定 apply-feedback で適用対象になる
[x] 完了 適用済み
[~] スキップ 適用しないことを決定
[p] プレビュー プレビューモードで記録

フィードバックの適用

  1. feedback.md を確認し、適用したいTODOに [o] マーカーを付ける
  2. Summaryの「Next action」を必要に応じて調整する
  3. 適用コマンドを実行する
/teamkit:apply-feedback YourFeature

apply-feedback は以下を実行します。

  1. [o] マーカーのTODOを読み取る
  2. 次のバージョン番号を決定（現在の最大バージョン + 1）
  3. 対象ファイルごとに変更計画を作成し、差分を表示
  4. 承認ドキュメントを作成
  5. 各ステップの仕様書を再生成
  6. status.json のバージョンを更新
  7. モックHTMLを再生成

推奨ワークフロー

# 1. モックアップを生成
/teamkit:generate-mock YourFeature

# 2. モックアップを確認し、フィードバック（プレビュー付き）
/teamkit:feedback YourFeature -p "改善点のコメント"

# 3. プレビューで確認後、feedback.md の TODO に [o] を付ける

# 4. フィードバックを適用
/teamkit:apply-feedback YourFeature

関連ガイド