Back to Details

infrastructure-skill-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Infrastructure Skill Builder

基础设施技能构建工具

Convert your infrastructure documentation into powerful, reusable Claude Code skills.
将你的基础设施文档转化为强大、可复用的Claude Code技能。

Overview

概述

Infrastructure knowledge is often scattered across:
  • README files
  • Runbooks and wiki pages
  • Configuration files
  • Troubleshooting guides
  • Team Slack/Discord history
  • Mental models of senior engineers
This skill helps you systematically capture that knowledge as Claude Code skills for:
  • Faster onboarding
  • Consistent operations
  • Disaster recovery
  • Knowledge preservation
  • Team scaling
基础设施知识通常分散在以下地方：
  • README文件
  • 运行手册和维基页面
  • 配置文件
  • 故障排查指南
  • 团队Slack/Discord聊天记录
  • 资深工程师的经验模型
本技能可帮助你将这些知识系统地整理为Claude Code技能，用于：
  • 更快的新员工入职
  • 标准化运维操作
  • 灾难恢复
  • 知识留存
  • 团队规模扩张

When to Use

适用场景

Use this skill when:
  • Documenting complex infrastructure setups
  • Creating runbooks for operations teams
  • Onboarding new team members to infrastructure
  • Preserving expert knowledge before team changes
  • Standardizing infrastructure operations
  • Building organizational infrastructure library
  • Migrating from manual to automated operations
在以下场景中使用本技能：
  • 记录复杂基础设施部署
  • 为运维团队创建运行手册
  • 向新成员介绍基础设施
  • 团队变动前留存专家知识
  • 标准化基础设施运维
  • 构建组织级基础设施库
  • 从手动操作向自动化操作迁移

Skill Extraction Process

技能提取流程

Step 1: Identify Infrastructure Domains

步骤1：识别基础设施领域

Common domains:
  • Container Orchestration: Docker, Kubernetes, Proxmox LXC
  • Cloud Platforms: AWS, GCP, Azure, DigitalOcean
  • Databases: PostgreSQL, MongoDB, Redis, MySQL
  • Web Servers: Nginx, Apache, Caddy, Traefik
  • Monitoring: Prometheus, Grafana, ELK Stack
  • CI/CD: Jenkins, GitLab CI, GitHub Actions
  • Networking: VPNs, Load Balancers, DNS, Firewalls
  • Storage: S3, MinIO, NFS, Ceph
  • Security: Authentication, SSL/TLS, Firewalls
常见领域：
  • 容器编排：Docker、Kubernetes、Proxmox LXC
  • 云平台：AWS、GCP、Azure、DigitalOcean
  • 数据库：PostgreSQL、MongoDB、Redis、MySQL
  • Web服务器：Nginx、Apache、Caddy、Traefik
  • 监控：Prometheus、Grafana、ELK Stack
  • CI/CD：Jenkins、GitLab CI、GitHub Actions
  • 网络：VPN、负载均衡器、DNS、防火墙
  • 存储：S3、MinIO、NFS、Ceph
  • 安全：身份认证、SSL/TLS、防火墙

Step 2: Extract Core Operations

步骤2：提取核心操作

For each domain, document:
  1. Setup/Provisioning: How to create new instances
  2. Configuration: How to configure for different use cases
  3. Operations: Day-to-day management tasks
  4. Troubleshooting: Common issues and resolutions
  5. Scaling: How to scale up/down
  6. Backup/Recovery: Disaster recovery procedures
  7. Monitoring: Health checks and alerts
  8. Security: Security best practices
针对每个领域，记录以下内容：
  1. 部署/配置：如何创建新实例
  2. 参数配置：如何针对不同场景进行配置
  3. 日常运维：日常管理任务
  4. 故障排查：常见问题及解决方案
  5. 资源扩容：如何进行水平/垂直扩容
  6. 备份/恢复：灾难恢复流程
  7. 监控：健康检查与告警
  8. 安全：安全最佳实践

Infrastructure Skill Template

基础设施技能模板

markdown
---
name: [infrastructure-component]-manager
description: Expert guidance for [component] management, provisioning, troubleshooting, and operations
license: MIT
tags: [infrastructure, [component], operations, troubleshooting]
---
markdown
---
name: [infrastructure-component]-manager
description: Expert guidance for [component] management, provisioning, troubleshooting, and operations
license: MIT
tags: [infrastructure, [component], operations, troubleshooting]
---

[Component] Manager

[Component] Manager

Expert knowledge for managing [component] infrastructure.
Expert knowledge for managing [component] infrastructure.

Authentication & Access

Authentication & Access

Access Methods

Access Methods

bash
undefined
bash
undefined

How to access the infrastructure component

How to access the infrastructure component

ssh user@host
ssh user@host

or

or

kubectl config use-context cluster-name
undefined
kubectl config use-context cluster-name
undefined

Credentials & Configuration

Credentials & Configuration

  • Where credentials are stored
  • How to configure access
  • Common authentication issues
  • Where credentials are stored
  • How to configure access
  • Common authentication issues

Architecture Overview

Architecture Overview

Component Topology

Component Topology

  • How components are organized
  • Network topology
  • Resource allocation
  • Redundancy setup
  • How components are organized
  • Network topology
  • Resource allocation
  • Redundancy setup

Key Resources

Key Resources

  • Resource 1: Purpose and specs
  • Resource 2: Purpose and specs
  • Resource 3: Purpose and specs
  • Resource 1: Purpose and specs
  • Resource 2: Purpose and specs
  • Resource 3: Purpose and specs

Common Operations

Common Operations

Operation 1: [e.g., Create New Instance]

Operation 1: [e.g., Create New Instance]

bash
undefined
bash
undefined

Step-by-step commands

Step-by-step commands

command1 --flags command2 --flags
command1 --flags command2 --flags

Verification

Verification

verify-command
undefined
verify-command
undefined

Operation 2: [e.g., Update Configuration]

Operation 2: [e.g., Update Configuration]

bash
undefined
bash
undefined

Commands and explanations

Commands and explanations

undefined
undefined

Operation 3: [e.g., Scale Resources]

Operation 3: [e.g., Scale Resources]

bash
undefined
bash
undefined

Commands and explanations

Commands and explanations

undefined
undefined

Monitoring & Health Checks

Monitoring & Health Checks

Check System Status

Check System Status

bash
undefined
bash
undefined

Health check commands

Health check commands

status-command
status-command

Expected output

Expected output

What healthy output looks like

What healthy output looks like

undefined
undefined

Common Metrics

Common Metrics

  • Metric 1: What it means, normal range
  • Metric 2: What it means, normal range
  • Metric 3: What it means, normal range
  • Metric 1: What it means, normal range
  • Metric 2: What it means, normal range
  • Metric 3: What it means, normal range

Troubleshooting

Troubleshooting

Issue 1: [Common Problem]

Issue 1: [Common Problem]

Symptoms: What you observe Cause: Why it happens Fix: Step-by-step resolution
bash
undefined
Symptoms: What you observe Cause: Why it happens Fix: Step-by-step resolution
bash
undefined

Fix commands

Fix commands

undefined
undefined

Issue 2: [Another Problem]

Issue 2: [Another Problem]

Symptoms: Cause: Fix:
bash
undefined
Symptoms: Cause: Fix:
bash
undefined

Fix commands

Fix commands

undefined
undefined

Backup & Recovery

Backup & Recovery

Backup Procedures

Backup Procedures

bash
undefined
bash
undefined

How to backup

How to backup

backup-command
backup-command

Verification

Verification

verify-backup
undefined
verify-backup
undefined

Recovery Procedures

Recovery Procedures

bash
undefined
bash
undefined

How to restore

How to restore

restore-command
restore-command

Verification

Verification

verify-restore
undefined
verify-restore
undefined

Security Best Practices

Security Best Practices

  • Security practice 1
  • Security practice 2
  • Security practice 3
  • Security practice 1
  • Security practice 2
  • Security practice 3

Quick Reference

Quick Reference

TaskCommand
Task 1
command1
Task 2
command2
Task 3
command3
TaskCommand
Task 1
command1
Task 2
command2
Task 3
command3

Additional Resources

Additional Resources

  • Official documentation links
  • Related skills
  • External references
undefined
  • Official documentation links
  • Related skills
  • External references
undefined

Real-World Example: Proxmox Skill

真实案例：Proxmox技能

Based on the proxmox-auth skill in this repository:
基于本仓库中的proxmox-auth技能：

Extracted Knowledge

提取的知识

From: Proxmox VE cluster documentation + operational experience
Structured as:
  1. Authentication: SSH access patterns, node IPs
  2. Architecture: Cluster topology (2 nodes, resources)
  3. Operations: Container/VM management commands
  4. Troubleshooting: Common errors and fixes
  5. Networking: Bridge configuration, IP management
  6. GPU Passthrough: Special container configurations
Result: Comprehensive skill covering:
  • Quick access to any node
  • Container lifecycle management
  • GPU-accelerated containers
  • Network troubleshooting
  • Backup procedures
  • Common gotchas and solutions
来源：Proxmox VE集群文档 + 运维经验
结构化内容：
  1. 身份认证：SSH访问模式、节点IP
  2. 架构：集群拓扑（2个节点、资源分配）
  3. 运维操作：容器/VM管理命令
  4. 故障排查：常见错误及修复方案
  5. 网络：网桥配置、IP管理
  6. GPU透传：特殊容器配置
成果：全面覆盖以下内容的技能：
  • 快速访问任意节点
  • 容器生命周期管理
  • GPU加速容器
  • 网络故障排查
  • 备份流程
  • 常见问题与解决方案

Extraction Scripts

提取脚本

Extract from Runbooks

从运行手册提取

bash
#!/bin/bash
bash
#!/bin/bash

extract-from-runbook.sh - Convert runbook to skill

extract-from-runbook.sh - Convert runbook to skill

RUNBOOK_FILE="$1" SKILL_NAME="$2"
if [ -z "$RUNBOOK_FILE" ] || [ -z "$SKILL_NAME" ]; then echo "Usage: $0 <runbook.md> <skill-name>" exit 1 fi
SKILL_DIR="skills/$SKILL_NAME" mkdir -p "$SKILL_DIR"
RUNBOOK_FILE="$1" SKILL_NAME="$2"
if [ -z "$RUNBOOK_FILE" ] || [ -z "$SKILL_NAME" ]; then echo "Usage: $0 <runbook.md> <skill-name>" exit 1 fi
SKILL_DIR="skills/$SKILL_NAME" mkdir -p "$SKILL_DIR"

Extract sections from runbook

Extract sections from runbook

cat > "$SKILL_DIR/SKILL.md" << EOF

name: $SKILL_NAME description: $(head -5 "$RUNBOOK_FILE" | grep -v "^#" | head -1 | xargs) license: MIT extracted-from: $RUNBOOK_FILE

cat > "$SKILL_DIR/SKILL.md" << EOF

name: $SKILL_NAME description: $(head -5 "$RUNBOOK_FILE" | grep -v "^#" | head -1 | xargs) license: MIT extracted-from: $RUNBOOK_FILE

${SKILL_NAME^}

${SKILL_NAME^}

$(cat "$RUNBOOK_FILE")
Note: This skill was auto-extracted from runbook documentation. Review and refine before use. EOF
echo "✓ Created skill: $SKILL_DIR/SKILL.md" echo "Review and edit to add:" echo " - Metadata and tags" echo " - Troubleshooting section" echo " - Quick reference" echo " - Examples"
undefined
$(cat "$RUNBOOK_FILE")
Note: This skill was auto-extracted from runbook documentation. Review and refine before use. EOF
echo "✓ Created skill: $SKILL_DIR/SKILL.md" echo "Review and edit to add:" echo " - Metadata and tags" echo " - Troubleshooting section" echo " - Quick reference" echo " - Examples"
undefined

Extract from Docker Compose

从Docker Compose提取

bash
#!/bin/bash
bash
#!/bin/bash

docker-compose-to-skill.sh - Extract skill from docker-compose.yaml

docker-compose-to-skill.sh - Extract skill from docker-compose.yaml

COMPOSE_FILE="${1:-docker-compose.yaml}" PROJECT_NAME=$(basename $(pwd))
SKILL_DIR="skills/docker-$PROJECT_NAME" mkdir -p "$SKILL_DIR"
COMPOSE_FILE="${1:-docker-compose.yaml}" PROJECT_NAME=$(basename $(pwd))
SKILL_DIR="skills/docker-$PROJECT_NAME" mkdir -p "$SKILL_DIR"

Extract services

Extract services

SERVICES=$(yq eval '.services | keys | .[]' "$COMPOSE_FILE")

cat > "$SKILL_DIR/SKILL.md" << EOF

name: docker-$PROJECT_NAME description: Docker Compose configuration and management for $PROJECT_NAME license: MIT

SERVICES=$(yq eval '.services | keys | .[]' "$COMPOSE_FILE")

cat > "$SKILL_DIR/SKILL.md" << EOF

name: docker-$PROJECT_NAME description: Docker Compose configuration and management for $PROJECT_NAME license: MIT

Docker $PROJECT_NAME

Docker $PROJECT_NAME

Manage Docker Compose stack for $PROJECT_NAME.
Manage Docker Compose stack for $PROJECT_NAME.

Services

Services

$(yq eval '.services | to_entries | .[] | "### " + .key + "\n" + (.value.image // "custom") + "\n"' "$COMPOSE_FILE")
$(yq eval '.services | to_entries | .[] | "### " + .key + "\n" + (.value.image // "custom") + "\n"' "$COMPOSE_FILE")

Quick Start

Quick Start

```bash
```bash

Start all services

Start all services

docker-compose up -d
docker-compose up -d

Check status

Check status

docker-compose ps
docker-compose ps

View logs

View logs

docker-compose logs -f
docker-compose logs -f

Stop all services

Stop all services

docker-compose down ```
docker-compose down ```

Service Details

Service Details

Ports

Ports

$(yq eval '.services | to_entries | .[] | select(.value.ports) | "- " + .key + ": " + (.value.ports | join(", "))' "$COMPOSE_FILE")
$(yq eval '.services | to_entries | .[] | select(.value.ports) | "- " + .key + ": " + (.value.ports | join(", "))' "$COMPOSE_FILE")

Volumes

Volumes

$(yq eval '.services | to_entries | .[] | select(.value.volumes) | "- " + .key + ": " + (.value.volumes | join(", "))' "$COMPOSE_FILE")
$(yq eval '.services | to_entries | .[] | select(.value.volumes) | "- " + .key + ": " + (.value.volumes | join(", "))' "$COMPOSE_FILE")

Configuration

Configuration

See `$COMPOSE_FILE` for full configuration.
See `$COMPOSE_FILE` for full configuration.

Common Operations

Common Operations

Restart Service

Restart Service

```bash docker-compose restart SERVICE_NAME ```
```bash docker-compose restart SERVICE_NAME ```

Update Service

Update Service

```bash docker-compose pull SERVICE_NAME docker-compose up -d SERVICE_NAME ```
```bash docker-compose pull SERVICE_NAME docker-compose up -d SERVICE_NAME ```

View Service Logs

View Service Logs

```bash docker-compose logs -f SERVICE_NAME ```
```bash docker-compose logs -f SERVICE_NAME ```

Troubleshooting

Troubleshooting

Service Won't Start

Service Won't Start

  1. Check logs: `docker-compose logs SERVICE_NAME`
  2. Verify ports not in use: `netstat -tulpn | grep PORT`
  3. Check disk space: `df -h`
  1. Check logs: `docker-compose logs SERVICE_NAME`
  2. Verify ports not in use: `netstat -tulpn | grep PORT`
  3. Check disk space: `df -h`

Network Issues

Network Issues

```bash
```bash

Recreate network

Recreate network

docker-compose down docker network prune docker-compose up -d ``` EOF
echo "✓ Created skill from docker-compose.yaml"
undefined
docker-compose down docker network prune docker-compose up -d ``` EOF
echo "✓ Created skill from docker-compose.yaml"
undefined

Extract from Kubernetes Manifests

从Kubernetes清单提取

bash
#!/bin/bash
bash
#!/bin/bash

k8s-to-skill.sh - Extract skill from Kubernetes manifests

k8s-to-skill.sh - Extract skill from Kubernetes manifests

K8S_DIR="${1:-.}" APP_NAME="${2:-$(basename $(pwd))}"
SKILL_DIR="skills/k8s-$APP_NAME" mkdir -p "$SKILL_DIR"

cat > "$SKILL_DIR/SKILL.md" << EOF

name: k8s-$APP_NAME description: Kubernetes deployment and management for $APP_NAME license: MIT

K8S_DIR="${1:-.}" APP_NAME="${2:-$(basename $(pwd))}"
SKILL_DIR="skills/k8s-$APP_NAME" mkdir -p "$SKILL_DIR"

cat > "$SKILL_DIR/SKILL.md" << EOF

name: k8s-$APP_NAME description: Kubernetes deployment and management for $APP_NAME license: MIT

Kubernetes $APP_NAME

Kubernetes $APP_NAME

Manage Kubernetes resources for $APP_NAME.
Manage Kubernetes resources for $APP_NAME.

Resources

Resources

$(find "$K8S_DIR" -name ".yaml" -o -name ".yml" | while read file; do KIND=$(yq eval '.kind' "$file" 2>/dev/null) NAME=$(yq eval '.metadata.name' "$file" 2>/dev/null) echo "- $KIND: $NAME ($(basename $file))" done)
$(find "$K8S_DIR" -name ".yaml" -o -name ".yml" | while read file; do KIND=$(yq eval '.kind' "$file" 2>/dev/null) NAME=$(yq eval '.metadata.name' "$file" 2>/dev/null) echo "- $KIND: $NAME ($(basename $file))" done)

Deployment

Deployment

Apply All Resources

Apply All Resources

```bash kubectl apply -f $K8S_DIR/ ```
```bash kubectl apply -f $K8S_DIR/ ```

Check Status

Check Status

```bash
```bash

Pods

Pods

kubectl get pods -l app=$APP_NAME
kubectl get pods -l app=$APP_NAME

Services

Services

kubectl get svc -l app=$APP_NAME
kubectl get svc -l app=$APP_NAME

Deployments

Deployments

kubectl get deploy -l app=$APP_NAME ```
kubectl get deploy -l app=$APP_NAME ```

Common Operations

Common Operations

Scale Deployment

Scale Deployment

```bash kubectl scale deployment $APP_NAME --replicas=3 ```
```bash kubectl scale deployment $APP_NAME --replicas=3 ```

Update Image

Update Image

```bash kubectl set image deployment/$APP_NAME container=new-image:tag ```
```bash kubectl set image deployment/$APP_NAME container=new-image:tag ```

View Logs

View Logs

```bash kubectl logs -f deployment/$APP_NAME ```
```bash kubectl logs -f deployment/$APP_NAME ```

Port Forward

Port Forward

```bash kubectl port-forward svc/$APP_NAME 8080:80 ```
```bash kubectl port-forward svc/$APP_NAME 8080:80 ```

Troubleshooting

Troubleshooting

Pod Not Starting

Pod Not Starting

```bash
```bash

Check pod events

Check pod events

kubectl describe pod POD_NAME
kubectl describe pod POD_NAME

Check logs

Check logs

kubectl logs POD_NAME
kubectl logs POD_NAME

Previous instance logs

Previous instance logs

kubectl logs POD_NAME --previous ```
kubectl logs POD_NAME --previous ```

Service Not Reachable

Service Not Reachable

```bash
```bash

Check endpoints

Check endpoints

kubectl get endpoints $APP_NAME
kubectl get endpoints $APP_NAME

Check service

Check service

kubectl describe svc $APP_NAME
kubectl describe svc $APP_NAME

Test from another pod

Test from another pod

kubectl run -it --rm debug --image=busybox --restart=Never -- wget -O- http://$APP_NAME ```
kubectl run -it --rm debug --image=busybox --restart=Never -- wget -O- http://$APP_NAME ```

Quick Reference

Quick Reference

TaskCommand
Apply`kubectl apply -f $K8S_DIR/`
Status`kubectl get all -l app=$APP_NAME`
Logs`kubectl logs -f deployment/$APP_NAME`
Scale`kubectl scale deployment $APP_NAME --replicas=N`
Delete`kubectl delete -f $K8S_DIR/`
EOF
echo "✓ Created Kubernetes skill"
undefined
TaskCommand
Apply`kubectl apply -f $K8S_DIR/`
Status`kubectl get all -l app=$APP_NAME`
Logs`kubectl logs -f deployment/$APP_NAME`
Scale`kubectl scale deployment $APP_NAME --replicas=N`
Delete`kubectl delete -f $K8S_DIR/`
EOF
echo "✓ Created Kubernetes skill"
undefined

Infrastructure Patterns to Capture

需捕获的基础设施模式

Pattern 1: SSH Access Matrix

模式1：SSH访问矩阵

markdown
undefined
markdown
undefined

SSH Access

SSH访问

HostIPPurposeAccess
node1192.168.1.10Primary
ssh node1
node2192.168.1.11Secondary
ssh node2
bastion203.0.113.5Jump host
ssh -J bastion node1
undefined
主机IP用途访问方式
node1192.168.1.10主节点
ssh node1
node2192.168.1.11从节点
ssh node2
bastion203.0.113.5跳转主机
ssh -J bastion node1
undefined

Pattern 2: Service Port Mapping

模式2：服务端口映射

markdown
undefined
markdown
undefined

Service Ports

服务端口

ServiceInternalExternalProtocol
Web808080HTTP
API3000443HTTPS
DB5432-TCP
undefined
服务内部端口外部端口协议
Web808080HTTP
API3000443HTTPS
DB5432-TCP
undefined

Pattern 3: Configuration Files

模式3：配置文件

markdown
undefined
markdown
undefined

Configuration Locations

配置文件位置

Application Config

应用配置

  • Path: 
    /etc/app/config.yaml
  • Format: YAML
  • Requires restart: Yes
  • 路径: 
    /etc/app/config.yaml
  • 格式: YAML
  • 需要重启: 是

Database Config

数据库配置

  • Path: 
    /var/lib/postgres/postgresql.conf
  • Format: INI
  • Requires restart: Yes
undefined
  • 路径: 
    /var/lib/postgres/postgresql.conf
  • 格式: INI
  • 需要重启: 是
undefined

Pattern 4: Command Workflows

模式4：命令工作流

markdown
undefined
markdown
undefined

Deployment Workflow

部署工作流

  1. Backup current state
    bash
    ./backup.sh
  2. Pull latest code
    bash
    git pull origin main
  3. Build application
    bash
    docker build -t app:latest .
  4. Deploy
    bash
    docker-compose up -d
  5. Verify
    bash
    curl http://localhost/health
undefined
  1. 备份当前状态
    bash
    ./backup.sh
  2. 拉取最新代码
    bash
    git pull origin main
  3. 构建应用
    bash
    docker build -t app:latest .
  4. 部署
    bash
    docker-compose up -d
  5. 验证
    bash
    curl http://localhost/health
undefined

Best Practices

最佳实践

✅ DO

✅ 推荐做法

  1. Document assumptions - What's required before operations
  2. Include verification - How to verify each operation succeeded
  3. Add troubleshooting - Common issues and fixes
  4. Show outputs - Expected command outputs
  5. Link resources - Related documentation and skills
  6. Version information - Software versions, configurations
  7. Security notes - Security implications of operations
  8. Update regularly - Keep skills current with infrastructure
  1. 记录假设前提 - 操作前的必要条件
  2. 包含验证步骤 - 如何验证每个操作成功
  3. 添加故障排查内容 - 常见问题及修复方案
  4. 展示预期输出 - 命令的正常输出示例
  5. 关联资源链接 - 相关文档和技能
  6. 版本信息 - 软件版本、配置详情
  7. 安全说明 - 操作的安全影响
  8. 定期更新 - 保持技能与基础设施同步

❌ DON'T

❌ 避免做法

  1. Don't hardcode secrets - Use placeholders or env vars
  2. Don't skip context - Explain why, not just how
  3. Don't assume knowledge - Explain terminology
  4. Don't omit edge cases - Document special scenarios
  5. Don't forget cleanup - Include teardown procedures
  6. Don't ignore dependencies - Document prerequisites
  7. Don't skip testing - Verify all commands work
  8. Don't leave TODO - Complete all sections
  1. 不要硬编码密钥 - 使用占位符或环境变量
  2. 不要跳过上下文说明 - 不仅说明怎么做，还要说明为什么
  3. 不要假设用户已有相关知识 - 解释专业术语
  4. 不要忽略边缘场景 - 记录特殊情况
  5. 不要忘记清理步骤 - 包含销毁流程
  6. 不要忽略依赖关系 - 记录前置条件
  7. 不要跳过测试 - 验证所有命令可用
  8. 不要遗留TODO项 - 完成所有章节

Quality Checklist

质量检查清单

  • Clear component description
  • Authentication/access documented
  • Architecture overview provided
  • Common operations with examples
  • Troubleshooting section complete
  • Health checks documented
  • Backup/recovery procedures
  • Security considerations noted
  • Quick reference table
  • All commands tested
  • No hardcoded secrets
  • Links to resources
  • 清晰的组件描述
  • 已记录身份认证/访问方式
  • 提供架构概述
  • 包含带示例的常见操作
  • 完整的故障排查章节
  • 已记录健康检查方法
  • 备份/恢复流程
  • 已标注安全注意事项
  • 快速参考表格
  • 所有命令已测试
  • 无硬编码密钥
  • 资源链接

Quick Start Workflow

快速开始工作流

bash
undefined
bash
undefined

1. Identify infrastructure component

1. 确定基础设施组件

COMPONENT="nginx-reverse-proxy"
COMPONENT="nginx-reverse-proxy"

2. Gather documentation

2. 收集文档

- Collect README files

- 收集README文件

- Export wiki pages

导出维基页面

- Capture team knowledge

- 记录团队经验

- Document current setup

- 记录当前部署

3. Create skill structure

3. 创建技能目录结构

mkdir -p skills/$COMPONENT
mkdir -p skills/$COMPONENT

4. Fill in template

4. 填充模板

Use the Infrastructure Skill Template above

使用上方的基础设施技能模板

5. Test all commands

5. 测试所有命令

Verify every command in skill works

验证技能中的每个命令都能正常运行

6. Review and refine

6. 审核与优化

Have team review for completeness

请团队审核内容完整性

7. Commit to repository

7. 提交到仓库

git add skills/$COMPONENT git commit -m "docs: Add $COMPONENT infrastructure skill"

---

**Version**: 1.0.0
**Author**: Harvested from proxmox-auth skill pattern
**Last Updated**: 2025-11-18
**License**: MIT
**Key Principle**: Convert tribal knowledge into structured, searchable, actionable skills.
git add skills/$COMPONENT git commit -m "docs: Add $COMPONENT infrastructure skill"

---

**版本**: 1.0.0
**作者**: 基于proxmox-auth技能模式整理
**最后更新**: 2025-11-18
**许可证**: MIT
**核心原则**: 将隐性知识转化为结构化、可搜索、可执行的技能。

Examples in This Repository

仓库中的示例

  • proxmox-auth: Proxmox VE cluster management
  • docker-*: Docker-based infrastructure
  • cloudflare-*: Cloudflare infrastructure services
Transform your infrastructure documentation into skills today! 🏗️
  • proxmox-auth: Proxmox VE集群管理
  • docker-*: 基于Docker的基础设施
  • cloudflare-*: Cloudflare基础设施服务
立即将你的基础设施文档转化为技能吧！🏗️