Agent skill

coding-guidelines

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

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/yurake/skills/tree/main/dev/coding-guidelines

SKILL.md

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/exceptions.md
  • 共通化・構造: references/commonality.md
  • 設計スケッチ: references/design-sketch.md
  • コメント: references/comments.md
  • テスト: references/testing.md
  • 数値計算: references/math.md

参考メモ

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

yurake/skills

issue-create

GitHub Issue を作成する手順。依頼を受けたとき、.github/ISSUE_TEMPLATE の内容に応じてテンプレを選び、必須項目を埋めて GitHub MCP（issue_write/create）で Issue を作成する。

0 0
Explore
yurake/skills

ci-fail-followup

PR 作成後に .github/workflows/ci.yml が失敗したときの対応手順。ローカルで pytest 全ケースを実行し、エラー有無で分岐。エラーがあれば修正して commit-push スキルでコミット・プッシュ、無ければ GitHub Actions のログを確認して原因を特定する。

0 0
Explore
yurake/skills

review-rules

セッションの会話から恒久的な振る舞いルールを抽出し、AGENTS.md と突き合わせて追加すべきものを提示する。出力は rules と agents_md_patch の二部構成。

0 0
Explore
yurake/skills

pr-create

PR 作成手順を自動化するためのガイド。依頼を受けたとき、または 参照しているTODOファイル の「PR 作成」以外が完了したタイミングでタイトル・本文整形、テンプレ適用、MCP での PR 作成を行う。

0 0
Explore
yurake/skills

architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.

0 0
Explore
yurake/skills

test-risk-analyzer

あらゆる言語/スタックで潜在バグリスクを洗い出し、追加すべきテストケースを提案する。未テストのエッジケース探索や安全性確認、カバレッジ強化のテスト案提示を求められたときに使用する。

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results