إنشاء المهارات واستخدامها في Bob Shell

إنشاء مجلد المهارة

انتقل إلى المجلد الجذر لـ Galaxium Travels وأنشئ مجلدًا للمهارة:

cd galaxium-travels
mkdir -p .bob/skills/changelog-entry

كتابة ملف SKILL.md

أنشئ .bob/skills/changelog-entry/SKILL.md بالمحتوى التالي. يمكنك استخدام أي محرر نصوص، أو تشغيل الأمر كما هو مكتوب:

cat > .bob/skills/changelog-entry/SKILL.md <<'EOF'
---
name: changelog-entry
description: Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready.
---

Add an entry to CHANGELOG.md using the Keep a Changelog format (https://keepachangelog.com/).

- If CHANGELOG.md does not exist, create it at the project root with this structure before adding an entry:

  # Changelog

  All notable changes to this project are documented in this file.
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

  ## [Unreleased]

- Add new entries under the `## [Unreleased]` section, under one of these subheadings: `### Added`, `### Changed`, `### Fixed`, `### Removed`. Create the subheading if it is not already present under `## [Unreleased]`.
- Write each entry as a single bullet point in the imperative mood ("Add", not "Added"), starting with a capital letter, with no trailing period.
- Base the entry on the actual diff, not on the wording of the request. Run `git diff` to review what changed before writing the entry.
- Only edit CHANGELOG.md. Do not stage or commit the change.
EOF

يُعرّف الـ front matter حقلين مطلوبين:

• name: اسم المهارة. طابقه مع اسم المجلد، لأن Bob Shell يستخدم اسم المجلد للإشارة إلى المهارة، مثلاً $changelog-entry.
• description: ما يقرأه Bob لتقرير ما إذا كانت المهارة تنطبق على طلب عندما لا تُشير إليها بالاسم. إذا حذفته، يستخدم Bob السطر الأول من التعليمات بدلاً من ذلك، لذا اكتب دائمًا وصفًا واضحًا.

كل شيء أسفل --- الختامية هو مجموعة التعليمات التي يتبعها Bob عند تفعيل المهارة.

تشغيل Bob Shell

ابدأ جلسة تفاعلية في وضع Agent من المجلد الجذر لـ Galaxium Travels:

bob chat --mode agent

وضع Agent يمنح Bob صلاحية الأدوات التي يحتاجها لتفعيل المهارات وتعديل الملفات. إذا سألك Bob Shell عما إذا كنت تثق بالمجلد، ثق بالمجلد حتى يتمكن Bob من تحميل مهارات المشروع.

تعديل README.md

اطلب من Bob إجراء تعديل صغير وقليل الخطورة حتى يكون لديك شيء لتسجيله:

Add a one-line note to the end of the README.md that says "Powered by IBM Bob."

يُظهر Bob التغيير المقترح كـ diff. اختر Approve لتطبيق التعديل.

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

اكتب $ لفتح منتقي المهارات، ثم اختر changelog-entry. يُدرج Bob Shell مرجع المهارة في أمرك:

$changelog-entry Add a changelog entry for this change.

يطلب Bob إذنًا لاستخدام المهارة وتعديل الملفات. وافق على كل طلب. يحمّل Bob مهارة changelog-entry وينشئ CHANGELOG.md، لأن المشروع لا يحتوي على واحد. ثم يُضيف Bob إدخالاً مشابهاً للتالي:

## [Unreleased]

### Added

- Add "Powered by IBM Bob." note to the end of README.md

التحقق من إدخال changelog الأول

اطلب من Bob أن يريك changelog:

Show me @CHANGELOG.md

الإدخال يتطابق مع إدخال changelog الذي ولّده Bob في تسجيل التغيير بالمهارة.

مسح سجل المحادثة

أدخل أمر /clear slash لإعادة تعيين سجل المحادثة، حتى لا يكون لدى Bob ذاكرة بمرجع المهارة السابق:

/clear

إجراء تعديل ثانٍ على README.md

اطلب من Bob إجراء تعديل ثانٍ:

Add a one-line comment above the main heading in README.md that says "Galaxium Travels".

وافق على التعديل عند المطالبة.

تسجيل التغيير دون تسمية المهارة

اطلب من Bob تسجيل التغيير دون تسمية المهارة:

Add an entry to CHANGELOG.md in Keep a Changelog format.

يتعرف Bob أن الطلب يتطابق مع وصف مهارة changelog-entry ويفعّلها دون مرجع $changelog-entry. وافق على طلبات المهارة وتعديل الملفات عند المطالبة. يُضيف Bob إدخالاً آخر بنفس التنسيق.

التحقق من كلا إدخالَي changelog

اطلب من Bob أن يريك changelog:

Show me @CHANGELOG.md

يحتوي changelog الآن على إدخالَين تحت ## [Unreleased]، مشابهَين للتالي:

## [Unreleased]

### Added

- Add "Powered by IBM Bob." note to the end of README.md
- Add "Galaxium Travels" comment above the main heading in README.md