Community研究&データ分析github.com

Jamie-BitFlight/kaizen-improvement

トランスクリプト分析から得られた知見を、実践可能な改善項目へと変換します。フックの生成、エージェントプロンプトの改良、スキルパッチ、CLAUDE.mdの更新、スクリプト自動化のためのテンプレートを提供します。

kaizen-improvement とは?

Kaizen Improvement スキルは、`.planning/kaizen/` ディレクトリに蓄積された解析結果(主に transcript-analysis スキルによって生成)を基に、AIエージェント(Claude Code 等)の動作を具体的に改善するためのアーティファクトを生成します。このスキルの主な目的は、反復的な作業や非効率なパターンを特定し、それらを自動化または是正するための仕組みを提供することです。具体的には、ツールの誤用を防ぐPreToolUseフック、エージェントのシステムプロンプトの修正指示、スキルへの知識追加パッチ、プロジェクト全体の行動規範を定義するCLAUDE.mdの更新案、そして手作業のワークフローを代替するスクリプト/スキルの提案を、それぞれ専門のサブエージェントに委任するための指示セットとして生成します。出力はデフォルトではドラフトモードでマークダウンファイルとして保存され、`--install` フラグを使用するとフック設定のみが直接適用されます。このスキルは、自律的な改善ループ(ARL)の一部として、エージェントが自身のパフォーマンスを継続的に学習し向上させるための基盤を提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/agentskill-kaizen/skills/kaizen-improvement

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Kaizen Improvement

.planning/kaizen/ 内の分析結果を、実践可能な改善項目(フック、エージェントパッチ、スキル改良、CLAUDE.md更新、自動化スクリプト)に変換します。

前提条件: .planning/kaizen/ に分析結果が存在すること(transcript-analysis スキルによって生成)。

改善の種類

以下の各カテゴリには、委任用のテンプレートがあります。

  1. フック生成 — PreToolUse(拒否/リダイレクト)、SubagentStart(コンテキスト注入)、Stop(品質ゲート)
  2. エージェントプロンプト改良 — @subagent-refactorer によるエージェントシステムプロンプトへの精密な修正
  3. スキルパッチ — /plugin-creator:skill-creator によるスキルへの知識追加
  4. CLAUDE.md更新 — プロジェクト全体の行動ルール
  5. スクリプト自動化 — 繰り返し行われる手動ワークフローのスクリプトまたはスキルへの置き換え

詳細なテンプレートと例については、Improvement Templates を参照してください。

自律的改善ループ(ARL)ナレッジベース(レイヤー3の実装詳細、前提条件、研究統合)については、ARL Knowledge を参照してください。

ワークフロー

flowchart TD
    Start([分析結果を読む]) --> Parse[頻度と証拠に基づいてアンチパターンを抽出]
    Parse --> Score[頻度 × 影響度でスコアリング]
    Score --> Top[上位の結果を選択]
    Top --> Type{改善の種類は?}
    Type -->|ツールの繰り返し誤用| Hook[フック生成 — 拒否/リダイレクト]
    Type -->|エージェントの動作問題| Agent[エージェントパッチ指示セット生成]
    Type -->|知識不足| Skill[スキルパッチ指示セット生成]
    Type -->|プロジェクト全体の問題| Claude[CLAUDE.md追加案生成]
    Type -->|手動ワークフロー| Script[自動化提案生成]
    Hook --> Output[.planning/kaizen/improvements/ に書き出し]
    Agent --> Output
    Skill --> Output
    Claude --> Output
    Script --> Output
    Output --> Install{--install フラグ?}
    Install -->|はい| Apply[フックを設定に書き込み、パッチを適用]
    Install -->|いいえ| Draft[レビュー用の提案として残す]

フック生成

分析結果を読み → フック設定とオプションのスクリプトを生成します。各アンチパターンタイプに対応するパターン、ガイドライン、例については、Hook Patterns を参照してください。

委任プロトコル

改善項目は、専門エージェントへの指示セットであり、直接編集ではありません。結果重視の委任に従ってください:

  • 問題を証拠(セッションID、ツール呼び出し、頻度)とともに記述する
  • 望ましい結果を述べる
  • 専門エージェントが実装方法を決定できるようにする
  • 委任プロンプトに特定のコード変更を指定しない

出力モード

ドラフトモード(デフォルト)

すべての提案をマークダウンファイルとして .planning/kaizen/improvements/ に書き出します。各ファイルには以下が含まれます:

  • 証拠付きの結果サマリー
  • 提案された改善
  • 適切な専門エージェントへの委任プロンプト
  • 優先度スコア

インストールモード(--install フラグ)

フックのみ — .claude/settings.json または hooks/hooks.json に直接書き込みます。その他の改善タイプは常に委任プロンプトを生成します(直接編集はありません)。

優先度スコアリング

以下の基準で改善項目をランク付けします:

  1. 頻度 × 影響度 — セッション全体での発生回数 × 1回あたりのコスト
  2. 自動化の可能性 — フック > スクリプト > ドキュメント
  3. 影響範囲 — プロジェクト全体 > 単一エージェント > 単一セッション
  4. 実装コスト — フック(数分)< CLAUDE.md(数分)< スキル(数時間)< エージェント(数日)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Jamie-BitFlight/agentskill-kaizen-meta-docs

Agentskill kaizen plugin documentation index. Load when needing to read about cross-platform notes, improvement plans, or DuckDB integration.

Jamie-BitFlight/bash-51-features

Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-52-features

Bash 5.2 release features and improvements with practical examples. Use when working with Bash 5.2 features, variable handling enhancements, readline improvements, or when user asks about Bash 5.2 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-53-features

Bash 5.3 release features and improvements with practical examples. Use when working with Bash 5.3 features, new command substitution, GLOBSORT, loadable builtins, or when user asks about Bash 5.3 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-development

This skill should be used when the user asks to "write a bash script", "create a shell script", "implement bash function", "parse arguments in bash", "handle errors in bash", or mentions bash development, shell scripting, script templates, or modern bash patterns.

Jamie-BitFlight/bash-lint

This skill should be used when the user asks to "lint bash script", "run shellcheck", "format shell script", "use shfmt", "fix shellcheck errors", or mentions shell script linting, formatting, code quality, or pre-commit hooks for bash.

Jamie-BitFlight/bash-logging

This skill should be used when the user asks to "add logging to bash script", "colorize output", "implement log levels", "CI/CD sections", "terminal colors in bash", or mentions logging functions, emoji output, collapsible CI sections, or shlocksmith.

Jamie-BitFlight/bash-portability

This skill should be used when the user asks about "POSIX compatibility", "portable shell scripts", "cross-shell compatibility", "bashisms", "shebang selection", or mentions writing scripts that work on different shells (bash, sh, dash, zsh) or different systems.

Jamie-BitFlight/bash-testing

This skill should be used when the user asks to "test bash script", "write shell tests", "use shunit2", "use shellspec", "create test suite for bash", or mentions unit testing, test frameworks, mocking, or test-driven development for shell scripts.

Jamie-BitFlight/brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.

Jamie-BitFlight/clang-format

Configure clang-format code formatting. Use when: user mentions clang-format or .clang-format, analyzing code style/patterns, creating/modifying formatting config, troubleshooting formatting, brace styles/indentation/spacing/alignment/pointer alignment, or codifying conventions.

Jamie-BitFlight/commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

Jamie-BitFlight/conventional-commits

When writing a git commit message. When task completes and changes need committing. When project uses semantic-release, commitizen, git-cliff. When choosing between feat/fix/chore/docs types. When indicating breaking changes. When generating changelogs from commit history.

Jamie-BitFlight/dasel-reference

Use when querying, modifying, or converting JSON, YAML, TOML, XML, CSV, HCL, or INI with dasel v3. Complete reference for selectors, functions, conditionals, variables, spread operator, type casting, and format-specific patterns.

Jamie-BitFlight/data-exploration

Use when exploring unknown structured data files with dasel v3 — discover schema, list keys, find nested values, sample arrays, identify data types across JSON, YAML, TOML, XML, CSV, HCL, INI formats

Jamie-BitFlight/data-transformation

Use when modifying, converting, or transforming structured data with dasel v3 — in-place mutations, format conversion, batch operations, array manipulation, object construction, and merge patterns across JSON, YAML, TOML, XML, CSV, HCL, INI

Jamie-BitFlight/delegate

Decompose substantive work into phases, dispatch each phase to a sub-agent, and adjudicate what comes back. Use whenever a request asks for implementation, investigation, a fix, a review, or any change to files — including small ones — and whenever you are about to read source or run a diagnostic yourself instead of handing it off. Also use when a report from a sub-agent needs judging, when a phase needs re-dispatching, or when a user names one instance of a pattern. Does not apply when your own prompt begins "Your ROLE_TYPE is sub-agent." — then follow references/sub-agent-contract.md instead.

Jamie-BitFlight/enterprise-hibernate-hbm

Dasel v3 query patterns for Hibernate .hbm.xml mapping files — entity-table binding, Java property-to-column extraction, one-to-many set/list/bag relationship tracing, many-to-one foreign key discovery, batch scanning across 60+ HBM files. Use when querying Hibernate ORM class mappings, extracting schema metadata from Java persistence layer, or auditing entity-column relationships in enterprise legacy codebases.

Jamie-BitFlight/enterprise-installanywhere

Dasel v3 query patterns for InstallAnywhere .iap_xml installer definitions — use when querying action sequences, discovering variables, resolving platform conditions, navigating panels, or comparing installer variants. Files are 2.5+ MB, 65,000+ lines — too large for context reads, requires structural dasel queries.

Jamie-BitFlight/enterprise-maven-pom

Dasel v3 selector patterns for Maven POM XML files — use when querying dependency versions, filtering by groupId or scope, extracting module hierarchy from parent POMs, or detecting version conflicts across enterprise multi-module Java projects. Load this skill when working with pom.xml files using dasel.

関連スキル