Linear migration metadata¶

• Linear issue: TAK-119
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-119/ai-yaml検証失敗時メッセージをユーザー向けに改善する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAA App
• Linear assignee:
• Linear labels: Improvement
• Linear created: 2026-06-29T03:26:49.015Z
• Linear updated: 2026-06-29T03:26:49.015Z
• Linear archived:

Original description¶

概要¶

AI YAML変更案の事前チェックまたは反映後チェックが失敗した際、開発者向けのvalidatorエラーをそのまま出すのではなく、利用者が次に何を直せばよいか分かるメッセージへ改善する。

現状は fields must be a map や relation references undefined resource のような低レベルエラーが表示されるため、業務利用者には原因と対処が分かりにくい。

要件¶

• metadata検証エラーをユーザー向け説明へ変換できること。
• エラーごとに、原因、対象ファイル/リソース/項目、修正方針を表示できること。
• AI生成に起因する典型エラーは、再依頼文の例または自動修正候補を提示できること。
• 技術詳細ログは折りたたみまたは詳細表示で確認できること。
• 事前チェック失敗時は「YAMLには反映していない」ことを明確に表示すること。

対象例¶

• fields must be a map
• label key has no ja i18n value
• relation references undefined resource
• list column does not reference an existing field
• unsupported type json
• widget=rich_text requires type=string

受入条件¶

• 検証失敗時に、ユーザー向けの日本語要約と具体的な修正方針が表示される。
• 技術ログは必要に応じて確認できる。
• AI反映前チェック失敗時、metadataが変更されていないことが分かる。
• published Generator GUIで代表的な失敗ケースを確認する。

関連¶

• TAK-112
• TAK-115