Second Brain OS: بناء قاعدة معرفة ذاتية التنظيم باستخدام Claude Code

لمن يصلح

• مناسب لمن يريد بناء قاعدة معرفة ذاتية التنظيم باستخدام Claude Code: تجمع المقالات والملاحظات باستمرار وتتمنى أن تُستخرج وتُربط بروابط مزدوجة وتبقى مرتبة تلقائيًا، بدلًا من أن تتحول إلى كومة ملفات لا يعود أحد إليها.
• يقدّم دليلًا كاملًا وvault أوليًا وagent skills وسكربتات، ويعتمد على ملفات markdown وwikilink وملف SKILL.md؛ كما يصلح لأي agent يستطيع قراءة الملفات. Obsidian مجرد عارض للرسم البياني وليس اعتمادًا إلزاميًا.
• الحالات غير المناسبة: إذا كنت تبحث عن برنامج ملاحظات رسومي جاهز للاستخدام فورًا ولا ترغب في استنساخ المستودع من الطرفية ونسخ المجلدات وتشغيل الـagent، فهذه الطريقة لا تناسبك. الأدلة الرسمية لا توضح أي العملاء يدعمها خارج الـagents المذكورة، ولا لغات النصوص المدعومة، ولا وجود قيود أخرى إلى جانب أنها مجانية ولا تتطلب تسجيلًا — الحدود الأخرى مجهولة.

أول تجربة في 3 دقائق

المسار الرئيسي الرسمي هو التثبيت محليًا في ~/brain من الطرفية، ثم تشغيل Claude Code في ذلك المجلد:

1. المتطلبات المسبقة: تثبيت git وClaude Code (الـagent)، ويُنصح بتثبيت Obsidian أيضًا لمشاهدة الرسم البياني.
2. نفّذ أمر التثبيت الرسمي في الطرفية لنسخ الـvault الأولي مع الـskills والـcommands والـagents إلى ~/brain/.claude:

git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude

1. الآثار الجانبية ونقاط التأكيد: الأوامر أعلاه ستنشئ ~/brain في مجلد المستخدم الخاص بك وتكتب ملفات فيه؛ إذا كان الهدف موجودًا مسبقًا، تأكد بنفسك أولًا من مسألة الكتابة فوقه.
2. شغّل مهمة أولى منخفضة المخاطر: احفظ أو انسخ مقالًا كملف في مجلد raw/، ثم اكتب /ingest في Claude Code. هذه هي سير العمل الرسمي الأساسي: يتولى الـagent استيعاب المادة واستخلاصها وربطها وتنظيف المواد الخام، محوّلًا إياها إلى ويكي مترابط. يقرأ ويكتب ملفات markdown داخل الـvault؛ أما ما إذا كان ينفذ أوامر أو يصل إلى الشبكة أثناء ذلك فالأدلة الرسمية لا توضحه، فيُعامل كأمر مجهول. إذا تضمنت المقالة محتوى حساسًا، أزِل الحساسية منها قبل وضعها في raw/.
3. إشارة النجاح: يُحوَّل المقال في raw/ إلى صفحات ملاحظات داخل الـvault تحتوي على wikilink؛ والقاعدة الرسمية هي "Nothing is ingested until it is linked" — إذا لم تكتمل الروابط في نفس الدورة فالاستيعاب غير مكتمل. لذا تحقق من ظهور روابط فعلية إلى ملاحظات أخرى في الصفحة الجديدة؛ هذا هو المعيار للحكم على انتهاء دورة /ingest. الأدلة الرسمية لا توضح فحوصات المراجعة الداخلية لـ/ingest أو ما إذا كانت هناك سير عمل مختلفة لأنواع النصوص المختلفة، ولا يجوز افتراض ذلك.

حالات الاستخدام

الحالة الأولى: أرشفة مقالات محفوظة. تقتطع المقالات بالمتصفح باستمرار لكنك لا تعود إليها أبدًا. السيناريو: احفظ مقالًا مقتطعًا في ~/brain/raw/، ثم شغّل /ingest في Claude Code. سيمر بسير العمل الرسمي للاستيعاب — استخلاص النقاط الرئيسية، والربط بالملاحظات الموجودة، ثم التنظيف. النتيجة المتوقعة: تتحول ملفات raw إلى صفحات ويكي مترابطة؛ وإذا وجدت الصفحة الجديدة تفتقر إلى الروابط، فبحسب القاعدة الرسمية يُعد الاستيعاب في تلك الدورة غير مكتمل، ويمكنك مطالبة الـagent باستكمال الروابط.

الحالة الثانية: عرض خريطة المعرفة في Obsidian. السيناريو: بعد إتمام عدة عمليات ingest، تريد التحقق من الروابط بين الملاحظات. الطريقة: افتح الـvault الموجود في ~/brain باستخدام Obsidian (وهو عارض الرسم البياني حسب الشرح الرسمي)، وتصفح الرسم الناتج عن الملاحظات والـwikilink. ما يمكن تأكيده: الـvault يتكون من markdown وwikilink فقط، ويستطيع Obsidian فتحه مباشرة وعرض الرسم البياني؛ الشرح الرسمي لا يذكر أي تكامل أو مزامنة تلقائية أعمق، فلا تتوقع تكاملًا يتجاوز دور العارض.

حدود الاستخدام

• الوصول إلى الملفات: التثبيت والتشغيل ينشئان ويعدّلان ملفات markdown محليًا (~/brain ومجلد raw/ ومجلد .claude)؛ هذا جوهر العملية وليس أثرًا جانبيًا اختياريًا.
• الأوامر والشبكة: الأدلة الرسمية تذكر أوامر تثبيت shell المذكورة أعلاه فقط؛ أما ما إذا كان الـagent ينفذ أوامر أخرى أو يصل إلى الشبكة أثناء الاستيعاب فغير موضح، ويُعد مجهولًا.
• نقاط التأكيد: راجع المواد الحساسة بنفسك قبل وضعها في raw/؛ وتأكد بنفسك قبل الكتابة فوق ~/brain الموجود.
• بيئة التشغيل: تتطلب طرفية محلية وgit وagent يقرأ الملفات (المسار الرسمي الرئيسي يستخدم Claude Code)؛ وتتطلب Obsidian لمشاهدة عرض الرسم البياني، لكنه ليس اعتمادًا إلزاميًا. لم تُذكر أي قيود تشغيل أخرى في الشرح الرسمي.
• معلومات رئيسية غير مؤكدة: ما إذا كانت قائمة الـagents المدعومة تقتصر على Claude Code (الشرح الرسمي يقول فقط إنه works with Claude Code and any agent that reads files)، واللغات النصية المدعومة، والأوامر المتاحة إلى جانب /ingest — كلها بلا أدلة؛ يمكنك قبل الاستخدام الاطلاع بنفسك على الملفات الفعلية في مجلدي skills وcommands للتأكد.