--- name: hotplex-pr-quality version: 3.0.0 description: "HotPlex 项目（hrygo/hotplex）专用 PR 质量保证。开发完成后提交代码、创建/更新 PR、推送 fork、审查代码质量、修复 CI 失败（测试/lint/codecov/跨平台构建）时使用。即使只说「帮我提交」「CI 红了」「推代码」也应触发。覆盖：质量检查 → 提交 → 推送 → PR → 代码审查 → CI 监控与修复。" metadata: requires: bins: ["gh", "git"] env: - GITHUB_TOKEN cliHelp: "gh pr --help" project: hotplex --- # HotPlex PR 质量保证 HotPlex 项目专用的 PR 提交与 CI 达标工作流。 ## HotPlex 架构速查 代码运行在多 channel（Slack/飞书/WebChat）、多 worker（CC/OCS/Pi）、跨平台（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： ``` ():