implement-frontend
Codex implementation レーン 側の frontend 実装作業プロトコル。画面導線、状態、Wails bridge の判断基準を提供する。
- License 许可
- Apache-2.0
- 最近更新
- 2026-07-15
- Stars
- ★ 15
- Forks
- 1
01 前言 Front Matter
- name
- implement-frontend
- description
- Codex implementation レーン 側の frontend 実装作業プロトコル。画面導線、状態、Wails bridge の判断基準を提供する。
02 资源文件 1
- 参考文档agents/openai.yaml55 B
03 SKILL.md 正文
Implement Frontend
目的
この skill は作業プロトコルである。
frontend_implementer agent が frontend 承認済み実装範囲 を実装する時に、画面導線、状態 反映、Wails bridge 呼び出しを守る判断基準を提供する。
対応ロール
frontend_implementerが使う。- 呼び出し元は
implement_laneまたはlight_change_laneとする。 - 返却先は呼び出し元とする。
- 担当成果物は
implement-frontendの出力規約で固定する。
入力規約
- frontend 実行入力:
implementation-scopeから切り出された frontend 実装用 引き継ぎ 1 件、または 軽量変更レーンの軽量変更計画。 - UI 根拠: 承認済み
ui-design.md、または 軽量変更レーンの軽量変更計画と人間確認観点。 - 実行中タスク成果物場所: 実装結果、検証結果、停止理由を書き戻す作業計画フォルダまたは run 成果物フォルダ。
- 実装対象: 変更してよい frontend ファイル、symbol、公開接点。
- 対象変更範囲: 実装してよい frontend プロダクトコード範囲。
- 依存完了情報: 着手前に完了している必要がある依存対象の完了結果。
- 検証コマンド: 実行を許可された frontend-local の harness command。
外部参照規約
- エージェント実行定義と実行境界は frontend_implementer.toml に従う。
- コーディング規約: coding-guidelines-frontend.md とする。
- lint 規約: lint-policy.md とする。
- architecture 規約: architecture.md の frontend 境界だけを参照する。
- fakeAPI 運用仕様: fakeAPI を使う frontend 実装では frontend-fake-api.md を参照する。
- UX 観点正本: UX-standard.md とする。
agent-browser利用規約: agent-browser.md とする。- UI 設計規約:
ui-design.mdを受け取る場合は ui-design の UI 要件契約に従う。 - 外部成果物 が不足または衝突する場合は停止し、衝突箇所を返す。
内部参照規約
- なし。UX 観点は
docs/UX-standard.mdと task-localui-design.mdのUX Standard Reviewを正本にする。
判断規約
- 画面導線と 状態 反映を frontend 実行入力 に合わせる
- Wails bridge 呼び出しの境界を守る
- generated
wailsjsは gateway 境界に閉じ込める - 承認済み UI 根拠と
docs/UX-standard.mdに従い、実画面と UI 根拠 の差分を確認する - UI 根拠確認の差分は、承認済み実装範囲 内で修正できる差分と呼び出し元へ戻す差分へ分ける
- frontend 実行入力 と 承認済み実装範囲 を確認して プロダクトコード だけを変更する
- 明確なブロッカーがない限りはレーンを中断せずに成果物の生成を継続すること。
- UI 状態 の初期値と更新条件を確認する
- architecture.md の frontend 境界に従い、View、ScreenController、Frontend UseCase、Gateway の責務を跨がない
- generated
wailsjsと backend DTO の import はfrontend/src/controller/wails/に閉じ込める
非対象規約
- backend だけの変更、design mock 作成、UI check だけの作業は扱わない。
- UI 根拠にない改善は追加しない。
- プロダクトテスト、検証データ、スナップショット、test helper は変更しない。
- Wails bridge と backend DTO の境界を迂回しない。
- docs や作業流れ文書は変更しない。
- coverage、harness all、repo-local Sonar issue 判定条件は必須完了条件にしない。
出力規約
- 判断結果: frontend プロダクトコード実装の完了、未完了、停止の判定を返す。
- 根拠参照: 実装の根拠にした入力、変更箇所、検証結果を返す。
- 不足情報: 実装を完了できない不足項目を返す。
- 次判断材料: 呼び出し元が次を判断できる材料を返す。
- 実装成果物: frontend 実行入力 の 承認済み実装範囲 に対応する frontend プロダクトコードだけを返す。
- レーン内検証結果:
python3 scripts/harness/run.py --suite frontend-localの失敗時はその場で直して再実行し、通過結果または未実行理由を返す。 - UI 根拠確認結果: 実画面と UI 根拠 の一致、差分、未確認理由、
docs/UX-standard.mdとの対応を返す。 - UI証跡参照:
agent-browserの snapshot、screenshot、console、errors の参照または未取得理由を返す。 - 禁止事項: 出力にツール権限、エージェント実行定義、プロダクトコード変更の指示を含めない。
完了規約
- 承認済み実装範囲 内の成果だけが返却されている。
- 検証、未実行項目、残留リスク が 根拠参照 付きで整理されている。
- frontend 実行入力、実装対象、対象変更範囲、依存完了情報、検証コマンドを確認した。
- UI 根拠 を確認した。
- 画面導線と 状態 反映を確認した。
- Wails bridge 境界を確認した。
- generated
wailsjsを gateway 境界に閉じ込めた。 - UI 状態 の初期値と更新条件を確認した。
- 承認済み UI 根拠、
docs/UX-standard.md、frontend コーディング規約に合わせて実装した。 - 実画面と UI 根拠 の一致確認結果を返した。
- UI 根拠確認結果は、
agent-browserの snapshot、screenshot、console、errors の根拠または未取得理由を含んでいる。 - frontend lint と format:check で拾われる境界違反を確認した。
- frontend 変更として
python3 scripts/harness/run.py --suite frontend-localを実行し、失敗した場合は承認済み実装範囲 内でその場で直して再実行し、通過結果または未実行理由を返した。
停止規約
- backend だけの変更を実装する時
- design mock を作る時
- UI check だけを行う時
- frontend 実行入力、UI 根拠、実装対象、対象変更範囲、依存完了情報、検証コマンドが不足する場合は停止する。
- 通信境界を迂回する必要がある場合は停止する。
- View、ScreenController、Frontend UseCase から generated
wailsjsを直接 import する必要がある場合は停止する。 - gateway 以外で backend DTO 変換が必要な場合は停止する。
- プロダクトテスト、検証データ、スナップショット、test helper の変更が必要になる場合は停止する。
- 実画面と UI 根拠 の差分が承認済み実装範囲 外の修正を必要とする場合は停止し、呼び出し元へ戻す。
- UI 根拠確認に必要な実画面確認根拠を取得できない場合は停止し、未取得理由と戻し先を返す。
python3 scripts/harness/run.py --suite frontend-localの失敗原因が承認済み実装範囲 外にある場合は停止する。- 承認済み実装範囲外へ実装を広げる必要がある場合は停止する。
- 停止時は不足項目、衝突箇所、戻し先を返す。
04 同仓库更多 Skills
deploy-app
Deploy the application to staging or production environments.
deploy
Deploy the application to environments.
building-native-ui
Complete guide for building beautiful apps with Expo Router. Covers fundamentals, styling, components, navigation, animations, patterns, and native tabs.
create-section
Use when creating a new section for the AI Workshop presentation. Guides through title slide setup, layout choices, and content gathering. Activates when user wants to add a new topic section to the slideshow.
ship-checker
Run a full pre-ship review for this repo. Use when asked if a change is ready to deploy, publish, or ship.
lint-check
Run repository linters and report failures.