feat: publish gitea issue devops skill with docs and workflow templates

README.md

@@ -1,3 +1,55 @@
-# devops-skills
+# DevOps Skills
 
-Devops驱动开发场景投喂工具
+面向 **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`
+
+用于实现“分配槽位 + 按变更范围部署 + 自动回收”。