Tenpace Review Router

Review Router 设置

通过工作流或 AI 编码会话创建 GitHub 到 Slack 的 Review Router 连接。此 Action 会生成一个短时有效的浏览器链接。打开链接并登录 Tenpace，即可认领并锁定确切的代码库、Slack 目标位置、路由预设和审阅者提及策略。

此 Action 绝不会接收 GitHub App 凭据、Slack OAuth 令牌、提供商授权码或用户的 Tenpace 会话。

使用此 Action

创建 .github/workflows/review-router-setup.yml：

name: Set up Review Router

on:
  workflow_dispatch:

permissions:
  contents: read
  id-token: write

jobs:
  setup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: tenpace-app/review-router-setup@v1
        with:
          slack-channel: pull-requests
          preset: repo-watch
          reviewer-mentions: all

运行工作流。启动工作流的同一 GitHub 用户需打开作业摘要中的 继续设置 Review Router 链接，登录 Tenpace，完成 GitHub 和 Slack 步骤，并让页面通过实际 Slack 消息投递来协调和验证路由。

将配置作为代码管理

也可以不使用输入项，而是提交 .tenpace/review-router.yml：

version: 1
route:
  slack-channel: pull-requests
  preset: repo-watch
  reviewer-mentions: all

如果 Tenpace 团队连接了多个工作区，也可以设置 slack-workspace。显式 Action 输入项会覆盖文件中的设置。

输入项

• slack-channel：Slack 频道名称，可带或不带 #。除非配置文件中已设置，否则必填。
• slack-workspace：可选的确切工作区名称、Slack 团队 ID 或 Tenpace 工作区 ID。
• preset：repo-watch、full-coverage 或 team-activity。默认值：repo-watch。
• reviewer-mentions：all、connected-only 或 none。默认值：all。
• config：配置路径。默认值：.tenpace/review-router.yml。

输出项

• setup-id：公开的设置会话 ID。
• setup-url：短时有效的用户授权 URL。
• status：初始状态，通常为 awaiting_human。

机器设置令牌会被屏蔽，并且不会作为 Action 输出公开。显示的 URL 不包含认领密钥：它绑定到已签名 OIDC 令牌中的 GitHub 用户，该 GitHub 用户必须亲自打开此 URL。浏览器流程无需将密钥放入其他工作流步骤即可完成设置。

安全模型

GitHub Actions OIDC 会证明工作流运行对应的代码库和用户，但不会授予提供商权限。Tenpace 会验证 OIDC 颁发者、签名、受众、时间范围、代码库和所有者 ID、用户 ID、主题以及代码库绑定。Action URL 不包含认领密钥，且只能由对应的 GitHub 用户认领。

服务器会创建一条不可操作的意图。Tenpace 用户登录并认领设置 URL 时，系统会以原子方式锁定该确切版本的意图。认领后，机器令牌无法再进行编辑；认领设置的用户可以编辑，而保存操作会在同一次操作中创建并锁定新版本。提供商 OAuth 授权流程会保留在浏览器中，加密凭据则保留在 Tenpace 上。

设置创建和应用操作均具备幂等性。最终检查会通过与拉取请求通知相同的 Slack 消息投递路径发送一条消息。

有关报告和运维详情，请参阅 SECURITY.md。

面向编码 Agent

自动化设置前，请阅读 AGENTS.md。规范的机器可读接口如下：

• OpenAPI 3.1
• 远程 MCP
• MCP Registry 元数据
• Agent 描述文件
• 原始 Markdown 指南
• llms.txt

AI 发现机制没有统一的约定，因此同一工作流会在 Action 元数据、README、AGENTS.md、链接的 HTML/Markdown 文档、OpenAPI、MCP 和 well-known 描述文件中进行说明。

此远程 MCP 服务也已发布到官方 MCP Registry，名称为：

io.github.tenpace-app/review-router

许可证

MIT