تخصيص وكيل الذكاء الاصطناعي
كل ما يظهر في هذه الصفحة هو ملف محلي. الملفات الموجودة ضمن .champrep/ في مستودع يتم مشاركتها مع فريقك عبر git؛ الملفات الموجودة ضمن $CONFIG/ai/
تنطبق عليك فقط، في كل مشروع. عندما يكون للمشروع وتعريف المستخدم نفس الاسم، فإن تعريف المشروع هو الذي يسود.
محتوى المشروع في .champrep/ يظل غير نشط حتى تثق في المستودع. انظر ثقة المستودع.
تعليمات المشروع: CHAMPREP.md
Section titled “تعليمات المشروع: CHAMPREP.md”CHAMPREP.md يحتوي على تعليمات دائمة للوكيل: كيفية إنشاء واختبار المشروع، والاتفاقيات، والأمور التي يجب تجنبها. يقرأ الوكيل، في بداية كل جلسة:
$CONFIG/ai/CHAMPREP.md، تعليماتك الشخصية لكل مشروع؛CHAMPREP.mdفي جذر المشروع وفي كل دليل بدءًا من الجذر وصولًا إلى المكان الذي بدأت فيه تشغيل الوكيل.
إذا كان الدليل لا يحتوي على CHAMPREP.md، وهو AGENTS.md يُستخدم هناك بدلاً من ذلك.
| الإجراء | كيف |
|---|---|
| إنشاء واحد | /init يبحث في المستودع ويكتب CHAMPREP.md، مع الاحتفاظ بالمحتوى المفيد من ملف موجود AGENTS.md. |
| إضافة ملاحظة | ابدأ موجهًا بـ #، على سبيل المثال # run make lint before committing. |
| عرض أو تعديل | /memory، أو /memory edit [user|project|FILE] لفتحه في محررك. |
تنطبق ذاكرة CHAMPREP AIحسابك، التي تُدار في CHAMPREP AIإعداداتك على الويب، في المحطة الطرفية أيضًا. /memory يظهره على أنه للقراءة فقط.
الأوامر المخصصة
Section titled “الأوامر المخصصة”الأمر المخصص هو قالب موجه Markdown تقوم بتشغيله كـ /<name>.
| الموقع | النطاق |
|---|---|
.champrep/commands/NAME.md | هذا المشروع |
$CONFIG/ai/commands/NAME.md | أنت |
ملف في مجلد فرعي، مثل commands/git/commit.md، يصبح
/git:commit. قم بإنشاء واحدة باستخدام /commands new NAME وإدراجها باستخدام
/commands.
---description: Explain a failing test and propose a fixargument-hint: <test name>allowed-tools: [local_read_file, local_grep, local_bash]---Find the test named $1, run it, and explain why it fails.Relevant notes: @docs/testing.mdRecent changes:!`git log --oneline -5`$ARGUMENTSهو كل ما يلي اسم الأمر؛$1,$2، … هي معلمات فردية. إذا لم يستخدم القالب أيًا منهما، تُلحق المعلمات.@pathيتضمن ملف مساحة العمل. لا يتم تضمين الملفات السرية أبدًا.!`command`يُشغّل أمرًا عند استدعاء القالب. يُطلب منك الموافقة على ذلك مرة واحدة لكل قالب، ومرة أخرى كلما تغير.allowed-toolsيحد من الأدوات المتاحة لتلك الدورة، وmodelيلغي النموذج.
المهارات
Section titled “المهارات”المهارة هي مجلد يحتوي على تعليمات وملفات داعمة اختيارية، لا يقوم الوكيل بتحميلها إلا عند الحاجة إليها. وحتى ذلك الحين، لا يرى النموذج سوى اسم المهارة ووصفها، لذا فإن العديد من المهارات لا تتطلب سوى القليل جدًا من السياق.
| الموقع | النطاق |
|---|---|
.champrep/skills/NAME/SKILL.md | هذا المشروع |
$CONFIG/ai/skills/NAME/SKILL.md | أنت |
---description: Release checklist for this servicewhen_to_use: When the user asks to cut, tag, or publish a release---1. Confirm the changelog has an entry for the new version.2. .../skills تسرد المهارات، بما في ذلك المهارات من CHAMPREP AIحسابك. قم بتشغيل واحدة مباشرةً باستخدام /<skill-name>.
الوكلاء المخصصون
Section titled “الوكلاء المخصصون”الوكيل المخصص هو وكيل فرعي له تعليماته وأدواته ونموذجه الخاص.
| الموقع | النطاق |
|---|---|
.champrep/agents/NAME.md | هذا المشروع |
$CONFIG/ai/agents/NAME.md | أنت |
---name: test-writerdescription: Writes and fixes unit tests. Use after a code change.tools: [local_read_file, local_grep, local_glob, local_edit_file, local_bash]permission_mode: accept-editsisolation: worktree---You write focused unit tests that follow this project's existing style.descriptionيُعلم الوكيل الرئيسي بموعد تفويض المهمة إليه.toolsيحدد الأدوات؛ اتركه فارغًا ليرث أدوات الجلسة.permission_modeيمكن فقط جعل الوكيل أكثر صرامة من جلستك.isolation: worktreeيُشغّلها في شجرة عمل git الخاصة بها.
إدارة الوكلاء باستخدام /agents create|edit|delete NAME. ابدأ جلسة بصفتك وكيلًا باستخدام champrep ai --agent NAME، أو أرسل له موجهًا باستخدام
@NAME prompt. انظر الوكلاء الفرعيون.
الخطافات
Section titled “الخطافات”الخطافات هي أوامر شل يقومCLI بها في نقاط معينة خلال الجلسة، على سبيل المثال لتنسيق الملفات بعد التعديل أو لمنع أوامر معينة.
| الحدث | يتم التشغيل |
|---|---|
SessionStart | عند بدء الجلسة. |
UserPromptSubmit | قبل إرسال موجه. يمكن حظره أو إضافة سياق. |
PreToolUse | قبل تشغيل أداة محلية. يمكن حظرها. |
PostToolUse | بعد تشغيل أداة محلية. يمكن إضافة تعليقات على النتيجة. |
PermissionRequest | عند عرض موجه طلب الإذن. |
Notification | متى يخطرك الوكيل. |
SubagentStop | عندما ينتهي وكيل فرعي. |
PreCompact | قبل ضغط المحادثة. |
Stop | عند انتهاء الدور. |
SessionEnd | عند انتهاء الجلسة. |
تكوين الخطافات في أي ملف إعدادات:
{ "hooks": { "PostToolUse": [ { "matcher": "local_edit_file|local_write_file", "command": "npm run format --silent", "timeout": 30 } ], "PreToolUse": [ { "matcher": "local_bash", "command": "./scripts/check-command.sh" } ] }}matcherهو تعبير عادي على اسم الأداة؛ اتركه فارغًا لمطابقة كل الأداوت.- يتلقى الـhook وصفًا بتنسيق JSON للحدث عبر المدخلات القياسية.
- رمز الخروج
2، أو إخراج JSON باستخدام"decision": "block"وreason، يوقف الإجراء حيثما يسمح الحدث بذلك.additionalContextفي JSON يضيف الإخراج نصًا للنموذج. - المهلة الافتراضية هي 60 ثانية، والحد الأقصى هو 10 دقائق.
- يتم تشغيل الروابط باستخدام بيئتك باستثناء بياناتCHAMPREP الاعتماد.
إدارة الخطافات باستخدام /hooks, /hooks add EVENT [--matcher M] [--timeout S] [--scope user|project] -- COMMAND, /hooks disable ID، و /hooks enable ID.
الشكل والمظهر
Section titled “الشكل والمظهر”| الأمر | الخيارات |
|---|---|
/color | لون تمييز لجلسات هذا المشروع، لتمييز الجلسات المتوازية عن بعضها: blue, cyan, green, yellow, orange, red, pink, magenta, purple, gray، أو reset. |
/theme | auto, dark, light, high-contrast، أو colorblind. NO_COLOR و --no-color إيقاف تشغيل الألوان. |
/statusline | اختر أجزاء من profile, model, context, branch, mode, cost، و tasks؛ استخدم /statusline command CMD لعرض السطر الأول من إخراج الأمر الخاص بك؛ /statusline reset يستعيد الإعدادات الافتراضية. |
/output-style | default, concise, explanatory، أو learning. |
/vim | التحرير بنمط Vim في موجه الأوامر. |
/keybindings | عرض الاختصارات؛ /keybindings edit يفتح $CONFIG/ai/keybindings.json. |
/config | كل ما سبق في شاشة واحدة. |
الملفات المحلية
Section titled “الملفات المحلية”تُخزّن محادثات الوكيل على CHAMPREP AIحسابك. يتم تخزين الحالة الخاصة بالجهاز فقط محليًّا. اطبع كل موقع على جهازك باستخدام:
champrep ai paths| ماذا | أين |
|---|---|
| CLI ملفات التعريف والبيئات | $CONFIG/config.toml |
| إعدادات الوكيل الخاص بك: القواعد، الوضع، السمة، سطر الحالة، الخطافات | $CONFIG/ai/settings.json |
| تجاوزات ربط المفاتيح | $CONFIG/ai/keybindings.json |
| تعليماتك الشخصية | $CONFIG/ai/CHAMPREP.md |
| وكلاؤك وأوامرك ومهاراتك | $CONFIG/ai/agents/, commands/, skills/ |
| خوادم MCP المحلية الخاصة بك | $CONFIG/ai/mcp.json |
| المشاريع الموثوقة | $CONFIG/ai/trusted-projects.json |
| المحادثات الحديثة لكل دليل، وقوائم المهام | $STATE/ai/sessions.json |
| سجل المطالبات (محجوب ومحدود) | $STATE/ai/history.jsonl |
| سجلات التصحيح (محجوبة، تُحتفظ بها لمدة 7 أيام) | $STATE/ai/logs/ |
| نقاط فحص الملفات | $CACHE/ai/checkpoints/ |
| إعدادات المشروع (قابلة للتسجيل) | .champrep/settings.json, mcp.json, agents/, commands/, skills/ |
| تجاوزات مشروعك (المهملة في git) | .champrep/settings.local.json |
| تعليمات المشروع | CHAMPREP.md |
| أشجار العمل | .champrep/worktrees/ |
لا يتم تخزين بيانات الاعتماد أبدًا في هذه الملفات. بل تظل مخزنة في سلسلة المفاتيح الخاصة بنظام التشغيل.
| الجذر | macOS و Linux | ويندوز |
|---|---|---|
$CONFIG | $XDG_CONFIG_HOME/champrep، وإلا ~/.config/champrep | %APPDATA%\champrep |
$STATE | $XDG_STATE_HOME/champrep، وإلا ~/.local/state/champrep | %LOCALAPPDATA%\champrep\state |
$CACHE | $XDG_CACHE_HOME/champrep، وإلا ~/.cache/champrep | %LOCALAPPDATA%\champrep\cache |
تعيين CHAMPREP_CONFIG_DIR للحفاظ على الثلاثة جميعًا في دليل واحد، في config/,
state/، و cache/ المجلدات الفرعية. وهذا مفيد للتثبيتات القابلة للنقل و عمليات CI المعزولة.