​

ثلاث طرق للمساهمة

​

المساهمات البرمجية

​

سير العمل

1. انسخ المستودع واستنسخ نسختك
2. أنشئ فرع ميزة:
   git checkout -b feature/my-thing
   # or
   git checkout -b fix/the-bug
   
3. أجرِ تغييراتك
4. تحقق:
   npm run typecheck && npm run lint
   
5. اختبر تغييرات الواجهة في المتصفح (npm run dev)
6. أنشئ التزامًا بالتنسيق التقليدي
7. ادفع وافتح طلب سحب ضد main

​

رسائل الالتزام

type(scope): subject

feat(runtime): add token counting to prefrontal
fix(renderer): prevent flash on theme switch
refactor(motor): simplify retry logic
docs(capabilities): add plugin lifecycle diagram

​

اتفاقيات الكود

// Bad
// Get the user
const user = getUser()

// Good — the WHY is non-obvious
// Fallback to default user when workspace has no user.md yet
const user = getUser() ?? DEFAULT_USER

// In renderer — use the exposed API
const result = await window.api.someChannel(args)

// NEVER do this in renderer
import { something } from '@main/some-module' // Breaks process isolation

​

المساهمة بالقدرات

​

إنشاء قدرة

1. أنشئ مجلدًا في src/defaults/workspace/brain/cerebellum/:
   brain/cerebellum/my-capability/
   ├── SKILL.md          # Required — defines triggers, tools, behavior
   └── plugin/           # Optional — custom tool logic
       └── index.mjs
   
2. اكتب SKILL.md مع البيانات الوصفية المناسبة:
   ---
   name: my-capability
   description: What this capability does
   triggers:
     - keyword that activates this
     - another trigger phrase
   tools:
     - name: my_tool
       description: What this tool does
       parameters:
         type: object
         properties:
           input:
             type: string
             description: The input to process
         required: [input]
   danger:
     - pattern: "rm -rf"
       reason: "Destructive file operation"
   ---
   
   # Instructions for the LLM
   
   When the user asks about [topic], use the `my_tool` tool to...
   
3. اختبر مع النماذج السحابية (DeepSeek، Claude، GPT) والنماذج المحلية (Ollama) - يجب أن يكون السلوك متسقًا.

​

مشاركة القدرات

cd ~/.wolffish/workspace/brain/cerebellum/
git clone https://github.com/you/wolffish-capability-name.git

​

المساهمة في التوثيق

​

الإعداد

git clone https://github.com/thewolffish/wolffish-docs.git
cd wolffish-docs
npx mintlify dev

​

التنسيق

• ملفات MDX مع مكونات Mintlify (Card، CardGroup، Note، Tip، Warning، Tabs، Accordion، إلخ.)
• حافظ على المحتوى عمليًا وموجزًا
• استخدم كتل الكود بكثرة

​

الترجمات