核心功能: 本技能提供等高级能力等能力。

GitHub管理器(专业版)

专业版增值服务

能力总览

批量Issue/PR操作

gh-manager issue batch-close --repo owner/repo --label stale --reason "not_planned"
gh-manager issue batch-label --repo owner/repo --issues 1,3,5,7 --labels "bug,priority:high"
gh-manager issue batch-assign --repo owner/repo --issues 10-20 --assignee "alice"
gh-manager issue migrate --from owner/repo-a --to owner/repo-b --issues 1-50
gh-manager issue batch-reopen --repo owner/repo --issues 30,32,35

批量操作安全机制:

• 预演模式: --dry-run先预览变更,不实际执行
• 确认机制: 影响超过10条记录时需二次确认
• 回滚支持: 每次批量操作生成回滚脚本
• 速率控制: 自动遵守API限速,避免触发429

GraphQL高级查询

gh-manager graphql query --file queries/cross_repo_prs.graphql --vars '{"author":"alice"}'
gh-manager graphql query --file queries/dependency_graph.graphql --vars '{"repo":"owner/repo"}'
gh-manager graphql paginate --file queries/all_issues.graphql --limit 1000

GraphQL查询示例:

query teamContributions($logins: [String!]!, $since: DateTime!) {
  users(filter: {logins: $logins}) {
    login
    contributionsCollection(from: $since) {
      pullRequestContributions(first: 100) {
        totalCount
        nodes {
          pullRequest {
            repository { nameWithOwner }
            state
            additions
            deletions
          }
        }
      }
    }
  }
}

• 异常时参考错误处理章节进行恢复
• 关键参数: graphql高级查询 选项

自动化工作流

gh-manager automation create --name "stale-issue-triage" \
  --trigger "schedule:0 9 * * 1" \
  --condition "label:none AND updated:<7d" \
  --action "add-label:stale AND comment:'此Issue已7天未更新,7天后将自动关闭'"
gh-manager automation list
gh-manager automation run --name "stale-issue-triage" --repo owner/repo
gh-manager automation history --name "stale-issue-triage" --last 10

自动化场景模板:

团队仪表盘

gh-manager dashboard weekly --repos "owner/repo1,owner/repo2" --team "alice,bob,carol" --format pdf
gh-manager dashboard contributions --repos "owner/repo1" --period 30d
gh-manager dashboard burndown --repo owner/repo --milestone "v2.0"
gh-manager dashboard summary --org my-org --period week

仪表盘维度:

• Issue/PR数量与状态分布
• 成员贡献排名(提交、PR、review)
• 平均响应时间与关闭周期
• CI/CD成功率与平均时长
• 标签分布与趋势

Webhook管理

gh-manager webhook list --repo owner/repo
gh-manager webhook add --repo owner/repo \
  --url "https://hooks.example.com/github" \
  --events "issues,pull_request,push" \
  --secret "$WEBHOOK_SECRET"
gh-manager webhook test --repo owner/repo --id 123 --event "issues"
gh-manager webhook delete --repo owner/repo --id 123

安全审计

gh-manager audit permissions --repo owner/repo --format csv
gh-manager audit secrets --repo owner/repo --depth 100
gh-manager audit compliance --org my-org --standard SOC2 --format pdf
gh-manager audit tokens --org my-org --period 90d

部署指引

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用范围

场景1 -开源项目Issue triage自动化

用户意图: "开源项目Issue太多,需要自动化triage流程。" 实施方案:

1. 创建"stale-issue-triage"自动化规则(7天无更新加标签,14天关闭)
2. 创建"auto-assign"规则(新Issue按标签分配给maintainer)
3. 创建"bug-report-template"规则(缺少复现步骤的Issue自动回复模板)
4. 每周生成triage报告,review未处理Issue

场景2 -多仓库团队管理

用户意图: "团队管理5个仓库,需要统一视图。" 实施方案:

1. 使用gh-manager dashboard summary --org my-org汇总多仓库状态
2. 配置跨仓库Webhook,统一接收事件
3. 设置CI失败自动告警(通知到IM)
4. 每月生成团队贡献报告

场景3 -安全合规审计

用户意图: "准备SOC2审计,需要GitHub权限与操作记录。" 实施方案:

1. 运行gh-manager audit permissions导出权限矩阵
2. 运行gh-manager audit secrets扫描敏感信息
3. 运行gh-manager audit compliance --standard SOC2生成合规报告
4. 导出90天操作日志作为审计证据

场景4 -大规模Issue迁移

用户意图: "要把旧仓库的200个Issue迁移到新仓库。" 实施方案:

1. 使用--dry-run预演迁移,确认映射关系
2. 执行gh-manager issue migrate --from old --to new --issues 1-200
3. 自动保留原始标签、assignee、评论
4. 生成迁移报告,核对数量

操作流程

第1步:安装与认证

pip install gh-manager[pro]
gh auth login
gh-manager version
gh-manager status

第2步:配置团队

gh-manager team init --org my-org
gh-manager team add --members "alice,bob,carol"
gh-manager repo add --repos "owner/repo1,owner/repo2,owner/repo3"

第3步:启用自动化

gh-manager automation enable --template stale-issue-triage
gh-manager automation enable --template ci-failure-alert --notify "im:#devops"
gh-manager automation list --enabled

第4步:生成仪表盘

gh-manager dashboard weekly --format pdf --output weekly-report.pdf
gh-manager dashboard live --port 8080

输入规范

返回格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常处置

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• gh CLI: 2.0+(GitHub官方命令行工具,作为底层依赖)
• Python: 3.8+(运行gh-manager CLI)
• Node.js: 16+(可选,用于实时仪表盘)

第三方依赖

API Key 配置

• GitHub认证: 通过gh auth login完成OAuth,token存储于~/.config/gh/hosts.yml
• Webhook Secret: 通过环境变量WEBHOOK_SECRET配置,加密存储
• IM通知Token: 通过环境变量配置(如Slack/钉钉的webhook URL)
• Token权限: 建议包含repo、workflow、read:org、admin:org_hook
• 禁止: 在SKILL.md或脚本中硬编码任何Token或Secret

可用性分类

• 分类: MD+EXEC+CLI+DAEMON(Markdown指令+命令行工具+自动化守护)
• 说明: 基于Markdown的AI Skill，高级功能需要gh-manager CLI与自动化守护进程

案例展示

完整专业版配置

{
  "edition": "pro",
  "github": {
    "auth_mode": "oauth",
    "default_scope": ["repo", "workflow", "read:org", "admin:org_hook"]
  },
  "team": {
    "org": "my-org",
    "members": ["alice", "bob", "carol"],
    "repos": ["owner/repo1", "owner/repo2", "owner/repo3"]
  },
  "automation": {
    "enabled": true,
    "rules": [
      {
        "name": "stale-issue-triage",
        "trigger": "schedule:0 9 * * 1",
        "condition": "label:none AND updated:<7d",
        "action": "add-label:stale"
      },
      {
        "name": "ci-failure-alert",
        "trigger": "workflow_run:completed:failure",
        "action": "notify:im:#devops"
      }
    ]
  },
  "dashboard": {
    "enabled": true,
    "port": 8080,
    "refresh_interval": 300
  },
  "audit": {
    "enabled": true,
    "log_retention": 365,
    "alert_on_secret": true
  }
}

自动化规则示例

- name: auto-assign-by-label
  description: 按Issue标签自动分配负责人
  trigger:
    type: event
    event: issues
    action: opened
  condition:
    label: bug
  action:
    type: assign
    strategy: round_robin
    team: [alice, bob, carol]
- name: pr-review-sla
  description: PR review SLA监控
  trigger:
    type: schedule
    cron: "0 10 * * *"
  condition:
    pr_state: open
    review_age: ">24h"
  action:
    type: notify
    channel: im
    target: "#pr-reviews"
    message: "PR #"manager_result" 待review已超过24小时"

疑问解答

Q1: 批量操作会不会触发GitHub限速?

A: 专业版自动遵守API限速(5000请求/小时),超限时自动排队等待。大批量操作(>100条)建议在低峰期执行,并启用--rate-limit wait模式.

错误恢复步骤

使用约束

A: GitHub GraphQL API有复杂度评分限制(单次查询≤500000点)。专业版会自动计算复杂度,超限时建议拆分查询或使用分页.

Q3: 自动化规则失败会通知吗?

A: 会。自动化规则执行失败时,自动发送通知到配置的channel(邮件/IM)。同时记录到automation_history表,可通过gh-manager automation history --failed查看.

Q4: 团队仪表盘数据多久更新一次?

A: 实时仪表盘默认5分钟刷新一次(可配置)。周报/月报在生成时全量拉取。建议启用数据缓存,降低API消耗.

Q5: Webhook secret如何管理?

A: 通过环境变量WEBHOOK_SECRET配置,加密存储于~/.gh-manager/secrets.enc。禁止在配置文件中明文存储。支持按仓库配置不同secret.

Q6: 安全审计会扫描哪些敏感信息?

A: 扫描内容包括: API Key、密码、私钥、token等(基于正则与熵值检测)。支持自定义扫描规则。发现敏感信息会自动告警并生成Issue.

Q7: 如何导出审计报告给合规团队?

A: 运行gh-manager audit compliance --standard SOC2 --format pdf --output audit.pdf,支持SOC2、ISO27001、GDPR等标准。报告包含权限矩阵、操作日志、敏感信息扫描结果.

Q8: 多组织场景如何管理?

A: 通过gh-manager org add添加多个组织,切换时用--org参数指定。仪表盘支持跨组织汇总视图.

Q9: 自动化规则支持哪些触发条件?

A: 支持: (1)定时(cron表达式); (2)事件(Issue/PR/Push/Release等); (3)状态变化(标签添加、状态流转); (4)外部webhook。可组合多条件.

Q10: 专业版支持GitHub Enterprise吗?

A: 支持。配置GITHUB_ENTERPRISE_HOST环境变量即可连接Enterprise Server。所有功能在Enterprise环境下均可用.

补充限制说明

• 需要LLM支持
• API调用依赖第三方服务的可用性与稳定性
• 免费版有调用次数限制与并发限制

问题排查手册

安全规范

创新特色

主要功能

• 自动化执行: 全功能GitHub管理工具,含批量操作、GraphQL高级查询、自动化工作流、团队仪表盘与Webhook管理,适合团队企
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

常见咨询

Q1: GitHub管理器(专业版)支持哪些输入格式？

A1: 全功能GitHub管理工具,含批量操作、GraphQL高级查询、自动化工作流、团队仪表盘与Webhook管理,适合团队企业级协作。。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

异常应对措施

针对GitHub管理器(专业版)使用中可能遇到的常见问题,提供以下排查方案:

GitHub管理器(专业版)通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

快速入门指南

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

协助指南

常见咨询

Q1: GitHub管理器(专业版)支持哪些输入格式？

A1: 全功能GitHub管理工具,含批量操作、GraphQL高级查询、自动化工作流、团队仪表盘与Webhook管理,适合团队企业级协作。。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。