Communitygithub.com

Go本番運用プレイブック

Goコードを作成・レビューする際に使用する本番運用向けプレイブック。エラー処理、ゴルーチン、バイトペイロード、パーサー、外部入力のスイッチなどに焦点を当てます。

Go本番運用プレイブック とは?

このスキルは、Go言語における本番環境で頻発する障害パターンを予防・対処するためのルールセットです。特に、エラーの適切なラッピングと破棄の防止、ゴルーチン間での値の競合回避、外部からの信頼できない入力に対する再帰処理の制限に重点を置いています。`references/bad-vs-good.md` を参照することで、具体的な良し悪しの事例を学習できます。対応プラットフォームとしては、Claude CodeやCursorなどのAIコードエージェントを想定しており、`gofmt`によるフォーマット自動化も推奨しています。このスキルは、Go特有の落とし穴を本番運用前に検出し、コード品質を向上させるために設計されています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sshdkeyu/skill-prod-cursor/tree/HEAD/skills/go

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Go

ルール 01 とルール 03 は基本とします。このスキルは、それらのルールが本番環境でどのように失敗するかをGoの視点で示したものです。

変更がエラー、ゴルーチン、[]byte と string の比較、再帰、または自分で作成していないデータに対する switch に関わる場合は、references/bad-vs-good.md を参照してください。結果に対して gofmt を実行してください。このスキルを満たすためにロギングライブラリを追加しないでください。

完了条件

  • 呼び出したすべての関数から返されたエラーは、コンテキスト付きでラップされるか、適切に処理されること。エラーが破棄されてはならない。
  • ゴルーチンは、他のゴルーチンが変更する値を変更しないこと。ゴルーチンの数は上限があること。
  • 信頼できない入力や大きな入力に対して、無制限の再帰が行われないこと。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル