github-ops

用途：面向网络自动化场景，把 GitHub 仓库作为配置与审计的协作中心，将网络发现、配置变更和审计报告纳入版本化流程。\n\n主要能力：仓库操作方面可搜索仓库、列出分支、读取文件内容、创建或更新文件、创建分支、比较分支、列出提交。议题方面可创建、列出、搜索、更新和评论，用于跟踪网络发现、审计结果与整改任务。拉取请求方面可创建、列出、查看详情、评审、合并和评论，用于配置变更。代码搜索可跨仓库查找配置模式，定位特定 IP、VLAN、ACL 引用。Actions 方面可列出工作流运行、获取工作流状态，并触发工作流以执行自动化测试。\n\n典型流程：网络发现转议题，即发现网络问题后创建议题，包含设备名、症状、建议修复，打上 bug、security、performance 等标签，并引用 GAIT 会话 ID 作为审计线索。配置变更转 PR，即变更获批后从 main 建分支、提交新配置、开设带变更说明和 ServiceNow CR 编号的 PR，并在 GAIT 审计线索中关联该 PR。审计报告入库，即把报告提交为 markdown 文件，按 reports/YYYY-MM-DD/ 按日期组织，包含原始数据与 AI 分析。\n\n环境变量：需要 GITHUB_PERSONAL_ACCESS_TOKEN，即具备仓库访问权限的 GitHub PAT。\n\n规则与限制：不得向仓库提交密钥、密码或 API 密钥；变更必须建分支，禁止直接推送到 main；提交信息需说明网络变更；适用时在 PR 描述中引用 ServiceNow CR 编号。失败行为方面，工具报错（超时、主机不可达、响应格式错误）时应直接向用户报告失败及错误信息，不得编造或猜测结果；确认只读的调用可检查连通性并酌情重试一次；任何改变状态或发送消息的调用，超时不能证明失败，重试前应先检查当前状态或投递状态，保留必要的审批与变更门禁，结果不明时不得重复执行。