# DevOps Skills

面向 **Gitea Issue 驱动交付** 的技能仓库，内置 `gitea-issue-devops-agent`，支持：

- 根据 issue 指定分支执行修复与提测
- 分支级预览环境槽位分配与回收
- 按变更范围智能部署（避免无意义重启服务端）
- 自动 / 半自动 / 全人工 三种协作模式
- 图片类 issue 证据抓取与审阅

## 文档网页

- 站点文件：`site/index.html`
- 仓库内查看：`https://fun-md.com/Fun_MD/devops-skills/src/branch/main/site/index.html`
- 原始页面：`https://fun-md.com/Fun_MD/devops-skills/raw/branch/main/site/index.html`

## 技能路径

- `skills/gitea-issue-devops-agent/SKILL.md`

## 安装

```bash
git clone https://fun-md.com/Fun_MD/devops-skills.git
cd devops-skills
mkdir -p ~/.codex/skills
cp -r skills/gitea-issue-devops-agent ~/.codex/skills/
```

Windows PowerShell:

```powershell
git clone https://fun-md.com/Fun_MD/devops-skills.git
cd devops-skills
New-Item -ItemType Directory -Force $HOME\.codex\skills | Out-Null
Copy-Item .\skills\gitea-issue-devops-agent $HOME\.codex\skills\gitea-issue-devops-agent -Recurse -Force
```

## 核心脚本

- `skills/gitea-issue-devops-agent/scripts/issue_audit.py`
  - issue 拉取、质量评分、去重、附件/图片抓取
- `skills/gitea-issue-devops-agent/scripts/change_scope.py`
  - 识别 `skip/client_only/server_only/full_stack/infra_only`
- `skills/gitea-issue-devops-agent/scripts/preview_slot_allocator.py`
  - 分支预览槽位分配、复用、释放、TTL 回收

## 工作流模板

仓库提供 `.gitea/workflows` 示例，可直接接入：

- `.gitea/workflows/issue-branch-preview.yml`
- `.gitea/workflows/preview-slot-reclaim.yml`

用于实现“分配槽位 + 按变更范围部署 + 自动回收”。