ns-best-practices について
ns-best-practicesは、Webアプリやゲートウェイ、静的アセットの品質とセキュリティ衛生を確認するスキルです。セキュリティ、互換性、アクセシビリティ、画面ガイドラインを対象に応じて点検し、報告や依頼に応じた最小限の修正を行います。
主な機能
- 01セキュリティ設定と依存関係の確認
- 02ブラウザー互換性の基準レビュー
- 03アクセシビリティの簡易確認
- 04Webインターフェースガイドライン監査
- 05重要度別の指摘と推奨事項
活用シーン
- 01セキュリティヘッダーや依存関係の確認
- 02ブラウザー互換性のレビュー
- 03ランドマーク、ラベル、代替テキストの監査
- 04画面ガイドラインへの準拠確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill ns-best-practicesインストール後、Claude Code で/ns-best-practicesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonreferences/checklist.mdui-guidelines-review.md詳細
ベストプラクティス
品質とセキュリティ衛生に焦点を当てたレビューです。シニアによるコードレビューやビジュアルデザインの方針に代わるものではありません。
セッションの開始
../ns-harness/references/session-boot.mdを参照してください。architecture-rules.mdとセキュリティ関連のハーネスルールを読みます。
使用する場面
| リクエスト | このスキル | 代わりに使用 |
|---|---|---|
| セキュリティヘッダー/CSP/HSTS | はい | — |
| 依存関係の監査/既知のCVEの一斉確認 | はい | — |
| ブラウザー互換性のベースライン | はい | — |
| アクセシビリティの簡易チェック(ランドマーク、代替テキスト、ラベル) | はい | — |
| 「UIをレビューして」/Web Interface Guidelines/UXとアクセシビリティの監査 | はい(references/ui-guidelines-review.md) | — |
| 個性的なビジュアルへの再設計/凡庸さを避ける美学 | いいえ | ns-frontend-design |
| 「このMRをレビューして」/SOLIDの詳細な検討 | いいえ | ns-reviewer |
| 新機能の実装 | いいえ | ns-coder/ns-spec-driven |
ワークフロー
- 対象範囲 — Webアプリの範囲、APIゲートウェイ、静的アセット、または
prototype/。 - ベースライン —
references/checklist.mdを読み、該当するセクションだけにチェックを付けます(オフライン時のセキュリティ/互換性/アクセシビリティ)。 - ガイドライン — UI/アクセシビリティ/UXの監査を行う場合、または呼び出し元が
ns-proto-creatorでクローズアウトする場合は、references/ui-guidelines-review.mdを最後まで読みます(ルールは同梱済みで、外部から取得する必要はありません)。 - スキャン — 設定(nginx、Vite、Next、Laravelのミドルウェアなど)を確認します。スタックを前提にしないでください。
- 報告 — 検出事項を表にまとめます。深刻度、場所(可能であれば
file:line)、推奨事項、作業量を記載します。 - 修正 — ユーザーが実装を依頼した場合は、安全最小限の差分で修正します。それ以外は報告のみとします。
他のスキルとの重複
- このスキル: 横断的な衛生管理とWeb Interface Guidelinesへの準拠。
- ns-frontend-design: 個性的な外観、タイポグラフィ、モーション、汎用的なAI UIの回避。
- ns-reviewer: 差分を対象とする変更固有のSOLID、テスト、保守性の確認。
デリバリーでは順番に使用する場合があります。スキルの振り分けは明示的に行います。
禁止事項
- 根拠なしに本番環境が安全だと宣言する
- リスクを指摘せずに既存の連携を壊す
- 高リスク領域における脅威モデリングの代わりにする(人間にエスカレーションする)
- UI監査/プロトタイプのクローズアウトで
references/ui-guidelines-review.mdを省略しながら、UI全体を確認したと主張する
コメント
Markdown 対応