codeguard について
CodeGuard Skillは、コードの生成、レビュー、変更を行うAIコーディングエージェント向けのセキュリティ指針です。常時適用する規則に加え、セキュリティ状況と言語に応じたProject CodeGuardのルールを扱います。
主な機能
- 01認証情報と暗号の必須ルール
- 02状況に応じたルール選択
- 03言語別ガイダンスの適用
- 04チェックリストに沿った実装レビュー
活用シーン
- 01認証やデータ処理の実装
- 02ユーザー入力を扱うコードのレビュー
- 03インフラやCI/CDの設定
- 04生成コードのセキュリティ確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cosai-oasis/ project-codeguard --skill codeguardインストール後、Claude Code で/codeguardを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/codeguard-0-additional-cryptography.mdcodeguard-0-api-web-services.mdcodeguard-0-authentication-mfa.mdcodeguard-0-authorization-access-control.mdcodeguard-0-client-side-web-security.mdcodeguard-0-cloud-orchestration-kubernetes.mdcodeguard-0-data-storage.mdcodeguard-0-devops-ci-cd-containers.mdcodeguard-0-file-handling-and-uploads.mdcodeguard-0-framework-and-languages.mdcodeguard-0-iac-security.mdcodeguard-0-input-validation-injection.mdcodeguard-0-logging.mdcodeguard-0-mcp-security.mdcodeguard-0-mobile-apps.mdcodeguard-0-privacy-data-protection.mdcodeguard-0-safe-c-functions.mdcodeguard-0-session-management-and-cookies.mdcodeguard-0-supply-chain-security.mdcodeguard-0-xml-and-serialization.mdcodeguard-1-crypto-algorithms.mdcodeguard-1-digital-certificates.mdcodeguard-1-hardcoded-credentials.md詳細
CodeGuard スキル
このスキルは、AI コーディングエージェントが安全なコードを生成し、一般的な脆弱性を防ぐための包括的なセキュリティガイダンスを提供します。これは、セキュアなデフォルトのプラクティスを AI コーディングワークフローに組み込む、オープンソースでモデルに依存しないセキュリティフレームワーク、Project CodeGuard に基づいています。
このスキルを使用するタイミング
以下の場合に、このスキルを有効にしてください:
- 任意の言語で新しいコードを書く場合
- 既存のコードをレビューまたは変更する場合
- セキュリティ上重要な機能(認証、暗号化、データ処理など)を実装する場合
- ユーザー入力、データベース、API、または外部サービスを扱う場合
- クラウドインフラストラクチャ、CI/CD パイプライン、またはコンテナーを設定する場合
- 機密データ、認証情報、または暗号処理を扱う場合
このスキルの使用方法
コードを書く、またはレビューする際:
- 常に適用するルール:すべてのコード操作で必ず確認するルールがあります:
codeguard-1-hardcoded-credentials.md- シークレット、パスワード、API キー、またはトークンをハードコードしないでくださいcodeguard-1-crypto-algorithms.md- 最新の安全な暗号アルゴリズムのみを使用してくださいcodeguard-1-digital-certificates.md- デジタル証明書を安全に検証および管理してください
- タグベースのルール:コード内で以下のセキュリティコンテキストを特定したら、対応するタグのルールをすべて適用してください:
| セキュリティコンテキスト(タグ) | 適用するルールファイル |
|---|---|
| authentication | codeguard-0-authentication-mfa.md, codeguard-0-session-management-and-cookies.md |
| data-security | codeguard-0-additional-cryptography.md, codeguard-0-data-storage.md |
| infrastructure | codeguard-0-cloud-orchestration-kubernetes.md, codeguard-0-data-storage.md, codeguard-0-devops-ci-cd-containers.md, codeguard-0-iac-security.md |
| privacy | codeguard-0-logging.md, codeguard-0-privacy-data-protection.md |
| secrets | codeguard-0-additional-cryptography.md, codeguard-1-digital-certificates.md, codeguard-1-hardcoded-credentials.md |
| web | codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-client-side-web-security.md, codeguard-0-input-validation-injection.md, codeguard-0-session-management-and-cookies.md |
- 言語固有のルール:以下の表に基づき、実装する機能のプログラミング言語に応じて /rules ディレクトリ内のルールを適用してください: | 言語 | 適用するルールファイル | |----------|---------------------| | apex | codeguard-0-input-validation-injection.md | | c | codeguard-0-additional-cryptography.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-data-storage.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-input-validation-injection.md, codeguard-0-logging.md, codeguard-0-safe-c-functions.md, codeguard-0-xml-and-serialization.md | | cpp | codeguard-0-safe-c-functions.md | | docker | codeguard-0-devops-ci-cd-containers.md, codeguard-0-supply-chain-security.md | | go | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-input-validation-injection.md, codeguard-0-mcp-security.md, codeguard-0-session-management-and-cookies.md, codeguard-0-xml-and-serialization.md | | hcl | codeguard-0-iac-security.md | | html | codeguard-0-client-side-web-security.md, codeguard-0-input-validation-injection.md | | java | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-mcp-security.md, codeguard-0-mobile-apps.md, codeguard-0-session-management-and-cookies.md, codeguard-0-xml-and-serialization.md | | javascript | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-client-side-web-security.md, codeguard-0-data-storage.md, codeguard-0-devops-ci-cd-containers.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-logging.md, codeguard-0-mcp-security.md, codeguard-0-mobile-apps.md, codeguard-0-privacy-data-protection.md, codeguard-0-session-management-and-cookies.md, codeguard-0-supply-chain-security.md | | kotlin | codeguard-0-additional-cryptography.md, codeguard-0-authentication-mfa.md, codeguard-0-framework-and-languages.md, codeguard-0-mobile-apps.md | | php | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-client-side-web-security.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-session-management-and-cookies.md, codeguard-0-xml-and-serialization.md | | powershell | codeguard-0-devops-ci-cd-containers.md, codeguard-0-iac-security.md, codeguard-0-input-validation-injection.md | | python | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-mcp-security.md, codeguard-0-session-management-and-cookies.md, codeguard-0-xml-and-serialization.md | | ruby | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-session-management-and-cookies.md, codeguard-0-xml-and-serialization.md | | rust | codeguard-0-mcp-security.md | | shell | codeguard-0-devops-ci-cd-containers.md, codeguard-0-iac-security.md, codeguard-0-input-validation-injection.md | | sql | codeguard-0-data-storage.md, codeguard-0-input-validation-injection.md | | swift | codeguard-0-additional-cryptography.md, codeguard-0-authentication-mfa.md, codeguard-0-mobile-apps.md | | typescript | codeguard-0-additional-cryptography.md, codeguard-0-api-web-services.md, codeguard-0-authentication-mfa.md, codeguard-0-authorization-access-control.md, codeguard-0-client-side-web-security.md, codeguard-0-file-handling-and-uploads.md, codeguard-0-framework-and-languages.md, codeguard-0-input-validation-injection.md, codeguard-0-mcp-security.md, codeguard-0-session-management-and-cookies.md | | xml | codeguard-0-api-web-services.md, codeguard-0-mobile-apps.md, codeguard-0-xml-and-serialization.md | | yaml | codeguard-0-authorization-access-control.md, codeguard-0-cloud-orchestration-kubernetes.md, codeguard-0-data-storage.md, codeguard-0-devops-ci-cd-containers.md, codeguard-0-iac-security.md, codeguard-0-supply-chain-security.md |
- プロアクティブなセキュリティ:脆弱性を回避するだけでなく、安全なパターンを積極的に実装します。
- データベースへのアクセスには、パラメーター化クエリを使用します
- すべてのユーザー入力を検証し、サニタイズします
- 最小権限の原則を適用します
- 最新の暗号化アルゴリズムとライブラリを使用します
- 多層防御戦略を実装します
CodeGuard のセキュリティルール
セキュリティルールは rules/ ディレクトリにあります。
使用ワークフロー
コードの生成またはレビュー時には、次のワークフローに従います。
1. 初期セキュリティチェック
コードを書く前に:
- 確認:認証情報を扱いますか? → codeguard-1-hardcoded-credentials を適用します
- 確認:該当するセキュリティタグは何ですか? → 一致するタグ(例:「authentication」、「web」、「secrets」)が付いたすべてのルールを読み込みます
- 確認:使用する言語は何ですか? → 適用可能な言語固有のルールを特定します
2. コード生成
コードを書いている間:
- 関連する Project CodeGuard ルールにある、安全をデフォルトとするパターンを適用します
- 選択理由を説明する、セキュリティ関連のコメントを追加します
3. セキュリティレビュー
コードを書いた後:
- 各ルールの実装チェックリストに照らしてレビューします
- ハードコードされた認証情報やシークレットがないことを確認します
- 該当するすべてのルールに従っていることを検証します
- 適用したセキュリティルールを説明します
- 実装したセキュリティ機能を強調します
コメント
Markdown 対応