docs: add Claude Code/Codex/OpenCode skills invocation guide

Home.md

@@ -61,4 +61,76 @@ python skills/gitea-issue-devops-agent/scripts/preview_slot_allocator.py --state
 
 - `.gitea/workflows/issue-branch-preview.yml`
 - `.gitea/workflows/preview-slot-reclaim.yml`
-- `.gitea/workflows/publish-site.yml`
+- `.gitea/workflows/publish-site.yml`
+
+## Skills 调用前置信息（Claude Code / Codex / OpenCode）
+
+统一建议先准备这组参数：
+
+- `repo_url`
+- `api_key`（Gitea token，需 issue 读写权限）
+- `mode`（`automatic` / `semi-automatic` / `manual`）
+- 可选：`reviewers`、`test_entry`、`deploy_env`、`health_endpoint`、`min_quality_score`
+
+### Claude Code
+
+Skills 目录（官方支持）：
+
+- 用户级：`~/.claude/skills/<skill-name>/SKILL.md`
+- 项目级：`.claude/skills/<skill-name>/SKILL.md`
+
+唤起方式：
+
+- 显式调用：`/<skill-name> [args]`
+- 对话调用：直接说“使用某个 skill 处理任务”
+
+示例：
+
+```text
+/gitea-issue-devops-agent repo_url=https://fun-md.com/FunMD/document-collab mode=automatic
+```
+
+```text
+请使用 gitea-issue-devops-agent，连接 repo_url=...，api_key=...，以 semi-automatic 模式处理 issue #48
+```
+
+### Codex
+
+Skills 安装目录（当前方案）：
+
+- `~/.codex/skills/gitea-issue-devops-agent`
+
+唤起方式：
+
+- 对话显式点名：`$gitea-issue-devops-agent`
+- 或自然语言明确要求：`使用 gitea-issue-devops-agent skill`
+
+示例：
+
+```text
+$gitea-issue-devops-agent
+repo_url: https://fun-md.com/FunMD/document-collab
+api_key: <TOKEN>
+mode: automatic
+```
+
+### OpenCode
+
+Skills 目录（Claude skill 兼容）：
+
+- 项目级：`.opencode/skills/<skill-name>/SKILL.md`
+- 全局级：`~/.config/opencode/skills/<skill-name>/SKILL.md`
+
+唤起方式：
+
+- 对话里明确要求使用目标 skill（推荐）
+- Agent 内部会通过原生 `skill` 工具加载（`skill({name: "..."})`）
+
+示例：
+
+```text
+Use skill gitea-issue-devops-agent.
+repo_url=https://fun-md.com/FunMD/document-collab
+api_key=<TOKEN>
+mode=manual
+```