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

naimkatiman/continuous-improvement

Claude Code 向け AI エージェント規律の7つの法則。エージェントが調査をスキップしたり、確認せずに「完了」と主張したり、昨日のミスを繰り返すのを防ぎます。14のエンフォースメントスキル、ゲーティングフック、フリクションハーベストを備えた Mulahazah 本能エンジン、そして GitHub Action リンターを搭載。初心者は /plugin install で、エキスパートは MCP ツールを追加します。

continuous-improvement とは?

naimkatiman/continuous-improvement は、Claude Code のための AI エージェント規律の7つの法則(Seven Laws of AI Agent Discipline)を実装したスキルです。このスキルは、AI エージェントが開発作業において、調査をスキップして結論に飛びついたり、適切な検証なしにタスクを「完了」と報告したり、過去の失敗から学習せず同じ過ちを繰り返すといった、よくある反生産的な行動パターンを抑制するように設計されています。14のエンフォースメントスキルとゲーティングフックにより、エージェントの行動を監視・制御し、Mulahazah 本能エンジンがフリクションハーベストと呼ばれるメカニズムを通じて、ワークフロー内の非効率や摩擦点を自律的に特定・蓄積します。さらに、GitHub Action リンターが CI/CD パイプラインと統合され、コード品質とエージェントの規律を継続的にチェックします。初心者は `/plugin install` コマンドで簡単に導入でき、エキスパートユーザーは Model Context Protocol (MCP) ツールを追加することで、より高度なカスタマイズとインテグレーションが可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add naimkatiman/continuous-improvement

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

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

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

ドキュメント

continuous-improvement は何をしますか?

Claude Code 向け AI エージェント規律の7つの法則。エージェントが調査をスキップしたり、確認せずに「完了」と主張したり、昨日のミスを繰り返すのを防ぎます。14のエンフォースメントスキル、ゲーティングフック、フリクションハーベストを備えた Mulahazah 本能エンジン、そして GitHub Action リンターを搭載。初心者は /plugin install で、エキスパートは MCP ツールを追加します。

はじめに

Continuous Improvement Skill は、Claude Code エージェントが一貫した品質基準を維持し、反復的な作業を自動化し、時間の経過とともに改善することを保証します。これは、プロジェクトのワークフロー内に摩擦点と非効率を特定して解決する AI ネイティブのフレームワークを提供します。

インストール

初心者向け(プラグインモード)

以下のコマンドを実行してスキルをインストールします。

/plugin install naimkatiman/continuous-improvement

エキスパート向け(MCP ツールモード)

  1. リポジトリをクローンします。
  2. claude.json または claude_dev_tools.json に MCP サーバー設定を追加します。
  3. mcp-tools/ ディレクトリ以下のツールを個別に有効化します。

7つの法則

このスキルは、以下の7つの法則に基づいてエージェントの行動を規律します。

  1. 調査の法則: エージェントは結論を出す前に、すべての利用可能な情報を調査しなければなりません。
  2. 検証の法則: エージェントは、出力を「完了」とマークする前に検証しなければなりません。
  3. 記憶の法則: エージェントは過去のイテレーションから学習し、同じ過ちを繰り返してはいけません。
  4. 摩擦の法則: エージェントはワークフロー内の非効率を積極的に特定し、記録しなければなりません。
  5. 改善の法則: エージェントは記録された摩擦に基づいて自己修正を提案しなければなりません。
  6. 一貫性の法則: エージェントはセッション間で一貫した行動パターンを維持しなければなりません。
  7. 透明性の法則: エージェントはすべての行動と判断を文書化しなければなりません。

機能

14のエンフォースメントスキル

各法則には、1つ以上のエンフォースメントスキルが関連付けられています。これらのスキルは、ルールが確実に守られるように実装されています。

ゲーティングフック

ゲーティングフックを使用すると、特定のアクションが実行される前後に条件をチェックできます。例えば、コミット前にすべてのテストが通過していることを確認したり、デプロイ前に検証手順を強制したりできます。

Mulahazah 本能エンジン

Mulahazah(「観察」のアラビア語)は、ワークフロー内の摩擦点を継続的に監視・収集する本能エンジンです。摩擦点が検出されると、エンジンはそれを収穫(harvest)し、改善のために記録します。

フリクションハーベスト

摩擦点の例:

  • ビルド時間の延長
  • 一貫性のないコードスタイル
  • 頻繁な手動介入
  • 重複する作業
  • 未使用の依存関係

GitHub Action リンター

このスキルには、CI/CD パイプライン内でエージェントの規律ルールを強制する GitHub Action が含まれています。以下を使用してワークフローに追加できます。

- name: AI Agent Discipline Linter
  uses: naimkatiman/continuous-improvement@v1
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}

使用方法

  1. スキルをインストールした後、Claude Code を起動し、以下のように指示します。
このプロジェクトに対して Continuous Improvement を有効化し、摩擦点を特定してください。
  1. エージェントが自動的にワークフローを分析し、改善点を提案します。
  2. 収穫された摩擦は、プロセスを繰り返し改善するために使用されます。

設定

設定は、プロジェクトルートの .claude/skills/continuous-improvement.json にあります。利用可能なオプションは以下の通りです。

{
  "enabled_laws": ["research", "verification", "memory", "friction", "improvement", "consistency", "transparency"],
  "friction_harvest": true,
  "mcp_tools": false,
  "github_lint": false
}

貢献

貢献を歓迎します!PRを送信する前に、CONTRIBUTING.md をご確認ください。

ライセンス

MIT

関連スキル