shellcheck-configuration について
シェルスクリプトを保守する開発者向けの ShellCheck 設定・静的解析スキルです。リンティングの設定、警告の解釈、ルール調整、開発ワークフローへの組み込みを扱います。
主な機能
- 01対象シェルに合わせた ShellCheck 設定
- 02スクリプトの一般的な問題の解析
- 03警告とエラーコードの理解
- 04根拠を記録した誤検知の抑制
- 05CI/CD とエディターへの組み込み
活用シーン
- 01CI/CD パイプラインにシェルリンターを追加
- 02既存スクリプトの問題を確認
- 03プロジェクト要件に合わせてルールを設定
- 04マージ前にスクリプト品質を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wshobson/ agents --skill shellcheck-configurationインストール後、Claude Code で/shellcheck-configurationを入力して読み込まれたか確認します。
同梱ファイルreferences/details.md
詳細
ShellCheck の設定と静的解析
ShellCheck を設定・使用してシェルスクリプトの品質を向上させ、よくある落とし穴を検出し、静的コード解析を通じてベストプラクティスを徹底するための包括的なガイダンスです。
このスキルを使用する場面
- CI/CD パイプラインでシェルスクリプトのリンティングをセットアップする場合
- 既存のシェルスクリプトの問題を解析する場合
- ShellCheck のエラーコードと警告を理解する場合
- 特定のプロジェクト要件に合わせて ShellCheck を設定する場合
- ShellCheck を開発ワークフローに統合する場合
- 誤検出を抑制し、ルールセットを設定する場合
- 一貫したコード品質基準を徹底する場合
- スクリプトを品質ゲートに適合するよう移行する場合
詳細なパターンと実例
詳細なパターンのドキュメントは references/details.md にあります。上記のナビゲーション層では不十分な場合に、そのファイルをお読みください。
ベストプラクティス
- CI/CD で ShellCheck を実行する - マージする前に問題を検出します
- 対象シェルに合わせて設定する - bash を sh として解析しないでください
- 除外を文書化する - 違反が抑制されている理由を説明します
- 違反に対処する - 警告を無効にするだけにしないでください
- strict モードを有効にする - 慎重な除外とともに
--enable=allを使用します - 定期的に更新する - 新しいチェックのために ShellCheck を最新の状態に保ちます
- pre-commit フックを使用する - プッシュする前にローカルで問題を検出します
- エディターと統合する - 開発中にリアルタイムのフィードバックを得られます
コメント
Markdown 対応