Merge pull request '日常操作命令：issues/pulls/labels/milestones/releases/repos/api（#8）' (#16) from feature/issue8-dailyops into main

README.md

@@ -6,7 +6,7 @@ teai 是 Gitea 的命令列（CLI）工具，以更完整、更可靠的方式
 
 - **語言：** Go（與 Gitea 本體一致），僅用標準庫，離線可建置
 - **目標站點：** `https://gitea.alterminal.com`
-- **狀態：** 專案初始化中，功能尚未開始開發；本文的指令集為設計藍圖
+- **狀態：** 基礎建設（#5：internal/gitea）、工作流命令（#6：whoami/orgs/members/mine/pulls/next）與日常操作命令（#8：issues/pulls/labels/milestones/releases/repos/api）已實作；stalled/xrefs（#7）進行中
 - **範圍（#3）：** 不避開 tea 已有的功能；單一工具涵蓋完整操作
 
 ## 安裝與建置
@@ -29,7 +29,38 @@ go build -o teai ./cmd/teai
 3. **機器可讀優先**：預設輸出 JSON；`--output table` 僅供人工抽查。
 4. **可直接替換原型**：`gitea.py` 的每個子命令在 teai 都有語義相同的對應命令，可交叉驗證、平滑遷移。
 5. **認證沿用 tea**：讀 `tea` 的登入組態（`TEA_CONFIG` 或 `~/.config/tea/config.yml`），不另建認證體系。
-6. **安全預設**：本期全部是查詢類（唯讀）；寫入類（留言、指派、審核者）不在本期範圍，未來加入時須明確 `--yes`。
+6. **安全預設**：查詢類唯讀；寫入類命令（#8 起）一律要求明確 `--yes`，未確認時不發出任何請求、不產生任何遠端變更。
+
+### 日常操作（tea 對等指令；#3 不避開 tea 已有功能；#8 已實作）
+
+issues／pulls／labels／milestones／releases／repos／api 的日常操作，自行實作、輸出一致 JSON、共用同一套認證與全域選項。介面語義以 `tea`／Gitea API 為相容參考。已實作：
+
+```sh
+# issues
+teai issues list --repo <owner>/<repo> [--state open|closed|all]
+teai issues view --repo <owner>/<repo> <number> [--comments]
+teai issues create --repo <owner>/<repo> --title … [--body …] [--assignees a,b] --yes
+teai issues close --repo <owner>/<repo> --yes <number>
+teai issues comment --repo <owner>/<repo> --body … --yes <number>
+# pulls（無子命令仍是工作流清單：--mine／--reviewer／--repo）
+teai pulls list --repo <owner>/<repo> [--state open|closed|all]
+teai pulls view --repo <owner>/<repo> <number> [--comments]
+teai pulls create --repo <owner>/<repo> --head <branch> [--base main] --title … [--body …] --yes
+teai pulls merge --repo <owner>/<repo> [--style merge|rebase|rebase-merge|squash] --yes <number>
+teai pulls comment --repo <owner>/<repo> --body … --yes <number>
+# labels／milestones／releases／repos
+teai labels list --repo <owner>/<repo>
+teai labels create --repo <owner>/<repo> --name … [--color #RRGGBB] [--description …] --yes
+teai milestones list --repo <owner>/<repo> [--state open|closed|all]
+teai milestones create --repo <owner>/<repo> --title … [--description …] [--due RFC3339] --yes
+teai releases list --repo <owner>/<repo>
+teai repos list [--org <org>]
+# 任意 API 呼叫（逃生口）
+teai api <path> [--method GET|POST|PATCH|DELETE] [--data '<json>'] [--yes]
+```
+
+> `--yes` 閘門：所有寫入類命令（create／close／comment／merge／labels create／milestones create／api 非 GET 動詞）未帶 `--yes` 時回 exit 2（用法錯誤），且不發出任何 HTTP 請求。
+> `teai api` 的 path 內含查詢字串（如 `/repos/a/b/issues?state=closed`）時會正確傳遞。
 
 ### 全域介面
 
@@ -60,22 +91,6 @@ teai [全域選項] <命令> [參數]
 | `teai xrefs <owner>/<repo> <number>` | （內部函式公開化） | 解析內文／留言中的 issue／PR 引用 |
 | `teai version` | — | 版本資訊（骨架已實作） |
 
-### 日常操作（tea 對等指令；#3 不避開 tea 已有功能）
-
-tea 已有的日常操作 teai 也會自行實作（一致的 JSON 輸出、同一套認證與全域選項），
-不要求使用者回頭併用 `tea`。介面語義以 `tea`／Gitea API 為相容參考，僅列出主要子命令，
-細節（旗標、欄位）在個別實作 issue 中定義：
-
-| 命令 | 對應 tea | 說明 |
-| --- | --- | --- |
-| `teai issues [list\|create\|view\|close\|comment…]` | `tea issues` | issues 管理（含 `--comments`、`--assignees`） |
-| `teai pulls [list\|create\|view\|merge\|comment…]` | `tea pulls` | PR 管理（含審核者、合併） |
-| `teai labels` / `teai milestones` / `teai releases` | 同名 tea 指令 | 標籤、里程碑、發佈管理 |
-| `teai repos` / `teai orgs` | `tea repos`／`tea orgs` | 倉庫與組織查詢 |
-| `teai api <path>` | `tea api` | 任意 API 呼叫（逃生口，`--method`、`--data`） |
-
-> 實作順序不變：先完成 gitea.py 工作流命令的 Go 化，再依 issue 逐項補齊日常操作。
-
 > `gitea.py` 的底線函式（`_pr_needs_author_followup`、`_resolve_xref_targets` 等）是內部實作，teai 將其放在 `internal/` 套件，不另設 CLI 命令。
 
 ### `teai next` — 下一件該做的事