coding-guidelines

yurake's avatarfrom yurake

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

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 1, 2026
[Code Review]

When & Why to Use This Skill

This Claude skill streamlines team development by providing comprehensive coding guidelines and review perspectives across the design, implementation, and testing phases. It helps maintain high code quality through prioritized checklists and automated gate checks, ensuring adherence to architectural standards and non-functional requirements like availability, error handling, and structural integrity.

Use Cases

  • Pre-implementation Planning: Use the 'plan' mode to generate a checklist of design considerations, non-functional requirements, and potential risks before starting a new feature to ensure architectural alignment.
  • Automated Code Review Gate: Use the 'gate' mode to evaluate code changes and test results against established guidelines, identifying critical failures (★3) and recommended improvements during the pull request process.
  • Standardizing Team Practices: Establish a unified set of coding standards across a multi-developer project, covering common areas like exception handling, testing strategies, and structural patterns to reduce technical debt.
namecoding-guidelines
description>

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 を参照する（必要なものだけ読む）。

章リンク

参考メモ

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