rosentic-mcp Skill 技能

rosentic-mcp 是面向并行 AI 编码 Agent 的跨分支冲突检测 MCP 服务器。当多个 Agent 同时在各自分支上开发时，它能捕获函数签名变化、HTTP 路由中断和 Schema 漂移等破坏性变更，在合并前发现潜在问题。

技能简介

在多 Agent 并行开发环境中，一个 Agent 修改了函数签名，另一个 Agent 仍在调用旧版本——两者 CI 都能通过，合并后主分支却会断裂。rosentic-mcp 通过确定性静态分析，在本地 MCP 模式下对比活跃分支间的兼容性，代码和扫描元数据全程留在本地机器，不依赖 LLM，不依赖云端 API。

核心能力

• 9 个 MCP 工具：check_conflicts、check_file、explain_conflict、list_branches、run_status、which_lane、get_verdict、get_policy、get_remediation_queue
• 13 种编程语言支持：Python、JavaScript、TypeScript、Go、Java、Rust、Swift、C++、Kotlin、C#、Ruby、PHP、Dart
• 确定性静态分析：无 LLM 调用，结果可复现，不受模型波动影响
• 本地优先：check_file、check_conflicts 等核心工具完全离线运行，60 秒扫描结果缓存
• 强制门禁模式（可选）：rosentic-mcp install-hooks 安装 Git pre-push hook，UNSAFE 时主动阻止推送
• Claude Code 原生集成：通过 PreToolUse hook 在 Agent 写入前拦截 UNSAFE 变更
• Git Worktree 支持：本地和 Docker 引擎均支持 linked git worktree
• 调用计量：本地计数器 ~/.rosentic/mcp-usage.json，无计费，无隐私外传

安装配置

步骤 1：安装

pip3 install --upgrade rosentic-mcp

> 注意：即使已安装过也使用 --upgrade，因为普通 pip install 对已安装用户是空操作。

步骤 2：配置 Claude Code

在 ~/.claude.json 中添加：

{
  "mcpServers": {
    "rosentic": {
      "command": "rosentic-mcp"
    }
  }
}

在项目 CLAUDE.md 中添加指令：

Before running git push, call the Rosentic check_conflicts MCP tool to verify your branch is compatible with other active branches.

步骤 3：配置 Codex

在 ~/.codex/config.toml 中添加：

[mcp_servers.rosentic]
command = "rosentic-mcp"
args = []

同样在 AGENTS.md 中添加 push 边界指令。

步骤 4：配置 Cursor / VS Code

在 MCP 设置中添加：

{
  "rosentic": {
    "command": "rosentic-mcp"
  }
}

使用步骤

1. 安装并配置 MCP 服务器（如上）

2. 在 CLAUDE.md 中添加检查指令

3. 手动运行冲突检查：

   rosentic-mcp gate --repo . --base main
   # 退出码：0=通过，1=UNSAFE，2=扫描错误

4. 安装强制门禁（可选）：

   cd your-repo
   rosentic-mcp install-hooks
   git add .githooks .claude/settings.json
   git commit -m "Add Rosentic enforcement gate"

   安装后，pre-push hook 自动运行 gate，未通过的推送被阻止。

5. 查看详细冲突解释：

   rosentic check_conflicts --repo . --branch feature/auth --format summary

适用场景

• 多 Agent 并行开发：团队中多个 Agent 同时在不同分支工作，需要在合并前确认无破坏性冲突
• Monorepo 管理：大规模代码库中跨包依赖变更检测
• Code Review 辅助：PR 审查时借助 MCP 工具快速了解目标分支的冲突情况
• 持续集成加固：GitHub Action 作为 CI 门禁的补充层
• 大型重构安全网：重构函数接口或 API 路由时，实时监控影响范围

适用人群

• 多 Agent 开发团队：同时运行多个编码 Agent 的工程团队
• 平台工程师：搭建和维护多 Agent 开发平台的工程师
• DevOps / CI 工程师：需要在 CI 层面部署代码质量门禁的工程师
• 技术负责人：关注代码合并质量和分支兼容性的技术管理者

工作原理

rosentic-mcp 启动后注册 9 个 MCP 工具。核心分析引擎读取本地 Git 仓库的分支引用和文件内容，对比目标分支与基线分支间的符号表（函数签名、API 路由、Schema 字段），识别消费者数量和变更方向。分析结果带有明确的执行状态（EXECUTED / CACHED / DEGRADED / NOT_EXECUTED），帮助 Agent 判断结果的可靠程度。对于需要在线数据的工具（get_verdict、get_policy），网络不可用时自动降级并返回解释性内容，不抛出异常。

官方链接

• PyPI：https://pypi.org/project/rosentic-mcp/
• GitHub：https://github.com/rosentic/rosentic（推断）
• MCP 工具文档：内置于 MCP 协议，通过 MCP 客户端直接调用