feat: Gitea 项目治理工具箱（工单/标签/里程碑/人员/看板）

- gitea_ops.py: API CLI（组织/成员/工单/标签/里程碑/仓库），纯标准库
- board_ops.py: 看板网页 CLI（Playwright），处理 Gitea 1.26 看板无 API 限制
- SKILL.md: QwenPaw skill 文档（命令手册 + 血泪教训 + 失败模式）
- README.md: 项目说明

README.md

@@ -1,3 +1,34 @@
-# GiteaProjectOps
+# GiteaProjectOps — Gitea 项目治理自动化工具箱
 
-Gitea 项目治理自动化：工单/标签/里程碑/人员/看板操作脚本与 Skill（gitea_ops.py API + board_ops.py 网页看板）
+对 Gitea 组织/仓库做项目治理操作的完整工具箱：**工单（issue）、标签（label）、里程碑（milestone）、人员（组织成员）、组织/仓库信息、看板（project board）**。
+
+## 组件
+
+| 文件 | 说明 |
+|---|---|
+| `SKILL.md` | QwenPaw 可复用 Skill（`/gitea-project-manage`），含完整命令手册与踩坑记录 |
+| `scripts/gitea_ops.py` | API CLI：工单/标签/里程碑/成员/组织/仓库（Python 标准库，零依赖） |
+| `scripts/board_ops.py` | 看板网页 CLI：新建/改名/删除看板、列管理、工单进看板、卡片拖拽（Playwright） |
+
+## 为什么拆两个脚本
+
+Gitea 1.26 的看板（Projects）**没有 REST API**（swagger 300 个端点无 project 相关），
+工单/标签/里程碑有 API，但看板必须走浏览器 DOM 操作。详见 `SKILL.md`。
+
+## 快速开始
+
+```bash
+# API 操作（token 默认读 /app/working.secret/gitea_token）
+python3 scripts/gitea_ops.py org members
+python3 scripts/gitea_ops.py issue list PineSoundServer --state open
+
+# 看板操作（需 playwright + Gitea 账号）
+pip install playwright && playwright install chromium
+GITEA_USER=<用户名> GITEA_PASS=<密码> python3 scripts/board_ops.py boards PineSoundServer
+```
+
+## 环境
+
+- Gitea：内网 `http://192.168.1.3:10082`（API 前缀 `/api/v1`）· 外网 `code.infoepoch.cn`
+- 组织：`PineSound`
+- 详见 `SKILL.md` 的环境与凭据章节。