j5ik2o/okite-ai/error-handling

Claude Code and agent skill by j5ik2o/okite-ai

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

エラーハンドリングのベストプラクティスを適用するスキル。回復可能性を基準にしたエラー設計、 Either/Result型の使用、ドメインエラーとシステムエラーの適切な分類を支援する。コードレビュー、 新規実装、リファクタリング時にエラー処理パターンの改善が必要な場合に使用。対象言語: Go, Rust, Scala, Java, TypeScript, JavaScript, Python。トリガー：「エラー処理を改善して」 「Result型を使いたい」「例外設計をレビューして」「回復可能なエラーの設計」といった エラーハンドリング関連リクエストで起動。

Install

npx vskill@latest install j5ik2o/okite-ai/error-handling

SKILL.md

エラーハンドリング

回復可能性を基準にしたエラーハンドリング設計を支援する。

基本方針

ドメインロジック（ビジネスルール）では Either/Result 型を採用する。

  • ドメイン層のエラーは呼び出し元が判断すべき → 型で明示
  • 例外は制御フローではなく、本当の異常事態に限定
  • 戻り値の型を見るだけでエラーの可能性が分かる設計

判断フロー

エラー発生
    ↓
回復可能か？
    ├─ YES → Either/Result型で表現
    └─ NO → 例外/panicで即座に停止
回復可能回復不能
ビジネスルール違反引数の不正 (IllegalArgumentException)
外部システムエラー状態の矛盾 (IllegalStateException)
権限不足・リソース競合到達不可コード (unreachable)

回復可能なエラー

Either/Result型で表現し、呼び出し元に判断を委ねる。

typescript
// TypeScript - neverthrow
function findUser(id: string): Result<User, UserError> {
  if (!isValidId(id)) return err({ type: 'VALIDATION_FAILED', field: 'id' });
  return repository.find(id)
    ? ok(user)
    : err({ type: 'NOT_FOUND', userId: id });
}

回復不能なエラー

プログラムの前提条件違反は即座に停止。

typescript
// 引数の不正 → IllegalArgumentException 相当
if (order === null) throw new Error('order must not be null');
// 状態の矛盾 → IllegalStateException 相当
if (order.status === 'COMPLETED' && order.items.isEmpty())
  throw new Error('completed order must have items');
// 到達不可コード → unreachable
default: throw new Error(`unreachable: ${status}`);

推奨ライブラリ

言語ライブラリ選択基準
TypeScriptneverthrowResult のみで十分な場合（軽量・シンプル）
TypeScriptfp-ts関数型全般を使う場合（Option, Task, IO, Reader 等）
JavaScriptneverthrowTypeScript と同様
Rust標準 Result<T, E>常にこれを使用。エラー定義には thiserror
Go標準 (T, error)Go らしいシンプルなコードを書く場合
Gosamber/moResult/Either でチェーン処理したい場合
Scala標準 Either[L, R]標準で十分。cats は大規模 FP 向け
Javavavr.io Either関数型コレクションも使うなら vavr 一択
Pythonreturns (dry-python)本番環境向け。型アノテーション充実
Pythonresult軽量。Rust ライクなシンプルな API

詳細ガイドライン

全言語の実装パターン、エラー型設計の詳細は references/guidelines.md を参照。

関連スキル（併読推奨）

このスキルを使用する際は、以下のスキルも併せて参照すること：

  • error-classification: エラーの分類（Error, Defect, Fault, Failure）に基づく処理方式の選択
  • domain-building-blocks: ドメイン操作におけるResult/Eitherの適用
  • repository-design: リポジトリのエラー処理パターン（同期・非同期）

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
74
Repository forks
2
7-day trend score
22

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 31 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/j5ik2o/okite-ai/error-handling/badge)](https://verified-skill.com/skills/j5ik2o/okite-ai/error-handling)

Something wrong with this skill or its page? Tell us.