AI导哈

结构化软件开发代理工具

Reins是一个Gemini CLI扩展，提供三个专注于结构化软件开发的子代理：调查、规划和审查，以分阶段方式处理软件开发任务。

  • by LuisDee
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 LuisDee/reins

使用说明

缰绳

A. Gemini CLI 扩展，为结构化软件开发添加了三个专门的子代理： 调查, 计划, 审查.

Reins没有让一个代理在一次对话中完成所有事情，而是将工作分成有明确交接的重点阶段，每个阶段都有专门构建的MCP工具集作为支持。

所得

代理 角色 关键工具
调查员 深入调试和根本原因分析。只读。 Serena（LSP）、Hashline、Docker MCP、grep
规划器 TDD实施计划，包括规范+计划文件。 Serena，Context7（文档），顺序思维
审稿人 根据规范/计划审查实施情况。在浏览器和容器中验证。 Serena、Hashline、剧作家（浏览器）、Docker MCP

主Gemini代理协调工作流程：它创建编号的计划目录，委托给子代理，并保存他们的输出。A. current symlink总是指向活动计划，因此代理永远不需要硬编码的路径。

.gemini/plans/
  current -> 2          # symlink to active plan
  1/
    investigation.md
    spec.md
    plan.md
    review.md
  2/ ...

快速开始

git clone https://github.com/LuisDee/reins.git ~/.gemini/extensions/reins
cd ~/.gemini/extensions/reins
bash setup.sh

就是这样。安装脚本会检测您的操作系统（macOS或Linux），并将：

  1. 检查并安装必备组件（node、bun、uv、Docker MCP插件）
  2. 将MCP服务器配置合并到现有配置中 ~/.gemini/settings.json --您现有的服务器和设置将被保留，缰绳只会添加缺失的内容
  3. 预缓存所有MCP服务器，以便快速启动
  4. 安装Playwright的Chromium（包括Linux上的系统依赖程序）
  5. 将代理定义复制到 ~/.gemini/agents/
  6. 运行烟雾测试以确认所有负载

先决条件

  • macOS （自制）或 Linux （Ubuntu/Debian）
  • Node.js 18+（macOS： brew install node，Linux： sudo apt install nodejs npm)
  • Docker引擎 （macOS： Docker 桌面版，Linux： sudo apt install docker.io)
  • Gemini CLI (npm install -g @google/gemini-cli)

如果缺少以下内容，安装脚本将自动安装：

  • 包子 --用于Hashline MCP服务器
  • 紫外线 --适用于Serena LSP服务器
  • Docker MCP插件 --从GitHub版本下载，仅适用于Docker引擎（Linux上不需要Docker桌面）

用法

在任何项目中启动Gemini CLI并使用代理：

调查一个bug

> @investigator The /api/upload endpoint returns 500 when files are > 10MB.
>   Here's the error log: [paste log]

调查员跟踪代码路径，确定根本原因，并返回结构化报告。主代理将其保存到 .gemini/plans/current/investigation.md.

计划修复

> @planner Fix the upload size handling based on the investigation

规划者阅读调查，通过Context7研究最佳实践，通过顺序思维的方法进行推理，并写道 spec.md + plan.md.

实施（您+主代理）

主代理逐步执行计划，使用Hashline进行精确的文件编辑，使用Serena进行代码导航。您批准每一项更改。

审查

> @reviewer Review the upload fix against the spec and plan

审阅者根据实际代码检查每个规范目标和计划任务，并可选择通过Playwright在浏览器中进行验证，或通过Docker MCP检查容器。返回结构化的通过/失败报告。

无头Linux/程序员工作区

Reins在无头Linux服务器上工作 编码员 工作空间：

  • 剧作家 默认情况下，Chromium在无头模式下运行，不需要X11或显示服务器。在Linux上，安装脚本会自动安装所需的系统库(libnss3, libatk-bridge2.0-0等等）。如果你击中 SIGTRAP 集装箱环境中的崩溃，set CHROMIUM_FLAGS=--no-sandbox 或跑步 --cap-add=SYS_ADMIN.

  • Docker MCP 仅适用于Docker引擎，不需要Docker桌面。安装脚本下载 预构建的插件二进制文件 并将其安装到 ~/.docker/cli-plugins/在Linux上，它设置 DOCKER_MCP_IN_CONTAINER=1 绕过桌面功能检查。将此添加到您的shell配置文件中以实现持久性：

    export DOCKER_MCP_IN_CONTAINER=1

  • 编码器端口转发 --如果审阅者需要验证web UI，Playwright可以通过以下方式连接 localhost:<port>.Coder的原生端口转发使服务无需额外配置即可访问。

手动设置

如果你不想使用 setup.sh:

  1. 克隆仓库 作为双子座的延伸：

    git clone https://github.com/LuisDee/reins.git ~/.gemini/extensions/reins

  2. 复制代理 到您的用户级代理目录：

    mkdir -p ~/.gemini/agents
cp ~/.gemini/extensions/reins/agents/*.md ~/.gemini/agents/

  3. 安装Docker MCP插件:

    # macOS (if using Docker Desktop 4.48+, you already have it)
# Linux — download the binary:
curl -fsSL https://github.com/docker/mcp-gateway/releases/download/v0.40.0/docker-mcp-linux-amd64.tar.gz | tar xz
mkdir -p ~/.docker/cli-plugins
mv docker-mcp ~/.docker/cli-plugins/docker-mcp
chmod +x ~/.docker/cli-plugins/docker-mcp

# Linux only — bypass Desktop check:
export DOCKER_MCP_IN_CONTAINER=1

  4. 创建 ~/.gemini/settings.json 使用 settings.template.json 作为基地。将占位符路径替换为系统二进制文件的绝对路径：

    # Find your paths
which npx    # e.g. /usr/local/bin/npx
which bunx   # e.g. /usr/local/bin/bunx or ~/.bun/bin/bunx
which uvx    # e.g. /usr/local/bin/uvx or ~/.local/bin/uvx
which docker # e.g. /usr/local/bin/docker

    替换 __NPX__, __BUNX__, __UVX__，以及 __DOCKER__ 在具有这些路径的模板中。

  5. 安装Playwright浏览器 （系统依赖于Linux）：

    # Linux only — system dependencies:
sudo npx playwright install-deps chromium

# All platforms:
npx playwright install chromium

MCP服务器

服务器 用途 运行时
塞雷娜 基于LSP的代码导航（查找符号、引用、概述） Python（uv）
Hashline 基于锚点的文件读取和编辑（行哈希引用） Bun
背景7 库文档查找 节点
顺序思维 规划前的结构化推理 节点
剧作家 UI验证的浏览器自动化 节点
Docker MCP 容器日志、检查、通过MCP协议进行健康检查 Docker引擎

项目结构

reins/
  agents/
    investigator.md    # Deep investigation agent
    planner.md         # TDD planning agent
    reviewer.md        # Code review agent
  GEMINI.md            # Extension context (workflow + orchestration protocol)
  gemini-extension.json
  settings.template.json
  setup.sh             # One-command installer (macOS + Linux)

运作原理

Reins使用Gemini CLI 扩展系统 和 子代理每个代理都是一个带有YAML frontmatter的Markdown文件，其中指定了其名称、描述、允许的工具、型号和温度。这 GEMINI.md 该文件向主代理提供有关工作流和编排协议的共享上下文。

关键设计决策：

  • 默认情况下，代理是只读的。 调查员和审阅者无法编写文件或运行shell命令。计划者只能写信给 .gemini/plans/current/这可以防止意外修改。
  • 没有shell访问权限。 容器交互通过Docker MCP的结构化协议，而不是 run_shell_command浏览器验证通过Playwright MCP。这为代理提供了所需的功能，而没有外壳逃逸风险。
  • 主要代理人负责策划。 它创建计划目录，管理 current 符号链接，并持久化通过以下方式返回的子代理输出 complete_task.
  • 刀具路径是明确的。 每个代理的前端都列出了它可以访问的MCP工具，强制分离关注点。

卸载

# Remove agents
rm ~/.gemini/agents/{investigator,planner,reviewer}.md

# Remove extension
rm -rf ~/.gemini/extensions/reins

# Remove Docker MCP plugin (optional)
rm ~/.docker/cli-plugins/docker-mcp

# To remove reins MCP servers from settings.json, edit the file manually
# and remove the lsp, hashline, context7, sequential-thinking, playwright,
# and docker entries from mcpServers (keep any servers you added yourself).

许可证

麻省理工学院

相关 MCP