hotplex-pr-qualitylisted
Install: claude install-skill hrygo/hotplex
# HotPlex PR 质量保证
HotPlex 项目专用的 PR 提交与 CI 达标工作流。
## HotPlex 架构速查
代码运行在多 channel（Slack/飞书/WebChat/元芯）、多 worker（CC/OCS/CodexCLI/ACP）、跨平台（Linux/macOS/Windows）环境下，CI 必须三平台通过。
架构详情：[references/architecture.md](references/architecture.md)
## 核心工作流
```
质量检查 → 提交代码 → 推送 fork → 创建/更新 PR → 监控 CI → 修复（如需）
```
按以下阶段顺序执行。如果用户只要求部分步骤（如「帮我推代码」），从对应阶段开始。
### 阶段 1：前置检查
1. 确认 `gh` CLI 可用（`gh auth status`）
2. 检查当前分支和未提交修改（`git status`）
3. 检测 fork 远程仓库（`git remote -v`），找到包含用户 GitHub 用户名的远程仓库
### 阶段 2：质量检查
运行以下命令，失败则停止并分析原因：
```bash
make test # 含 -race，三平台
make lint # golangci-lint
```
如果失败，分析错误日志并提供修复建议。跨平台失败优先检查 `filepath.Join()` 和 build tags。
### 阶段 3：提交代码
生成 Conventional Commits 格式的 commit message：
```
<type>(<scope>): <subject>
<body>
<footer>
Co-Authored-By: Claude <noreply@anthropic.com>
```
**Type**: feat, fix, refactor, perf, test, docs, style, chore
**Scope**（架构感知，根据 git diff 推断）：
- Gateway 核心：`gateway`、`session`、`config`、`security`
- Channel：`messaging/slack`、`messaging/feishu`、`webchat`
- Worker：`worker/cc`、`worker/ocs`、`worker/codexcli`、`worker/acp`
- 平台：`cli`、`service`、`build`
**示例**：
```
fix(worker/ocs): resolve SSE timeout issues
Add separate sseClient without Timeout for SSE connections
and use cancellable context for clean shutdown.
Fixes #85
Co-Authored-By: Claude <noreply@anthropic.com>
```
### 阶段 4：推送代码
1. 检查是否已有 PR：`gh pr list --head <user>:<branch> --repo hrygo/hotplex`
2. 推送到 fork：`git push -u <fork-remote> <branch>`
3. 已有 PR 则增量推送更新，否则准备创建