frontend-impl-and-review
ユーザーが `$frontend-impl-and-review` と明示的に呼び出した場合に限り、フロントエンド実装後の規約レビュー・自動修正・報告を一気通貫で行う。通常のフロントエンド実装依頼では自動起動しない
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- frontend-impl-and-review
- description
- ユーザーが `$frontend-impl-and-review` と明示的に呼び出した場合に限り、フロントエンド実装後の規約レビュー・自動修正・報告を一気通貫で行う。通常のフロントエンド実装依頼では自動起動しない
03 SKILL.md 正文
Frontend 実装 & レビュー
起動条件
- 現在のユーザーメッセージに
$frontend-impl-and-reviewが明示されている場合だけ実行する。 - 通常のフロントエンド実装・修正・レビュー依頼から暗黙に起動してはならない。
- 明示呼び出しなしで読み込まれた場合は、以降の Phase を実行せず、通常の手順で依頼へ対応する。
フロントエンドの実装を行い、完了後に docs/review/frontend.md に基づくセルフレビューを実施する。
直接影響の違反は修正し、間接的・判断が難しい違反は報告文書として保存する。
前提: ブランチ名からチケット ID を抽出
git branch --show-current を実行し、ブランチ名から PFM-\d+ を抽出する。
以降、このチケット ID を $TICKET_ID として使用する。
抽出できない場合はユーザーに確認する。
Phase 1 — 実装
$ARGUMENTS で指定されたタスクを実装する。
実装時は以下のスキルの規約に従うこと:
/frontend-component,/frontend-hook,/frontend-lib,/frontend-page,/frontend-util(新規ファイル作成時)docs/conventions/frontend-*.md(既存ファイル編集時)
実装が完了したら Phase 2 に進む。
Phase 2 — 機械チェック & 自動修正
frontend/ ディレクトリで以下を 順番に 実行する。
pnpm check:fix— Biome format + lint(自動修正)pnpm knip --fix --no-exit-code— 未使用 export / import の自動削除pnpm tsgo— 型チェック
- 自動修正で変更されたファイルがあれば記録する
- エラーが残った場合はエラーを修正してから再実行する
- 全パスしたら Phase 3 に進む
Phase 3 — Agent レビュー
対象スコープ
git diff --name-only -- frontend/ で 未コミットの変更ファイル一覧 を取得する(今回の実装で変更したファイルのみ)。
レビュー実行
3 つのロール(Frontend Expert / Software Engineer / Design Engineer)を Agent として 並列スポーン する。
各 Agent には以下を含める:
docs/review/frontend.mdとそこからリンクされた すべての規約ファイル を Read する- 対象スコープ内の 全ファイルの全内容 を読み込む
- チェックリストに沿って違反を検出し、以下の形式で報告する:
- ファイルパス:行番号 / 違反している規約 / 問題の説明 / 修正案 / 直接影響かどうか
「直接影響」の判定基準:
- 直接影響: 今回の diff で追加・変更した行、またはその変更が直接的に引き起こした問題
- 間接影響: 変更ファイル内だが今回の diff に含まれない既存コードの問題、または判断が難しいもの
ロール別の重点観点
Frontend Expert: コンポーネント分割、Container/Presentational、App Router/RSC、hooks ルール、状態管理、パフォーマンス、型安全性
Software Engineer: 可読性・保守性、DRY/SOLID、エラーハンドリング、ロジックの正確性、バックエンド仕様との整合、セキュリティ
Design Engineer: UI/インタラクション一貫性、デザインシステム活用、スタイリング規約、アクセシビリティ、UX ライティング
Phase 4 — 振り分け & 対応
Agent レビュー結果を統合・重複排除し、各指摘を以下の 2 カテゴリに振り分ける。
A. 直接影響 → 修正する
今回の変更が直接的に引き起こした規約違反を修正する。
修正後、Phase 2(機械チェック)を再実行して問題がないことを確認する。
B. 間接影響・判断が難しい → 報告文書を保存する
以下のパスに Markdown ファイルとして保存する:
docs/spec/PFM-{$TICKET_ID}-*/PFM-{$TICKET_ID}-review-{連番}.md
ファイルパスの決定手順
docs/spec/配下でPFM-{$TICKET_ID}-*に一致するディレクトリを探す- そのディレクトリ内で
*-review-*.mdに一致するファイルの最大連番を取得する - 最大連番 + 1 で新しいファイルを作成する(既存ファイルは上書きしない)
例:
- 既存:
docs/spec/PFM-164-fr-file-unique-by-building-month/PFM-164-review-01.md - 新規:
docs/spec/PFM-164-fr-file-unique-by-building-month/PFM-164-review-02.md
ディレクトリが見つからない場合はユーザーに確認する。
報告文書のフォーマット
# PFM-{$TICKET_ID} フロントエンドレビュー報告
ブランチ: `{ブランチ名}`
日付: {YYYY-MM-DD}
## 概要
{実装内容の1行サマリー}
## 間接影響・要検討の指摘
### {指摘番号}. {指摘タイトル}
- **ファイル**: `{パス}:{行番号}`
- **違反規約**: {規約名}
- **問題**: {説明}
- **修正案**: {提案}
- **指摘元**: {ロール名}
## サマリー
- 直接影響(修正済み): N 件
- 間接影響(本報告): N 件
Phase 5 — 最終確認
Phase 2 の機械チェックを最終実行し、すべてパスすることを確認する。
以下を報告して完了:
- 実装内容のサマリー
- 直接影響で修正した件数と内容
- 間接影響の報告文書のパス(作成した場合)
04 同仓库更多 Skills
why
「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。
what-did-i-get-done
ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する
unslop
あらゆる文章から AI の痕跡を削る。常に適用しなければならない。
typescript-best-practices
TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。
thermo-nuclear-code-quality-review
抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。
technical-writing
階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。