audit

概要

auditスキルとは？

auditスキルは、ウェブインターフェースの技術的品質を体系的にチェックしたいフロントエンド開発者やチーム向けに設計されています。アクセシビリティ、パフォーマンス、テーマ設定、レスポンシブデザイン、一般的なアンチパターンに関するコードレベルの監査を実施。P0（重大）からP3（軽微）までの評価を含むスコア付きレポートを生成し、改善のための具体的な提案を提供します。アクセシビリティ基準の遵守やパフォーマンス最適化、高品質なフロントエンドコードの維持を目指すプロジェクトに最適です。

auditを使うべき人

• コード品質の向上を目指すフロントエンド開発者
• アクセシビリティやパフォーマンスのレビュー準備をするチーム
• WCAG準拠やレスポンシブデザインのベストプラクティスを目指すプロジェクト
• リリース前やリファクタリング前に体系的な技術監査が必要な方

解決できる課題

• アクセシビリティの不足点（コントラスト、ARIA、キーボード操作、セマンティックHTML、altテキスト、フォーム）を特定
• パフォーマンスのボトルネックやアンチパターンを検出
• テーマの一貫性やレスポンシブデザインの問題をチェック
• 直接コードを変更せずに問題を記録し、対応を促進

使い方

インストール手順

1. 以下のコマンドでauditスキルをインストールします：
   npx skills add https://github.com/pbakaus/impeccable --skill audit

初期設定

• auditのワークフローを詳しく解説したSKILL.mdファイルから始めてください。
• README.md、AGENTS.md、metadata.jsonなどの補助ファイルも確認し、背景情報を把握しましょう。
• rules/、resources/、references/、scripts/フォルダには追加のガイドや補助スクリプトが含まれています。

ワークフローのポイント

• auditを実行する前に、デザインコンテキストを収集するために/frontend-designを呼び出し、Context Gathering Protocolに従ってください。
• デザインコンテキストがない場合は、まず/teach-impeccableを実行してください。
• auditスキルは5つの主要分野で診断スキャンを行い、それぞれ0（重大）から4（優良）まで評価します。
• 監査対象を指定する引数ヒント（feature、page、componentなど）を利用可能です。
• 問題を記録しますが修正は行わないため、修正には別のコマンドを使用してください。

推奨プレビュー対象ファイル

• SKILL.md（主なワークフローと評価基準）

よくある質問

auditスキルは何をチェックしますか？

auditスキルは、コード実装レベルでアクセシビリティ、パフォーマンス、テーマ設定、レスポンシブデザイン、アンチパターンをチェックします。各分野を評価し、具体的な改善提案を含むレポートを生成します。

auditはデザインレビューに適していますか？

いいえ、auditは技術的なコード品質に焦点を当てています。デザインレビューには/frontend-designや関連スキルを利用してください。

監査の準備はどうすればいいですか？

/frontend-designを使ってContext Gathering Protocolに従いデザインコンテキストを収集してください。コンテキストがない場合は、まず/teach-impeccableを実行してください。

補助スクリプトや参考資料はどこで見つけられますか？

Filesタブを開くと、ネストされたreferencesや補助スクリプトを含むファイルツリー全体を確認できます。