mcpField
S
site-reliability-engineer

site-reliability-engineer

github.com/curiositechテスト・品質257185 回インストール2 日前に更新
リポジトリ

site-reliability-engineer について

Claude Skillsのショーケースサイトで、ビルドの健全性とデプロイの安全性を保つサイト信頼性スキルです。MarkdownやMDXの問題、必須ファイルやコンポーネントのプロパティを確認し、Docusaurusのビルド失敗を診断します。

主な機能

  1. 01コミット前のMarkdownとMDX検証
  2. 02Liquid構文と山括弧のチェック
  3. 03SkillHeaderプロパティの検証
  4. 04必須画像とZIPファイルの確認
  5. 05ビルドとキャッシュのトラブルシューティング

活用シーン

  1. 01コミット前の文書チェック
  2. 02Docusaurusビルド前のMDX問題検出
  3. 03ファイル不足やコンポーネントプロパティエラーの診断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/curiositech/some_claude_skills --skill site-reliability-engineer

インストール後、Claude Code で/site-reliability-engineerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
.claude-plugin/
plugin.json
references/
ci-cd-integration.md
validation-logic.md
scripts/
validate-brackets.js
validate-liquid.js
validate-skill-props.js

詳細

サイト信頼性エンジニア

Claude Skills ショーケース Web サイトの Docusaurus ビルドの健全性、MDX の検証、デプロイの安全性を専門とします。コミット前の検証と自動ヘルスチェックにより、よくあるビルド失敗を防ぎます。

使用するタイミング

次の場合に使用します：

  • Markdown／MDX ファイルのコミット前検証
  • Liquid テンプレートの構文エラーの検出
  • SkillHeader コンポーネントの props の検証
  • ヒーロー画像／ZIP ファイルの不足の確認
  • ビルド前のリンク検証
  • ビルド後のヘルスレポート
  • Docusaurus のビルド失敗の診断

次の用途には使用しないでください：

  • 一般的な DevOps（deployment-engineer を使用）
  • Kubernetes／クラウドインフラストラクチャ（kubernetes-architect を使用）
  • ランタイムの監視／アラート（observability-engineer を使用）
  • データベースのマイグレーション（database-migrations agents を使用）
  • セキュリティスキャン（security-auditor を使用）

主な問題領域

繰り返し発生する 5 つのアンチパターン
#問題症状修正方法
1例に Liquid 構文を使用Liquid テンプレートによって MDX が壊れるバッククォート式で囲む
2山括弧のエスケープ漏れ<70 が HTML として解析される<70 を使用する
3SkillHeader の props が誤っているSSG ビルドが失敗するskillId ではなく fileName を使用する
4重要なファイルの不足サイトに Skill が表示されないskills.ts に追加する
5キャッシュの破損存在しないエラーが発生する.docusaurus と build をクリアする

クイックスタート

フックのインストール（一度だけ）
npm run install-hooks
手動検証
npm run validate:liquid    # Liquid syntax
npm run validate:brackets  # Angle brackets
npm run validate:props     # SkillHeader props
npm run validate:all       # All checks
キャッシュのクリア（行き詰まったとき）
rm -rf .docusaurus build node_modules/.cache
npm run build

コミット前の検証

コミット前フックでは、次の項目が自動的に検証されます：

  1. Liquid 構文 - コードブロック外にある二重波括弧のテンプレートをスキャンします
  2. 山括弧 - <digit パターンを検出します
  3. SkillHeader の props - コンポーネントの使い方を検証します
  4. 必須ファイル - ヒーロー画像と ZIP が存在するか確認します

速度：一般的なコミットで 5 秒未満

エキスパートと初心者のアプローチ

初心者エキスパート
確認のために完全なビルドを実行するコミット前の検証で 5 秒以内に 90% を検出する
キャッシュを手動でクリアするキャッシュの問題を自動検出する
警告を無視するリンク切れを一切許容しない
単純な正規表現による検証コンテキストを考慮する（コードブロックをスキップ）

アンチパターン

アンチパターン：検証に完全なビルドを実行する

例：エラーの確認に npm run build を実行する 問題点：数秒ではなく数分かかり、フィードバックが遅くなります 代わりに：npm run validate:all を実行する（30 秒未満）

アンチパターン：ビルド警告を無視する

例：「ビルド成功。これでリリース！」（警告を無視する） 問題点：リンク切れは UX の低下と技術的負債につながります 代わりに：ビルド後の検証で警告がある場合は失敗させます

アンチパターン：単純な正規表現による検証

例：/\{\{.*?\}\}/（コードブロック内でも一致する） 問題点：コード例で誤検出が発生します 代わりに：コードブロックの状態を追跡し、保護された領域をスキップします

スクリプト（scripts/ フォルダー内）

スクリプト目的
validate-liquid.jsエスケープされていない Liquid 構文を検出する
validate-brackets.jsエスケープされていない山括弧を検出する
validate-skill-props.jsSkillHeader コンポーネントを検証する

トラブルシューティングのクイックリファレンス

問題診断修正方法
フックが実行されないls -la .git/hooks/pre-commitchmod +x を実行するか、再インストールする
誤検出パターンがコードブロック内にある``` マーカーを確認する
検証が遅いtime npm run validate:allglob パターンを最適化する

成功指標

フックをインストールした後：

  • ビルド失敗率：15% → 2% 未満
  • エラーの診断時間：10 分 → 1 分未満
  • 検証速度：30 秒未満

参考ファイル

  • references/validation-logic.md - コンテキストを考慮した検出パターン
  • references/ci-cd-integration.md - GitHub Actions、ヘルスレポート
  • scripts/ - 検証スクリプト

防止する問題：Liquid エラー | 山括弧による失敗 | props の不一致 | アセットの不足 | リンク切れ

併用対象：skill-documentarian（同期） | docusaurus-expert（高度な設定）

コメント

Markdown 対応