需完成HermesAgent的GitHub自动化配置，包括：一、配置GitHub MCP接入权限；二、启用GitHub代码审查技能；三、部署GitHub Actions流水线；四、配置Issue自动化处理规则；五、集成Linear看板双向同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 GitHub 项目中的 Pull Request 与 Issue 不再依赖人工响应与分配，而是由 AI 智能体自动完成审查、创建、分配、状态更新等操作，则需完成 HermesAgent 的 GitHub 自动化配置。以下是实现该能力的具体路径：
一、配置 GitHub MCP 接入权限
此步骤为 HermesAgent 赋予读写 GitHub 仓库元数据与交互对象（如 PR、Issue）的合法身份，是所有自动化行为的前提。MCP（模型上下文协议）将 GitHub API 封装为可调用工具，使 Agent 能像执行本地函数一样触发 create_pull_request、list_issues 等操作。
1、访问 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)，点击 Generate new token → Generate new token (classic)。
2、在 token 名称中填写 hermes-github-prod，勾选以下最小必要权限：repo（完整仓库访问）、workflow（管理 Actions）、read:org（读取组织信息）、read:user（读取用户资料）。
3、生成后立即复制该 token 字符串，它仅显示一次。
4、将 token 写入 Hermes Agent 环境变量文件 ~/.hermes/.env，添加行：GITHUB_TOKEN=ghp_xxx_your_token_here。
5、在终端运行 hermes doctor --verbose，确认输出中包含 GitHub MCP 已加载且认证通过。
二、启用并安装 GitHub 代码审查技能
该技能激活 HermesAgent 对 PR 内容进行语义级分析的能力，涵盖安全漏洞识别、逻辑缺陷提示、风格一致性检查，并支持生成带行号标注的结构化反馈。
1、执行命令安装技能：hermes skills install github-code-review。
2、验证是否成功加载：hermes skills list | grep "github-code-review"，应返回非空结果。
3、若未识别，检查 gh CLI 是否已登录：gh auth status；若提示未认证，运行 gh auth login 并选择 GitHub.com 与 HTTPS 协议，完成 OAuth 流程。
4、确认本地 git 与 gh 均可访问目标仓库，例如运行 gh repo view owner/repo 应返回仓库元信息。
三、部署 GitHub Actions 自动化流水线
通过 GitHub Actions 在 push 或 pull_request 事件触发时自动调用 HermesAgent，形成强制质量门禁与即时响应机制，避免问题进入主干分支。
1、在项目根目录创建 .github/workflows/hermes-pr-review.yml 文件。
2、写入 workflow 定义，指定 on 触发器为：pull_request: types: [opened, synchronize, reopened]。
3、在 jobs.job.steps 中添加：使用 actions/checkout@v4 检出代码，并启用 submodules: recursive。
4、添加运行 Hermes 审查的步骤：run: hermes skills run github-code-review --pr=${{ github.event.pull_request.number }} --repo=${{ github.repository }}。
5、设置环境变量 GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}，确保 Action 具备调用 GitHub API 的权限。
6、提交该文件后，任意新 PR 将自动触发审查，审查结果将以评论形式发布在 PR 页面底部。
四、配置 Issue 自动化处理规则
此方法基于自然语言指令与预设模板，使 HermesAgent 可响应关键词、自动创建 Issue、分配负责人并打上分类标签，消除手动录入延迟。
1、在 skills/github/github-issues/templates/ 目录下，确认存在 bug-report.md 与 feature-request.md 模板文件。
2、编辑 ~/.hermes/config.yaml，在 rules: 区块下新增规则项：- trigger: "bug report.*" action: create_issue template: bug-report.md assignees: ["dev-team"] labels: ["bug", "triage"]。
3、重启 Hermes Agent：hermes reload，使规则生效。
4、在 GitHub 仓库的 Discussions 或通过 Hermes CLI 输入：create a new bug report for login timeout。
5、Agent 将解析语义，填充模板字段，调用 GitHub API 创建 Issue，并自动添加标签与分配成员。
五、集成 Linear 看板实现双向同步
当 HermesAgent 同时连接 GitHub 与 Linear 时，PR 合并可自动关闭对应 Linear Issue，Issue 状态变更亦可反向触发 GitHub 评论或 PR 提交，打通研发全流程闭环。
1、登录 linear.app，进入 Settings → Developers → API keys，创建名为 hermes-linear-prod 的密钥，勾选 Issues: Read & Write 和 Projects: Read。
2、将密钥写入 ~/.hermes/.env：LINEAR_API_KEY=lin_api_xxx。
3、安装插件：pip install hermes-linear-toolset，并在 ~/.hermes/config.yaml 的 toolsets: 下添加 - linear。
4、在 Linear 设置中创建 Webhook，URL 指向 Hermes Gateway 地址，事件类型勾选 issue.updated。
5、在 config.yaml 的 rules: 中添加反向规则：- trigger: "issue.status_changed.*Done" action: comment_on_pr content: "Linked issue closed: {{issue.id}}"。
6、当 Linear 中某 Issue 状态变更为 Done，Hermes 将自动检索其关联的 GitHub PR 编号，并发布确认评论。
