تخطَّ إلى المحتوى

كاتب الأدلة التشغيلية

DevOps والنشر agent-skills cli MIT
⬇ تنزيل vsha-2febd4f36e7f

SHA-256: 2febd4f36e7f02316b89e4dd758d19f3a0d2e5a4f5e40b206df03ee3c85becba 2 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add runbook-writer --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

الوصف

عربي

يكتب أدلة تشغيل تُنفذ تحت الضغط: أعراض، تشخيص مرتب، إجراء إصلاح، وتراجع، بلغة خطوات لا وصف عام.

English

Write pressure-ready runbooks: symptoms, ordered diagnostics, repair procedure, and rollback in steps not prose.

بيانات المهارة التقنية

SKILL name
runbook-writer
الوصف الأصلي
Write pressure-ready runbooks: symptoms, ordered diagnostics, repair procedure, and rollback in steps not prose.
إصدار المهارة
1.1.0
التوافق
وصول SSH وDocker اختياري · بيئة Linux
الأدوات المسموح بها
Read, Bash
الكلمات المفتاحية
runbook, operations, devops, documentation
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: runbook-writer
description: Write pressure-ready runbooks: symptoms, ordered diagnostics, repair procedure, and rollback in steps not prose.
version: 1.1.0
metadata:
  author: AiDalil Editorial
  category: devops
  compatibility: amp, claude-code, cursor, windsurf, zed, api
  difficulty: beginner
  tags: [runbook, operations, devops, documentation]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Runbook Writer

**Goal:** Write pressure-ready runbooks: symptoms, ordered diagnostics, repair procedure, and rollback in steps not prose.

> الهدف: يكتب أدلة تشغيل تُنفذ تحت الضغط: أعراض، تشخيص مرتب، إجراء إصلاح، وتراجع، بلغة خطوات لا وصف عام.

## When to use
- الحالة النموذجية: يكتب أدلة تشغيل تُنفذ تحت الضغط: أعراض، تشخيص مرتب، إجراء إصلاح، وتراجع، بلغة خطوات لا وصف عام.
- إعداد بيئات متسقة عبر الحاويات أو البنية التعريفية.
- تخطيط نشر آمن مع تراجع سريع.
- تقليل تكاليف البنية دون التضحية بالموثوقية.
- بناء أو تحسين خط أنابيب بناء ونشر.

## Workflow
1. حدّد التنبيهات على أعراض المستخدم لا على الضجيج التقني فقط.
2. نفّذ النشر في نافذة آمنة مع مراقبة مباشرة.
3. أضف فحوص صحية وحدود موارد واضحة.
4. اختبر على بيئة مطابقة للإنتاج قدر الإمكان.
5. ارسم الحالة الحالية: البناء، النشر، المراقبة، والتراجع.
6. وثّق النتيجة وحدّث الدليل التشغيلي وخطة التراجع.
7. حدّد الهدف: كاتب الأدلة التشغيلية. اذكر الخدمة والبيئة ومعيار النجاح المقيس.
8. حدّد أصغر تحسين بأعلى أثر وابنِه أولاً.

## Rules
- التغييرات الكبيرة تمر خلف رايات تدريجية.
- الأسرار في مخزن أسرار ولا تُطبع في السجلات أبداً.
- كل بيئة تُبنى من التعريفات لا من اللمسات اليدوية.
- كل تنبيه له مالك وإجراء؛ التنبيه الأصم يُحذف.
- السجلات منظمة ومعرّف تتبع يربط الطلب عبر الخدمات.

## Output contract
- خطة تراجع مجرّبة بخطوات دقيقة.
- قائمة تحقق نشر مع نقاط إيقاف واضحة.
- تعريفات بنية أو خط أنابيب بمراجعة مكتوبة.
- تنبيهات مع عتبات ومبررات.

## Quality checks
- [ ] هل التنبيهات مختبرة بإحداث عطل مقصود؟
- [ ] هل حدود الموارد تمنع انهيار جار واحد للخدمة كلها؟
- [ ] هل اختُبر التراجع فعلياً لا نظرياً؟
- [ ] هل زمن الاسترجاع من النسخ الاحتياطي مقاس ومقبول؟
- [ ] هل يمكن إعادة بناء البيئة كاملة من التعريفات؟

## Skill identity
- Skill name: `runbook-writer`
- Version: 1.1.0
- Domain: DevOps and Deployment (DevOps والنشر)
- Tags: runbook, operations, devops, documentation

التثبيت اليدوي

استخدم هذا المسار عند عدم استخدام CLI أو عند إدارة ملفات المهارات يدويًا.

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/runbook-writer/
Claude Code.claude/skills/runbook-writer/
Cursor.cursor/skills/runbook-writer/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

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

• تصميم مراقبة وتنبيهات لأعطال مبكرة. • إدارة حوادث وإعداد تقارير بعدها. • بناء أو تحسين خط أنابيب بناء ونشر.

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-2febd4f36e7f 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026