Skip to content

Latest commit

 

History

History
183 lines (137 loc) · 8.56 KB

File metadata and controls

183 lines (137 loc) · 8.56 KB

⚠️ هذه ترجمة آلية. للاطلاع على أحدث إصدار، راجع English README.

🇺🇸 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 בעבודה


CLI של סוכנים נתמכים

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

התקן hooks לאחד או לכל צירוף: 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 Commits, merges, rebases על main / master
block-rm-rf מחיקת קבצים רקורסיבית
sanitize-api-keys מפתחות API שדולפים להקשר של סוכן

כל 30 המדיניות המובנות


המדיניויות שלך שלך

הנח קובץ ל-.failproofai/policies/ — הוא טוען באופן אוטומטי, ללא דגלים נדרשים. Commit זה וכל הצוות משיג את זה בפול הבא.

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();
  },
});

שלוש החלטות זמינות לכל מדיניות:

החלטה השפעה
allow() אפשר את הפעולה
deny(message) חסום את זה — ההודעה חוזרת לסוכן
instruct(message) תן לזה לעבור, אבל הוסף הקשר להנחיה הבאה של הסוכן

מדריך מדיניויות מותאם אישית


ראות הטלות

כל קריאה כלי שהסוכן שלך עושה מוקלטת באופן מקומי. לוח הבקרה מציג מה רץ, מה נחסם, ומה המדיניות אמרה לסוכן — כך שאתה לא מנחש כשמשהו הולך לא בסדר. → מדריך לוח בקרה


תיעוד

התחלה מהירה התקנה וצעדים ראשונים
מדיניויות מובנות כל 30 המדיניויות עם פרמטרים
מדיניויות מותאמות אישית כתוב שלך
תצורה טווחי תצורה וכללי מיזוג
לוח בקרה צג הטלות ופעילות מדיניויות
אדריכלות איך מערכת ה-hook פועלת

רישיון

MIT עם Commons Clause — חינם לשימוש פנימי ואישי; מכירה מחדש מסחרית של failproofai עצמו דורשת הסכם נפרד. ראה LICENSE לטקסט המלא.


תרומה

ראה CONTRIBUTING.md. מדיניויות חדשות, מקרי קצה, ותרגומים כולם מוזמנים.


בנוי על ידי Nivedit Jain ו-Nikita Agarwal. befailproof.ai