audit

概要

auditスキルとは？

auditスキルは、フロントエンド開発者やチームがコードベースの技術的品質を体系的に評価するためのツールです。アクセシビリティ（A11y）、パフォーマンス、テーマの一貫性、レスポンシブデザイン、一般的なアンチパターンをチェックします。スキルは、重大度評価（P0-P3）と実行可能な改善案を含むスコア付きレポートを生成し、改善の優先順位付けと高い品質基準の維持を支援します。

auditを使うべき人

• コード品質の検証を求めるフロントエンドエンジニア
• アクセシビリティやパフォーマンスに注力するQAチーム
• コンプライアンス準備やリリース前のプロジェクトリーダー
• 構造化されたコードレベルの監査が必要な方（デザイン批評ではありません）

解決する課題

• アクセシビリティの不足（コントラスト、ARIA、キーボード操作、セマンティックHTML、代替テキスト、フォーム）を特定
• パフォーマンスのボトルネックを検出
• テーマやレスポンシブデザインの問題を指摘
• アンチパターンや技術的負債を発見
• 明確な重大度評価と次のステップを提示

使い方

インストール手順

1. 以下のコマンドでauditスキルをインストールします：

   npx skills add https://github.com/pbakaus/impeccable --skill audit
   

2. 詳細な手順やスコアリング基準はSKILL.mdを参照してください。

準備

• auditを実行する前に、/frontend-designを呼び出してデザインのコンテキストやアンチパターンを収集します。デザインコンテキストがない場合は、まず/teach-impeccableを実行してください。
• auditスキルは測定可能な技術的側面に焦点を当てており、問題を修正するのではなく記録してフォローアップを促します。

auditの実行

• スキルを使ってフロントエンドコードベースをスキャンします。以下の5つの主要な観点をチェックします：
  • アクセシビリティ（A11y）
  • パフォーマンス
  • テーマ
  • レスポンシブデザイン
  • アンチパターン
• 各観点は0（重大な問題）から4（優れた準拠）までスコア付けされます。
• 出力は、重大度評価（P0-P3）と実行可能な推奨事項を含む包括的なレポートです。

ファイル構成とレビュー

• ワークフローやスコアリングの詳細はSKILL.mdから始めてください。
• README.md、AGENTS.md、metadata.json、およびrules/、resources/、references/、scripts/などのフォルダも参照し、追加のコンテキストを得られます。

よくある質問

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

いいえ。auditスキルはコードレベルの技術チェックを行います。デザイン批評には/frontend-designや関連スキルを使用してください。

auditレポートには何が含まれますか？

レポートはアクセシビリティ、パフォーマンス、テーマ、レスポンシブデザイン、アンチパターンをカバーし、それぞれスコアと重大度に基づく優先順位が付けられています。

auditは問題を自動修正できますか？

いいえ。auditは問題を記録し実行可能な改善案を提供します。修正は他のスキルや手動で行ってください。

スコアリング基準はどこで確認できますか？

スコアリングの詳細やチェックリストはSKILL.mdにあります。ファイルタブで全ファイルツリーや補助スクリプトも確認できます。

いつauditを使うべきですか？

リリース前、コンプライアンスチェック時、または定期的なコード品質レビューの一環として使用し、フロントエンドが技術基準を満たしていることを確認してください。