Communitygithub.com

husheng-web/personal-website-skills

ポートフォリオサイトのルートを、承認されたビジュアルリファレンスとデスクトップ・モバイルサイズで比較し、証拠に基づいたビジュアル欠陥と修正箇所を報告します。

personal-website-skills とは?

このスキルは、ポートフォリオサイトの特定のルート(ページや状態)を、あらかじめ承認されたビジュアルリファレンスと比較し、視覚的な欠陥を発見・報告するためのものです。コードレビューではなく、実際にレンダリングされた出力をデスクトップとモバイルの両方のビューポートサイズで検証します。階層構造、タイポグラフィ、スペーシング、色、コントラスト、レスポンシブ対応、インタラクティブ状態、キーボード操作の到達可能性、モーション削減動作など、幅広い項目をチェックします。発見された問題は優先度(P1~P3)で分類され、影響を受けるルート、実際の挙動、考えられる原因、最小限の修正案が具体的に報告されます。このスキルはClaude CodeやCodexなどのAIエージェントで利用でき、開発者がビジュアル品質を効率的に担保するのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/husheng-web/personal-website-skills/tree/HEAD/skills/portfolio-visual-qa

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ポートフォリオビジュアルQA

コードのみのレビューではなく、ビジュアル検証を実行します。

セットアップ

リファレンス、ルート、UI状態、ビューポートサイズ、およびタスクが実装を許可するかどうかを確認します。確立されたコマンドでサイトを起動し、要求されたサイズでレンダリング出力を検査します。リクエストで指定されていない場合は、モバイルサイズを1つ含めてください。

比較

階層構造、タイポグラフィとワードラップ、スペーシングとジオメトリ、色とコントラスト、アセットの忠実度、レスポンシブなクロップ/オーバーフロー、インタラクティブ状態を評価します。モーションやナビゲーションが関わる場合は、キーボード操作の到達可能性とモーション削減動作を確認します。

報告

まずエビデンスと制限事項を述べます。発見事項を優先度ごとにグループ化します:

  • P1: 意図された階層構造、アクセス、またはコアタスクを妨げるもの。
  • P2: 重大なビジュアルまたはレスポンシブの不一致。
  • P3: 後回しにできる微調整。

各発見事項について、影響を受けるルート/状態、観察された動作、考えられる原因、および最も信頼性の高い最小限の修正を明記します。影響を受けるビューポートで修正を再テストしてください。ブラウザキャプチャまたは対象リファレンスが利用できなかった場合、ビジュアルチェックが合格したと主張しないでください。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

関連スキル