skill-name について
この項目は、セキュリティ運用向けのワークフロー、スクリプト、参照資料、アセットの構成を示す汎用スキルテンプレートです。具体的な実装プロジェクトではなく、プレースホルダー形式の指針を含みます。
主な機能
- 01逐次ワークフローの概要
- 02複雑な作業向けチェックリスト
- 03検証フィードバックループの型
- 04スクリプトと参照資料の整理
活用シーン
- 01セキュリティスキルの構成案を作る
- 02反復可能なスキャンと修正手順をまとめる
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ agentsecops/ secopsagentkit --skill skill-nameインストール後、Claude Code で/skill-nameを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/.gitkeepci-config-template.ymlrule-template.yamlreferences/EXAMPLE.mdWORKFLOW_CHECKLIST.md詳細
スキル名
概要
このスキルでできることと、セキュリティ運用における位置づけの概要です。
クイックスタート
すぐに始めるための最小限の例を示します。
# Example command or workflow
tool-name --option value
コアワークフロー
順次ワークフロー
シンプルなステップごとの操作の場合:
- 具体的なコマンドまたは操作を使った最初のアクション
- 期待される出力または検証を伴う2番目のアクション
- 必要に応じた判断ポイントを含む3番目のアクション
ワークフローチェックリスト(複雑な操作向け)
複雑な複数ステップの操作には、チェック可能なワークフローを使用します。
進捗: [ ] 1. 初期セットアップと設定 [ ] 2. 主要なセキュリティスキャンまたは分析を実行 [ ] 3. 検出結果を確認し、重大度で分類 [ ] 4. 修正パターンを適用 [ ] 5. 再スキャンで修正を検証 [ ] 6. 検出結果を文書化し、レポートを生成
各ステップを体系的に進め、完了した項目にチェックを付けてください。
ワークフローパターンの詳細については、references/WORKFLOW_CHECKLIST.mdを参照してください。
フィードバックループパターン(検証向け)
検証と反復が必要な場合:
- 初期出力(設定、コードなど)を生成します
- 検証を実行します:
./scripts/validator_example.py output.yaml - 検証エラーと警告を確認します
- 特定された問題を修正します
- 検証に合格するまで、手順2~4を繰り返します
- 検証済みの出力を適用します
注:検証基準が複雑な場合は、詳細をreferences/に移してください。
セキュリティに関する考慮事項
- 機密データの取り扱い:シークレット、認証情報、PIIの取り扱いに関するガイダンス
- アクセス制御:必要な権限と認可のコンテキスト
- 監査ログ:セキュリティ監査のために記録すべき内容
- コンプライアンス:関連するコンプライアンス要件(SOC2、GDPRなど)
同梱リソース
スクリプト(scripts/)
決定論的な操作を実行するスクリプトです。一貫性が求められる、自由度の低い操作にはスクリプトを使用します。
example_script.py- argparse、エラー処理、JSON出力を備えたPythonスクリプトのテンプレートexample_script.sh- 引数の解析と色付き出力を備えたBashスクリプトのテンプレートvalidator_example.py- フィードバックループパターンを示す検証スクリプト
スクリプトを使用する場面:
- 一貫性が必須の決定論的な操作
- 複雑な解析やデータ変換
- 検証と品質チェック
リファレンス(references/)
必要なときに読み込むオンデマンドのドキュメントです。詳細な内容をここに移して、SKILL.mdを簡潔に保ちます。
EXAMPLE.md- セキュリティ標準のセクションを含むリファレンスドキュメントのテンプレートWORKFLOW_CHECKLIST.md- 複数のワークフローパターンの例(順次、条件分岐、反復、フィードバックループ)
リファレンスを使用する場面:
- 詳細なフレームワークのマッピング(OWASP、CWE、MITRE ATT&CK)
- 高度な設定オプション
- 言語固有のパターン
- 100行を超えるコンテンツ
アセット(assets/)
出力に使用するテンプレートや設定ファイルです(コンテキストには読み込まれません)。これらは参照されますが、必要になるまで読み込まれません。
ci-config-template.yml- SAST、依存関係スキャン、シークレット検出を備えたセキュリティ強化済みCI/CDパイプラインrule-template.yaml- OWASP/CWEのマッピングと修正ガイダンスを含むセキュリティルールのテンプレート
アセットを使用する場面:
- 設定テンプレート
- ポリシーテンプレート
- 定型的なセキュアコード
- CI/CDパイプラインの例
よくあるパターン
パターン1:[パターン名]
一般的な使用パターンの説明と例です。
パターン2:[パターン名]
必要に応じて、追加のパターンを記載します。
統合ポイント
- CI/CD:ビルドパイプラインとの統合方法
- セキュリティツール:互換性のあるセキュリティスキャン/監視ツール
- SDLC:セキュアな開発ライフサイクルにおける位置づけ
トラブルシューティング
問題:[よくある問題]
解決策:解決するための手順です。