mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-07-11 23:26:32 +02:00
i18n(uk): translate 07-plugins devops-automation & documentation
- Translate READMEs, commands, agents for both plugins - Code/config/hooks files unchanged (no translation needed) Ref: luongnv89/claude-howto#63
This commit is contained in:
Evgenij I
@@ -3,105 +3,105 @@
|
||||
<img alt="Claude How To" src="../../resources/logos/claude-howto-logo.svg">
|
||||
</picture>
|
||||
|
||||
# DevOps Automation Plugin
|
||||
# Плагін DevOps Automation
|
||||
|
||||
Complete DevOps automation for deployment, monitoring, and incident response.
|
||||
Повна автоматизація DevOps для розгортання, моніторингу та реагування на інциденти.
|
||||
|
||||
## Features
|
||||
## Функції
|
||||
|
||||
✅ Automated deployments
|
||||
✅ Rollback procedures
|
||||
✅ System health monitoring
|
||||
✅ Incident response workflows
|
||||
✅ Kubernetes integration
|
||||
✅ Автоматизовані розгортання
|
||||
✅ Процедури відкату
|
||||
✅ Моніторинг стану системи
|
||||
✅ Робочі процеси реагування на інциденти
|
||||
✅ Інтеграція з Kubernetes
|
||||
|
||||
## Installation
|
||||
## Встановлення
|
||||
|
||||
```bash
|
||||
/plugin install devops-automation
|
||||
```
|
||||
|
||||
## What's Included
|
||||
## Що включено
|
||||
|
||||
### Slash Commands
|
||||
- `/deploy` - Deploy to production or staging
|
||||
- `/rollback` - Rollback to previous version
|
||||
- `/status` - Check system health
|
||||
- `/incident` - Handle production incidents
|
||||
### Слеш-команди
|
||||
- `/deploy` — Розгортання на продакшен або стейджинг
|
||||
- `/rollback` — Відкат до попередньої версії
|
||||
- `/status` — Перевірка стану системи
|
||||
- `/incident` — Обробка інцидентів на продакшені
|
||||
|
||||
### Subagents
|
||||
- `deployment-specialist` - Deployment operations
|
||||
- `incident-commander` - Incident coordination
|
||||
- `alert-analyzer` - System health analysis
|
||||
### Субагенти
|
||||
- `deployment-specialist` — Операції розгортання
|
||||
- `incident-commander` — Координація інцидентів
|
||||
- `alert-analyzer` — Аналіз стану системи
|
||||
|
||||
### MCP Servers
|
||||
- Kubernetes integration
|
||||
### MCP-сервери
|
||||
- Інтеграція з Kubernetes
|
||||
|
||||
### Scripts
|
||||
- `deploy.sh` - Deployment automation
|
||||
- `rollback.sh` - Rollback automation
|
||||
- `health-check.sh` - Health check utilities
|
||||
### Скрипти
|
||||
- `deploy.sh` — Автоматизація розгортання
|
||||
- `rollback.sh` — Автоматизація відкату
|
||||
- `health-check.sh` — Утиліти перевірки стану
|
||||
|
||||
### Hooks
|
||||
- `pre-deploy.js` - Pre-deployment validation
|
||||
- `post-deploy.js` - Post-deployment tasks
|
||||
### Хуки
|
||||
- `pre-deploy.js` — Передрозгортальна валідація
|
||||
- `post-deploy.js` — Післярозгортальні завдання
|
||||
|
||||
## Usage
|
||||
## Використання
|
||||
|
||||
### Deploy to Staging
|
||||
### Розгортання на стейджинг
|
||||
```
|
||||
/deploy staging
|
||||
```
|
||||
|
||||
### Deploy to Production
|
||||
### Розгортання на продакшен
|
||||
```
|
||||
/deploy production
|
||||
```
|
||||
|
||||
### Rollback
|
||||
### Відкат
|
||||
```
|
||||
/rollback production
|
||||
```
|
||||
|
||||
### Check Status
|
||||
### Перевірка стану
|
||||
```
|
||||
/status
|
||||
```
|
||||
|
||||
### Handle Incident
|
||||
### Обробка інциденту
|
||||
```
|
||||
/incident
|
||||
```
|
||||
|
||||
## Requirements
|
||||
## Вимоги
|
||||
|
||||
- Claude Code 1.0+
|
||||
- Kubernetes CLI (kubectl)
|
||||
- Cluster access configured
|
||||
- Налаштований доступ до кластера
|
||||
|
||||
## Configuration
|
||||
## Конфігурація
|
||||
|
||||
Set up your Kubernetes config:
|
||||
Налаштуйте конфіг Kubernetes:
|
||||
```bash
|
||||
export KUBECONFIG=~/.kube/config
|
||||
```
|
||||
|
||||
## Example Workflow
|
||||
## Приклад робочого процесу
|
||||
|
||||
```
|
||||
User: /deploy production
|
||||
|
||||
Claude:
|
||||
1. Runs pre-deploy hook (validates kubectl, cluster connection)
|
||||
2. Delegates to deployment-specialist subagent
|
||||
3. Runs deploy.sh script
|
||||
4. Monitors deployment progress via Kubernetes MCP
|
||||
5. Runs post-deploy hook (waits for pods, smoke tests)
|
||||
6. Provides deployment summary
|
||||
1. Запускає pre-deploy хук (валідація kubectl, з'єднання з кластером)
|
||||
2. Делегує субагенту deployment-specialist
|
||||
3. Запускає скрипт deploy.sh
|
||||
4. Моніторить прогрес розгортання через Kubernetes MCP
|
||||
5. Запускає post-deploy хук (очікування подів, smoke-тести)
|
||||
6. Надає підсумок розгортання
|
||||
|
||||
Result:
|
||||
✅ Deployment complete
|
||||
📦 Version: v2.1.0
|
||||
🚀 Pods: 3/3 ready
|
||||
⏱️ Time: 2m 34s
|
||||
Результат:
|
||||
✅ Розгортання завершено
|
||||
📦 Версія: v2.1.0
|
||||
🚀 Поди: 3/3 готові
|
||||
⏱️ Час: 2хв 34с
|
||||
```
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: alert-analyzer
|
||||
description: Analyzes monitoring alerts and system metrics
|
||||
description: Аналізує алерти моніторингу та метрики системи
|
||||
tools: read, grep, bash
|
||||
---
|
||||
|
||||
# Alert Analyzer
|
||||
# Аналізатор алертів
|
||||
|
||||
Analyzes system health and alerts:
|
||||
- Alert correlation
|
||||
- Trend analysis
|
||||
- Root cause identification
|
||||
- Metric visualization
|
||||
- Proactive issue detection
|
||||
Аналізує стан системи та алерти:
|
||||
- Кореляція алертів
|
||||
- Аналіз трендів
|
||||
- Визначення першопричини
|
||||
- Візуалізація метрик
|
||||
- Проактивне виявлення проблем
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: deployment-specialist
|
||||
description: Handles all deployment operations
|
||||
description: Обробляє всі операції розгортання
|
||||
tools: read, write, bash, grep
|
||||
---
|
||||
|
||||
# Deployment Specialist
|
||||
# Спеціаліст з розгортання
|
||||
|
||||
Expert in deployment operations:
|
||||
- Blue-green deployments
|
||||
- Canary releases
|
||||
- Rollback procedures
|
||||
- Health checks
|
||||
- Database migrations
|
||||
Експерт з операцій розгортання:
|
||||
- Blue-green розгортання
|
||||
- Канаркові релізи
|
||||
- Процедури відкату
|
||||
- Перевірки стану
|
||||
- Міграції бази даних
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: incident-commander
|
||||
description: Coordinates incident response
|
||||
description: Координує реагування на інциденти
|
||||
tools: read, write, bash, grep
|
||||
---
|
||||
|
||||
# Incident Commander
|
||||
# Командир інцидентів
|
||||
|
||||
Manages incident response:
|
||||
- Severity assessment
|
||||
- Team coordination
|
||||
- Status updates
|
||||
- Resolution tracking
|
||||
- Post-mortem facilitation
|
||||
Керує реагуванням на інциденти:
|
||||
- Оцінка серйозності
|
||||
- Координація команди
|
||||
- Оновлення статусу
|
||||
- Відстеження розв'язання
|
||||
- Фасилітація post-mortem
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
name: Deploy
|
||||
description: Deploy application to production or staging
|
||||
description: Розгортання застосунку на продакшен або стейджинг
|
||||
---
|
||||
|
||||
# Deploy Application
|
||||
# Розгортання застосунку
|
||||
|
||||
Execute deployment workflow:
|
||||
Виконання робочого процесу розгортання:
|
||||
|
||||
1. Run pre-deployment checks
|
||||
2. Build application
|
||||
3. Run tests
|
||||
4. Deploy to target environment
|
||||
5. Run health checks
|
||||
6. Notify team on Slack
|
||||
1. Запуск передрозгортальних перевірок
|
||||
2. Збірка застосунку
|
||||
3. Запуск тестів
|
||||
4. Розгортання на цільове середовище
|
||||
5. Запуск перевірок стану
|
||||
6. Повідомлення команди в Slack
|
||||
|
||||
@@ -1,16 +1,16 @@
|
||||
---
|
||||
name: Incident Response
|
||||
description: Handle production incidents with structured response
|
||||
description: Обробка інцидентів на продакшені зі структурованим реагуванням
|
||||
---
|
||||
|
||||
# Incident Response
|
||||
# Реагування на інциденти
|
||||
|
||||
Structured incident response workflow:
|
||||
Структурований процес реагування на інциденти:
|
||||
|
||||
1. Create incident record
|
||||
2. Assess severity and impact
|
||||
3. Notify on-call team
|
||||
4. Gather diagnostic information
|
||||
5. Coordinate response efforts
|
||||
6. Document resolution
|
||||
7. Schedule post-mortem
|
||||
1. Створення запису інциденту
|
||||
2. Оцінка серйозності та впливу
|
||||
3. Повідомлення чергової команди
|
||||
4. Збір діагностичної інформації
|
||||
5. Координація зусиль з реагування
|
||||
6. Документування розв'язання
|
||||
7. Планування post-mortem
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: Rollback
|
||||
description: Rollback to previous deployment
|
||||
description: Відкат до попереднього розгортання
|
||||
---
|
||||
|
||||
# Rollback Deployment
|
||||
# Відкат розгортання
|
||||
|
||||
Rollback to previous stable version:
|
||||
Відкат до попередньої стабільної версії:
|
||||
|
||||
1. Identify previous deployment
|
||||
2. Verify rollback target is healthy
|
||||
3. Execute rollback procedure
|
||||
4. Run health checks
|
||||
5. Notify team
|
||||
1. Визначення попереднього розгортання
|
||||
2. Перевірка працездатності цілі відкату
|
||||
3. Виконання процедури відкату
|
||||
4. Запуск перевірок стану
|
||||
5. Повідомлення команди
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
name: System Status
|
||||
description: Check overall system health and status
|
||||
description: Перевірка загального стану та працездатності системи
|
||||
---
|
||||
|
||||
# System Status Check
|
||||
# Перевірка стану системи
|
||||
|
||||
Check system health across all services:
|
||||
Перевірка стану системи по всіх сервісах:
|
||||
|
||||
1. Query Kubernetes pod status
|
||||
2. Check database connections
|
||||
3. Monitor API response times
|
||||
4. Review error rates
|
||||
5. Check resource utilization
|
||||
6. Report overall health
|
||||
1. Запит статусу подів Kubernetes
|
||||
2. Перевірка з'єднань з базою даних
|
||||
3. Моніторинг часу відповіді API
|
||||
4. Перегляд частоти помилок
|
||||
5. Перевірка використання ресурсів
|
||||
6. Звіт про загальний стан
|
||||
|
||||
@@ -3,117 +3,117 @@
|
||||
<img alt="Claude How To" src="../../resources/logos/claude-howto-logo.svg">
|
||||
</picture>
|
||||
|
||||
# Documentation Plugin
|
||||
# Плагін Documentation
|
||||
|
||||
Comprehensive documentation generation and maintenance for your project.
|
||||
Комплексна генерація та підтримка документації для вашого проєкту.
|
||||
|
||||
## Features
|
||||
## Функції
|
||||
|
||||
✅ API documentation generation
|
||||
✅ README creation and updates
|
||||
✅ Documentation synchronization
|
||||
✅ Code comment improvements
|
||||
✅ Example generation
|
||||
✅ Генерація API-документації
|
||||
✅ Створення та оновлення README
|
||||
✅ Синхронізація документації
|
||||
✅ Покращення коментарів коду
|
||||
✅ Генерація прикладів
|
||||
|
||||
## Installation
|
||||
## Встановлення
|
||||
|
||||
```bash
|
||||
/plugin install documentation
|
||||
```
|
||||
|
||||
## What's Included
|
||||
## Що включено
|
||||
|
||||
### Slash Commands
|
||||
- `/generate-api-docs` - Generate API documentation
|
||||
- `/generate-readme` - Create or update README
|
||||
- `/sync-docs` - Sync docs with code changes
|
||||
- `/validate-docs` - Validate documentation
|
||||
### Слеш-команди
|
||||
- `/generate-api-docs` — Генерація API-документації
|
||||
- `/generate-readme` — Створення або оновлення README
|
||||
- `/sync-docs` — Синхронізація документації зі змінами коду
|
||||
- `/validate-docs` — Валідація документації
|
||||
|
||||
### Subagents
|
||||
- `api-documenter` - API documentation specialist
|
||||
- `code-commentator` - Code comment improvements
|
||||
- `example-generator` - Code example creation
|
||||
### Субагенти
|
||||
- `api-documenter` — Спеціаліст з API-документації
|
||||
- `code-commentator` — Покращення коментарів коду
|
||||
- `example-generator` — Створення прикладів коду
|
||||
|
||||
### Templates
|
||||
- `api-endpoint.md` - API endpoint documentation template
|
||||
- `function-docs.md` - Function documentation template
|
||||
- `adr-template.md` - Architecture Decision Record template
|
||||
### Шаблони
|
||||
- `api-endpoint.md` — Шаблон документації ендпоінту API
|
||||
- `function-docs.md` — Шаблон документації функції
|
||||
- `adr-template.md` — Шаблон Architecture Decision Record
|
||||
|
||||
### MCP Servers
|
||||
- GitHub integration for documentation syncing
|
||||
### MCP-сервери
|
||||
- Інтеграція з GitHub для синхронізації документації
|
||||
|
||||
## Usage
|
||||
## Використання
|
||||
|
||||
### Generate API Documentation
|
||||
### Генерація API-документації
|
||||
```
|
||||
/generate-api-docs
|
||||
```
|
||||
|
||||
### Create README
|
||||
### Створення README
|
||||
```
|
||||
/generate-readme
|
||||
```
|
||||
|
||||
### Sync Documentation
|
||||
### Синхронізація документації
|
||||
```
|
||||
/sync-docs
|
||||
```
|
||||
|
||||
### Validate Documentation
|
||||
### Валідація документації
|
||||
```
|
||||
/validate-docs
|
||||
```
|
||||
|
||||
## Requirements
|
||||
## Вимоги
|
||||
|
||||
- Claude Code 1.0+
|
||||
- GitHub access (optional)
|
||||
- Доступ до GitHub (опціонально)
|
||||
|
||||
## Example Workflow
|
||||
## Приклад робочого процесу
|
||||
|
||||
```
|
||||
User: /generate-api-docs
|
||||
|
||||
Claude:
|
||||
1. Scans all API endpoints in /src/api/
|
||||
2. Delegates to api-documenter subagent
|
||||
3. Extracts function signatures and JSDoc
|
||||
4. Organizes by module/endpoint
|
||||
5. Uses api-endpoint.md template
|
||||
6. Generates comprehensive markdown docs
|
||||
7. Includes curl, JavaScript, and Python examples
|
||||
1. Сканує всі API-ендпоінти в /src/api/
|
||||
2. Делегує субагенту api-documenter
|
||||
3. Витягує сигнатури функцій та JSDoc
|
||||
4. Організує за модулями/ендпоінтами
|
||||
5. Використовує шаблон api-endpoint.md
|
||||
6. Генерує комплексну markdown-документацію
|
||||
7. Включає приклади curl, JavaScript та Python
|
||||
|
||||
Result:
|
||||
✅ API documentation generated
|
||||
📄 Files created:
|
||||
Результат:
|
||||
✅ API-документація згенерована
|
||||
📄 Створені файли:
|
||||
- docs/api/users.md
|
||||
- docs/api/auth.md
|
||||
- docs/api/products.md
|
||||
📊 Coverage: 23/23 endpoints documented
|
||||
📊 Покриття: 23/23 ендпоінти задокументовано
|
||||
```
|
||||
|
||||
## Templates Usage
|
||||
## Використання шаблонів
|
||||
|
||||
### API Endpoint Template
|
||||
Use for documenting REST API endpoints with full examples.
|
||||
### Шаблон ендпоінту API
|
||||
Використовуйте для документування REST API ендпоінтів з повними прикладами.
|
||||
|
||||
### Function Documentation Template
|
||||
Use for documenting individual functions/methods.
|
||||
### Шаблон документації функції
|
||||
Використовуйте для документування окремих функцій/методів.
|
||||
|
||||
### ADR Template
|
||||
Use for documenting architectural decisions.
|
||||
### Шаблон ADR
|
||||
Використовуйте для документування архітектурних рішень.
|
||||
|
||||
## Configuration
|
||||
## Конфігурація
|
||||
|
||||
Set up GitHub token for documentation syncing:
|
||||
Налаштуйте GitHub-токен для синхронізації документації:
|
||||
```bash
|
||||
export GITHUB_TOKEN="your_github_token"
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
## Найкращі практики
|
||||
|
||||
- Keep documentation close to code
|
||||
- Update docs with code changes
|
||||
- Include practical examples
|
||||
- Validate regularly
|
||||
- Use templates for consistency
|
||||
- Тримайте документацію близько до коду
|
||||
- Оновлюйте документацію разом зі змінами коду
|
||||
- Включайте практичні приклади
|
||||
- Регулярно валідуйте
|
||||
- Використовуйте шаблони для консистентності
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: api-documenter
|
||||
description: API documentation specialist
|
||||
description: Спеціаліст з API-документації
|
||||
tools: read, write, grep
|
||||
---
|
||||
|
||||
# API Documenter
|
||||
# API-документатор
|
||||
|
||||
Creates comprehensive API documentation:
|
||||
- Endpoint documentation
|
||||
- Parameter descriptions
|
||||
- Response schemas
|
||||
- Code examples (curl, JS, Python)
|
||||
- Error codes
|
||||
Створює комплексну API-документацію:
|
||||
- Документація ендпоінтів
|
||||
- Описи параметрів
|
||||
- Схеми відповідей
|
||||
- Приклади коду (curl, JS, Python)
|
||||
- Коди помилок
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: code-commentator
|
||||
description: Code comment and inline documentation specialist
|
||||
description: Спеціаліст з коментарів коду та інлайн-документації
|
||||
tools: read, write, edit
|
||||
---
|
||||
|
||||
# Code Commentator
|
||||
# Коментатор коду
|
||||
|
||||
Improves code documentation:
|
||||
- JSDoc/docstring comments
|
||||
- Inline explanations
|
||||
- Parameter descriptions
|
||||
- Return type documentation
|
||||
- Usage examples
|
||||
Покращує документацію коду:
|
||||
- JSDoc/docstring коментарі
|
||||
- Інлайн-пояснення
|
||||
- Описи параметрів
|
||||
- Документація типів повернення
|
||||
- Приклади використання
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: example-generator
|
||||
description: Code example and tutorial specialist
|
||||
description: Спеціаліст з прикладів коду та туторіалів
|
||||
tools: read, write
|
||||
---
|
||||
|
||||
# Example Generator
|
||||
# Генератор прикладів
|
||||
|
||||
Creates practical code examples:
|
||||
- Getting started guides
|
||||
- Common use cases
|
||||
- Integration examples
|
||||
- Best practices
|
||||
- Troubleshooting scenarios
|
||||
Створює практичні приклади коду:
|
||||
- Гайди початку роботи
|
||||
- Поширені сценарії використання
|
||||
- Приклади інтеграції
|
||||
- Найкращі практики
|
||||
- Сценарії усунення проблем
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
name: Generate API Documentation
|
||||
description: Generate comprehensive API documentation from source code
|
||||
description: Генерація комплексної API-документації з вихідного коду
|
||||
---
|
||||
|
||||
# API Documentation Generator
|
||||
# Генератор API-документації
|
||||
|
||||
Generate complete API documentation:
|
||||
Генерація повної API-документації:
|
||||
|
||||
1. Scan API endpoints
|
||||
2. Extract function signatures and JSDoc
|
||||
3. Organize by module/endpoint
|
||||
4. Create markdown with examples
|
||||
5. Include request/response schemas
|
||||
6. Add error documentation
|
||||
1. Сканування API-ендпоінтів
|
||||
2. Витягування сигнатур функцій та JSDoc
|
||||
3. Організація за модулями/ендпоінтами
|
||||
4. Створення markdown з прикладами
|
||||
5. Включення схем запитів/відповідей
|
||||
6. Додавання документації помилок
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
name: Generate README
|
||||
description: Create or update project README
|
||||
description: Створення або оновлення README проєкту
|
||||
---
|
||||
|
||||
# README Generator
|
||||
# Генератор README
|
||||
|
||||
Generate comprehensive README:
|
||||
Генерація комплексного README:
|
||||
|
||||
1. Project overview and description
|
||||
2. Installation instructions
|
||||
3. Usage examples
|
||||
4. API documentation links
|
||||
5. Contributing guidelines
|
||||
6. License information
|
||||
1. Огляд та опис проєкту
|
||||
2. Інструкції з встановлення
|
||||
3. Приклади використання
|
||||
4. Посилання на API-документацію
|
||||
5. Настанови для контриб'юторів
|
||||
6. Інформація про ліцензію
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: Sync Documentation
|
||||
description: Sync documentation with code changes
|
||||
description: Синхронізація документації зі змінами коду
|
||||
---
|
||||
|
||||
# Documentation Sync
|
||||
# Синхронізація документації
|
||||
|
||||
Synchronize documentation with codebase:
|
||||
Синхронізація документації з кодовою базою:
|
||||
|
||||
1. Detect code changes
|
||||
2. Identify outdated documentation
|
||||
3. Update affected docs
|
||||
4. Verify examples still work
|
||||
5. Update version numbers
|
||||
1. Виявлення змін коду
|
||||
2. Визначення застарілої документації
|
||||
3. Оновлення уражених документів
|
||||
4. Перевірка працездатності прикладів
|
||||
5. Оновлення номерів версій
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
name: Validate Documentation
|
||||
description: Validate documentation for completeness and accuracy
|
||||
description: Валідація документації на повноту та точність
|
||||
---
|
||||
|
||||
# Documentation Validation
|
||||
# Валідація документації
|
||||
|
||||
Validate documentation quality:
|
||||
Перевірка якості документації:
|
||||
|
||||
1. Check for broken links
|
||||
2. Verify code examples
|
||||
3. Ensure completeness
|
||||
4. Check formatting
|
||||
5. Validate against actual code
|
||||
1. Перевірка на зламані посилання
|
||||
2. Верифікація прикладів коду
|
||||
3. Забезпечення повноти
|
||||
4. Перевірка форматування
|
||||
5. Валідація відповідності реальному коду
|
||||
|
||||
Reference in New Issue
Block a user