# Coding Guidelines

> チーム開発向けの汎用コーディング規約・設計/実装/テストレビュー観点を即時提示する。 設計前のプランニングと、実装/テスト後のゲートチェックで起動し、重要度（★3〜0）付きのチェックリストと指摘を返す。

- Skill: `yurake/coding-guidelines` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add yurake/coding-guidelines`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yurake/coding-guidelines/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yurake (https://skillmd.com/u/yurake)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yurake/coding-guidelines

---


# Coding Guidelines Skill

チーム開発の設計・実装・テストで使うチェックリストを提示する。静的型付けOOP前提だが言語汎用。星は優先度: ★3=必ず守る、★2=強く推奨、★1=推奨、★0=参考。

## 使い方
- `mode`: `plan`（デフォルト）| `gate` を指定。
  - plan: 実装前の設計・方針確認用チェックリストを出す。
  - gate: 実装/テスト後のゲート判定。重大度高→低で指摘を返す。
- 入力ヒント
  - plan: 目的、非機能要件、対象言語/フレームワーク、リスク/制約。
  - gate: 変更ファイル/主要差分、既知の制約、テスト実行結果。
- 出力フォーマット
  - plan: ★3→★2→★1→★0 の順で1行1項目の短いリスト。
  - gate: 「章 / 状態(OK|Warn|Fail) / 短評 / 推奨修正」。★3違反はFail、★2はWarn目安。
- 章構成と詳細は references を参照する（必要なものだけ読む）。

## 章リンク
- 可用性: [references/availability.md](references/availability.md)
- 例外・エラー: [references/exceptions.md](references/exceptions.md)
- 共通化・構造: [references/commonality.md](references/commonality.md)
- 設計スケッチ: [references/design-sketch.md](references/design-sketch.md)
- コメント: [references/comments.md](references/comments.md)
- テスト: [references/testing.md](references/testing.md)
- 数値計算: [references/math.md](references/math.md)

## 参考メモ
- 言語固有の補足（Javaのチェック例外、Swiftプロトコル→クロージャ置換など）は各章の末尾に置いている。必要なときだけ参照。