用途:帮助用户把 Infrahub 生态中的缺陷或功能请求提交到正确的 GitHub 仓库。该技能不自动提交,只生成完整且已脱敏的 issue,并在用户审核通过、明确同意内容和提交方式后才提交。
触发时机:用户表达“发现 Infrahub 缺陷”“如何报告”“想提功能需求”“该提交到哪”“想开 ticket”等意图时使用。若用户只是在本地调试、尚未表达提交意图,则不触发。若问题出在 Infrahub 技能自身指南(规则错误、缺失或令人困惑),应交给 infrahub-reporting-skill-gaps 处理。
路由与分类:区分 bug、feature request 或使用咨询;使用咨询应引导到 Discord/discussions 而非开 issue。生态含 11 个候选仓库,技能根据本地文件线索(如 infrahub.toml、pyproject.toml、galaxy.yml、.claude-plugin/plugin.json)判断目标仓库,并向用户确认。检测不明确时默认提交到 opsmill/infrahub,由其维护者转派。
查重:始终同时搜索 bug 和 feature。优先使用 gh CLI(gh search issues --repo <owner/repo> "<keywords>"),否则使用 MCP GitHub 工具,再否则给出搜索 URL 由用户手动检查。若匹配已有 issue,则改为评论模式,分为补充信息或“+1”记录。
环境信息:仅对 bug 收集相关产品版本、操作系统与架构、Python 或运行时版本;不要收集文件路径、项目结构、完整日志或 docker compose 输出。版本可通过 infrahubctl info、pip show infrahub-sdk、ansible-galaxy collection list opsmill.infrahub、helm list、infrahub-sync --version 等方式获取,无法确定时标为 unknown。
生成与审核:若目标仓库有 .github/ISSUE_TEMPLATE/,按其表单渲染;无模板时回退到本技能的 templates/bug.md 或 templates/feature.md。标题采用 <area>: <imperative summary>,不超过 72 字符。正文先经用户强制审核,再选择提交方式:gh issue create、gh issue comment、MCP 工具或手动复制粘贴。
限制:不能跳过用户批准步骤;不能把使用问题当作 bug;不能粘贴完整日志或可能泄露主机名、IP、容器名与密钥的内容;若症状模糊,应提交主仓库而非子仓库。