Skip to content

README.ja.md

Latest commit

 

History

History
178 lines (134 loc) · 9.44 KB

README.ja.md

File metadata and controls

178 lines (134 loc) · 9.44 KB

⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית

failproof ai

npm CI Supply Chain Slack Docs License

翻訳: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

コーディングエージェントのランタイム障害をリアルタイムで解決。 Claude Code および Codex にフックし、ループや危険な操作、シークレット漏洩を インシデントになる前に検出・阻止します。レイテンシゼロ。ローカルで動作。

Failproof AI in action

対応エージェント CLI

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

1つまたは複数の組み合わせでフックをインストールできます: failproofai policies --install --cli opencode pi gemini（または --cli claude codex copilot cursor opencode pi gemini）。--cli を省略すると、インストール済みの CLI を自動検出してプロンプトを表示します。

インストール

npm install -g failproofai
failproofai policies --install   # または `failproofai` を実行して初回プロンプトを承認
failproofai

30個の組み込みポリシーが即座に有効化されます。ダッシュボードは localhost:8020 で確認できます。FAILPROOFAI_NO_FIRST_RUN=1 を設定すると初回プロンプトを無効化できます。

防げること

ポリシー ブロック対象
block-push-master main / master への直接プッシュ
block-force-push git push --force
block-work-on-main main / master へのコミット、マージ、リベース
block-rm-rf 再帰的なファイル削除
sanitize-api-keys エージェントコンテキストへの API キー漏洩

→ 組み込みポリシー全30件

独自ポリシーの作成

.failproofai/policies/ にファイルを置くだけで自動的に読み込まれます。フラグ不要。 コミットすれば、次回のプル時にチーム全員に適用されます。

import { customPolicies, deny, allow } from "failproofai";

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Writes to production paths are blocked.");
    return allow();
  },
});

各ポリシーで使用できる3つの判断:

判断 効果
allow() 操作を許可する
deny(message) ブロックする — メッセージがエージェントに返される
instruct(message) 通過させるが、エージェントの次のプロンプトにコンテキストを追加する

→ カスタムポリシーガイド

セッションの可視化

エージェントが行うすべてのツール呼び出しはローカルに記録されます。ダッシュボードでは、実行された内容、ブロックされた内容、ポリシーがエージェントに伝えた内容を確認できます。問題が発生したとき、原因を推測する必要はありません。→ ダッシュボードガイド

ドキュメント
はじめに インストールと最初のステップ
組み込みポリシー パラメータ付き全30ポリシー
カスタムポリシー 独自ポリシーの記述方法
設定 設定スコープとマージルール
ダッシュボード セッションモニターとポリシーアクティビティ
アーキテクチャ フックシステムの仕組み

ライセンス

MIT with Commons Clause — 社内利用および個人利用は無料。failproofai 自体の商業的再販には別途契約が必要です。全文は LICENSE をご覧ください。

コントリビューション

CONTRIBUTING.md をご覧ください。新しいポリシー、エッジケース、翻訳の貢献を歓迎します。

始める前にビルドしてください。 最初に bun install && bun run build を実行してください。このリポジトリは failproofai 自身のフックを自身に対して実行しており、failproofai のインポートはコンパイル済みの dist/ バンドルに対して解決されます。ビルドなしでは Cannot find package 'failproofai' というフックエラーが発生します。src/ を変更した後は再ビルドしてください。詳細は リポジトリ内の開発用フックを動かす前にビルドする を参照してください。

Nivedit Jain と Nikita Agarwal により開発。 befailproof.ai