スキル kaizen
📦

kaizen

安全

コード品質向上のためのカイゼン手法の適用

ソフトウェアチームは、一貫性のないコード品質と事後的なエラー処理に苦労しています。このスキルは、継続的改善、エラー防止設計、標準化されたパターンの追従のための構造化されたカイゼン手法を提供します。

対応: Claude Codex Code(CC)
🥉 74 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「kaizen」を使用しています。 注文合計を計算するこの関数を改善するためにカイゼンを適用する

期待される結果:

  • イテレーション 1 - 入力検証の追加:計算前に null/空のアイテム配列と負の価格をチェックします。これにより実行時エラーを防止します。
  • イテレーション 2 - 可読性の向上:より明確な意図のために for ループを reduce() に置き換えます。型シグネチャは number を返すことを明示します。
  • イテレーション 3 - エラーメッセージの追加:サイレントフェイルではなく、無効な入力に対して説明的なエラーをスローします。各イテレーションはテスト済みで動作します。

「kaizen」を使用しています。 ポカヨケを使用してエラー防止 Order 型を設計する

期待される結果:

  • シンプルな文字列ステータスを持つオブジェクトの代わりに、各注文状態に必要なデータを持つ直和型を使用します。
  • 保留中の注文には createdAt タイムスタンプが必要です。発送済みの注文には追跡番号が必要です。配達済みの注文には署名が必要です。
  • 型システムにより、追跡情報なしに発送済み注文を持つことは不可能になります。コンパイルエラーにより、バグのクラス全体を防止できます。

セキュリティ監査

安全
v1 • 2/25/2026

This skill is a documentation-only guide for Kaizen software development methodology. Static analysis flagged 73 patterns in code examples within markdown documentation, but all findings are false positives. The backtick operators are TypeScript template literals (not shell commands), fetch calls are educational examples (not actual network requests), and environment variable references teach secure validation practices. No executable code exists in this skill.

1
スキャンされたファイル
733
解析された行数
3
検出結果
1
総監査数
低リスクの問題 (3)
External Command Pattern (False Positive)
Static analyzer detected 44 instances of backtick operators. These are TypeScript template literals used for string interpolation in code examples (e.g., `/users/${id}`), not Ruby/shell command execution. The skill contains documentation only with no executable code.
Network Pattern (False Positive)
Static analyzer detected fetch API calls and hardcoded URLs. These are educational code examples demonstrating proper API client patterns. The URLs are example placeholders (api.example.com), not actual external endpoints.
Environment Access Pattern (False Positive)
Static analyzer detected environment variable access and potential secret exposure. Line 304-306 shows educational content teaching secure config validation - specifically demonstrating how to throw errors when API_KEY is missing.
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
99
セキュリティ
91
仕様準拠

作れるもの

コードレビューの改善

コードレビュー中にカイゼン原則を適用し、完全な書き直しを要求するのではなく、小さな段階的な改善を提案します。各提案は、次に進む前に検証およびテストされます。

エラー耐性 API 設計

ポカヨケ手法を使用して、TypeScript API を設計し、無効な状態をコンパイル時に表現できないようにします。型システムが実行前にエラーを検出します。

レガシーコードのリファクタリング

反復的洗練アプローチを適用します:動作するようにする、明確にする、効率的にする。各イテレーションは、次に進む前に完了しテストされます。

これらのプロンプトを試す

基本的なコード改善
この関数をレビューし、カイゼン原則に従って小さな改善を 1 つ提案してください。この変更がなぜ品質を向上させるのかを説明し、他の提案をする前に動作することを確認してください。
エラー防止設計
ポカヨケ原則を使用してこの API インターフェースを分析してください。TypeScript 型を使用して無効な状態を表現できないようにする方法を示してください。型定義を含む前後の例を提供してください。
パターンの標準化
このコードベースに新機能を追加しています。[機能タイプ] の既存のコードパターンを分析し、同じ標準化されたアプローチに従って新機能を実装する方法を示してください。コードベース内の具体的な例を指摘してください。
YAGNI リファクタリング
このコードを YAGNI 違反についてレビューしてください。「念のため」の機能、時期尚早の抽象化、未使用の複雑さを特定してください。各問題について、現在の要件を満たす最もシンプルなバージョンを示し、何を削除すべきかを説明してください。

ベストプラクティス

  • 品質を向上させる最小限の実行可能な変更を行い、動作することを確認してから、次の改善に進む
  • システム境界で入力と設定を検証し、明確なエラーメッセージで早期に失敗する
  • 一貫性のために既存のコードベースパターンに従う。チームによって合意され、著しく優れている場合にのみ新しいパターンを導入する

回避

  • 段階的な改善ではなく、大規模なリファクタリングプロジェクトを試みること
  • 複数の実証された使用例を持つ前に、汎用的なフレームワークや抽象化を構築すること
  • 実際のパフォーマンス問題を測定せずに「念のため」の機能を追加したり最適化したりすること

よくある質問

カイゼンを使用すべきか、完全な書き直しを行うべきかはいつ判断すればよいですか?
カイゼンはほとんどの改善に機能します。書き直しはほとんど答えではありません。大きな問題を小さなテスト可能な改善に分割します。各イテレーションは、コードを以前より動作する状態でより良くする必要があります。
動的型付け言語でポカヨケを適用するにはどうすればよいですか?
境界でランタイム検証、アサーション関数、ブランド型を使用してください。コンパイル時チェックほど強力ではありませんが、明確なエラーによる早期検証でも、本番環境の多くの問題を防止できます。
チームに確立されたパターンがない場合はどうすればよいですか?
まず、機能しているコードで観察されるパターンを文書化することから始めます。既存の成功したパターンに基づいて標準を提案します。合意Once、リンターと型チェックを使用して自動化された強制を実施します。
抽象化が時期尚早かどうかをどのように判断しますか?
3 のルールを待ちます:同じパターンを 3 か所の異なる場所で実装してから抽象化します。重複は間違った抽象化より安価です。抽象化は実証されたパターンから現れるべきです。
カイゼンは厳しい締め切りでも機能しますか?
はい。小さな改善は大規模な書き直しより高速です。最も影響の大きい変更から最初に焦点を当てます。反復的アプローチは、締切の圧力下での壊れたコードのリスクを減らします。
カイゼン手法をサポートするツールは何ですか?
コンパイル時のエラー防止のための TypeScript、標準化されたフォーマットのための ESLint/Prettier、各イテレーションでの検証のためのテストフレームワーク、自動化された品質ゲートのための CI/CD。

開発者の詳細

作成者

sickn33

ライセンス

MIT

参照

main

ファイル構成

📄 SKILL.md