rforge (Data Wise)

RForge插件

](https://github.com/Data-Wise/rforge/releases) ](https://www.npmjs.com/package/@data-wise/rforge-plugin)  

Claude Code的R包生态系统编排器——16个命令、R感知钩子、验证技能。

Claude Code的独立R包分析。从v1.3.0开始，该插件完全自给自足——纯Python lib/ 模块处理发现、依赖关系、状态和init。不需要MCP服务器。

即将在v2.0.0中发布（突破性）

• 🔀 3个命令已重命名 为了更清晰的命名空间-- /rforge:doc-check → /rforge:docs:check, /rforge:ecosystem-health → /rforge:health, /rforge:rpkg-check → /rforge:r:check。其他13个命令不变。键入旧名称会产生一个指向新名称的有用重命名错误——没有无声的失败。看 docs/migration/v2.0.0-rename.md 对于完整的映射表和 sed 大规模更新本地脚本的方法。

v1.3.0的新增功能

• 🎯 MCP吸收完成 — rforge-mcp 已被吸收到插件中。所有7个实现的工具现在都以纯Python的形式发布 lib/ 模块。不再需要MCP服务器（并且正在存档）。看 docs/migration/rforge-mcp-deprecation.md.
• 🐍 lib/status.py --生态系统健康快照(DESCRIPTION + .STATUS 解析）。 python3 -m lib.status [--path .] [--format text|json].
• 🌱 lib/init.py --初始化 ~/.rforge/context.json 用于跨包状态。 python3 -m lib.init [--quick]新 /rforge:init 命令。
• 📦 Python 3.10之外没有运行时依赖关系+ --该插件适用于任何使用现代Python的系统。

v1.2.0的新增功能

• 🛒 市场安装 --一键设置

/plugin marketplace add Data-Wise/rforge （没有克隆，没有符号链接）。 看 docs/configuration.md 用于可调 选项（CRAN镜像、小插图引擎、R版本引脚、CLAUDE.md预算）。

• 🪝 R意识 PreToolUse 钩子 --每个人都要遵守的四条规则

Write/Edit：阻止手动编辑生成的roxygen man/*.Rd, 警告何时 R/*.R 警告：编辑可能需要名称/描述同步 非SemVer DESCRIPTION 版本颠簸，在外部写入时发出警告 主动工作台。诊断性，非对抗性——只有 man/*.Rd 规则块。看 docs/hooks-and-skills.md.

• 🔍 description-sync 验证技能 --纯shell健全性检查

那 DESCRIPTION 版本与中的顶部条目匹配 NEWS.md / CHANGELOG.md。捕获最常见的CRAN发布前准备失败。 不需要R。

• 📐 插件表面架构图 --新美人鱼图

docs/architecture.md 展示了市场， 配置、命令、代理、钩子和技能相关。

完整更新日志： CHANGELOG.md.

快速开始

# Quick analysis (`)
1. **R环境**
   - R>=4.0.0
   - devtools包（可选，用于 `/rforge:thorough`)
   - testthat包（可选）
   - covr包（可选，用于覆盖率分析）
1. **克劳德代码CLI或克劳德桌面**
   - 插件在两种环境中都有效

> **从v1.2.x迁移？** 如果你有 `mcpServers.rforge` 进入
> `~/.claude/settings.json`，你可以删除它——v1.3.0不再需要
> MCP服务器。看 [`docs/migration/rforge-mcp-deprecation.md`](docs/migration/rforge-mcp-deprecation.md).

## 安装

#### 选项1:克劳德代码市场（推荐）

从内部克劳德代码：

/plugin marketplace add Data-Wise/rforge /plugin install rforge

市场安装读取 `.claude-plugin/marketplace.json` 从
存储库，将插件提取到 `~/.claude/plugins/rforge`，和电线
它自动上升。适用于macOS、Linux和Windows。稍后更新
`/plugin update rforge`.

#### 选项2：自制（macOS）

Add the Data-Wise tap

brew tap data-wise/tap

Install rforge plugin

brew install rforge

Homebrew配方自动：

- 将插件安装到 `~/.claude/plugins/rforge`
- 使其在Claude Code CLI和Claude Desktop中可用

#### 选项3:npm（发布时）

Install from npm (after publishing)

npm install -g @data-wise/rforge-plugin

Plugin will auto-install to ~/.claude/plugins/rforge

#### 选项4：手动安装（本地开发）

**对于Claude Code CLI和Claude Desktop：**

Clone the repository

git clone https://github.com/Data-Wise/rforge.git cd rforge

Install in development mode (symlink - changes reflected immediately)

ln -s $(pwd) ~/.claude/plugins/rforge

Or install in production mode (copy - stable)

cp -r . ~/.claude/plugins/rforge

**安装位置：**

- 插件目录： `~/.claude/plugins/rforge`
- 命令： `~/.claude/plugins/rforge/commands/`
- 代理人： `~/.claude/plugins/rforge/agents/orchestrator.md`
- 库： `~/.claude/plugins/rforge/lib/`

### 验证安装

**第一步：检查插件**

Check plugin directory exists

ls -la ~/.claude/plugins/rforge

Verify plugin.json

cat ~/.claude/plugins/rforge/.claude-plugin/plugin.json

**第二步：检查Python**

python3 --version # Expect 3.10+

**步骤3：端到端测试**

Navigate to an R package

cd ~/projects/r-packages/active/RMediation

Start Claude Code

claude

Test a command

/rforge:status

**预期产量：**

📊 RMediation - Single Package ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Version: 2.4.0 Tests: 187 passing Health: 87/100 (B+)

### 在Claude Code CLI中使用

安装后，命令立即可用：

Navigate to any R package

cd ~/my-r-package

Start Claude Code

claude

Use rforge commands

/rforge:analyze "Update bootstrap algorithm" /rforge:status /rforge:quick

### 在Claude桌面应用程序中使用

打开Claude Desktop时，RForge会自动加载。命令的工作方式相同：

1. 打开克劳德桌面应用程序
1. 将对话导航到R包目录（或指定路径）
1. 使用斜线命令： `/rforge:analyze`, `/rforge:status`等等。

### 迁移

- **从v1.2.x版本开始：** 这 `mcpServers.rforge` 进入 `~/.claude/settings.json` 在v1.3.0中不再需要。手动删除它（我们不会自动编辑用户设置）。看 [`docs/migration/rforge-mcp-deprecation.md`](docs/migration/rforge-mcp-deprecation.md) 对于完整的迁移表。

### 从rforge编排器迁移（历史版本，v1.3.0之前）

> 仅当您跳过v1.2.x并且来自更旧的版本时才相关
> `rforge-orchestrator` 设置。v1.3.0不使用任何MCP服务器，因此
> 最终状态只是：完全删除这些条目。

如果你 `~/.claude/settings.json` 有a `rforge-orchestrator` 或 `rforge-mcp` 进入下 `mcpServers`, **删除它**:

// Delete BOTH of these patterns if present: { "mcpServers": { "rforge-orchestrator": { ... }, "rforge-mcp": { ... } } }

在v1.3.0+版本中，该插件完全通过进程内运行 `lib/` 模块——无需配置MCP服务器。插件通过以下方式加载 `/plugin install rforge`；没有 `settings.json` 必须输入。

有关完整的过渡叙述，请参阅 [`docs/migration/rforge-mcp-deprecation.md`](docs/migration/rforge-mcp-deprecation.md).

## 模式识别

编排器会自动检测您正在做什么：

|您的请求|模式|使用的工具|
|-------------|---------|------------|
|“更新算法”|CODE_CHANGE|影响、测试、文档、健康状况|
|“添加功能”|NEW_function|检测、测试、文档|
|“修复bug”|bug_Fix|测试，影响|
|“更新文档”|文档|文档，检测|
|“版本2.1.0”|发布|健康、影响、测试、文档|

## 输出示例

### 快速分析

⚡ Quick analysis running... ✅ Done! (8.2 seconds)

📊 QUICK SUMMARY: ✅ Impact: 2 packages (MEDIUM) ✅ Tests: 187/187 passing ⚠️ Docs: NEWS.md needs update ✅ Health: 87/100 (B+)

### 全面分析

🎯 IMPACT: MEDIUM • 2 packages affected (mediate, sensitivity) • Estimated cascade: 4 hours

✅ QUALITY: EXCELLENT • Tests: 187/187 passing (94% coverage) • CRAN: Clean

📝 MAINTENANCE: 2 items • NEWS.md needs entry • Vignette example outdated

📋 NEXT STEPS: 1. Implement changes (3 hours) 2. Auto-fix documentation 3. Run cascade for dependents

## 建筑

┌─────────────────────────────────────┐ │ Claude Code Session │ │ │ │ ┌───────────────────────────────┐ │ │ │ RForge Orchestrator Plugin │ │ │ │ │ │ │ │ • Pattern Recognition │ │ │ │ • Tool Selection │ │ │ │ • Parallel Execution │ │ │ │ • Progress Display │ │ │ │ • Results Synthesis │ │ │ └───────┬───────────────────────┘ │ │ │ │ └──────────┼──────────────────────────┘ │ Parallel python3 -m lib.* calls ↓ ┌──────┴──────┬──────┬──────┐ ↓ ↓ ↓ ↓ [discovery] [deps] [status] [init] ↓ ↓ ↓ ↓ (8s) (5s) (3s) (7s) │ │ │ │ └─────────────┴──────┴──────┘ │ ↓ Results synthesized by orchestrator

## 演出

|模式|工具|时间|用例|
|------|-------|------|----------|
|快速|4个快速工具|~10s |状态检查|
|分析|4快速+综合|~30秒|日常开发|
|彻底|背景R|2-5m|预发布|

**节省时间：** 并行执行=比顺序执行快4倍！

## ADHD友好设计

1. **快速反馈** -结果以秒为单位，而不是以分钟为单位
1. **清晰的结构** -一致的输出格式
1. **视觉进度** -看看发生了什么
1. **可操作的** -始终提供后续步骤
1. **可中断的** -可以随时取消/恢复
1. **增量** -完成后的结果流

## 故障排除

**“python3:找不到命令”**

Verify Python 3.10+ is on PATH

python3 --version

macOS: install via Homebrew

brew install python@3.12

**“未检测到包”**

Run from package directory

cd /path/to/package

Or specify path explicitly

/rforge:analyze --package /path/to/package

**“分析太慢”**

- 使用 `/rforge:quick` 快速状态
- 使用 `/rforge:analyze` 用于平衡速度/深度
- 仅限使用 `/rforge:thorough` 需要时

## 配置

插件设置 `plugin.json`:

{ "settings": { "default_mode": "quick", // quick, analyze, or thorough "parallel_execution": true, // Run tools in parallel "show_progress": true, // Show progress bars "auto_synthesize": true // Auto-generate summary } }

## 发展

**插件结构：**

~/.claude/plugins/rforge/ ├── .claude-plugin/ │ ├── plugin.json # Plugin manifest (v1.3.0) │ ├── marketplace.json # Marketplace install metadata │ ├── config.json # User-tunable options (CRAN mirror, etc.) │ ├── hooks/ │ │ └── pretooluse.py # R-aware Write/Edit guard (4 rules) │ └── skills/ │ └── validation/ │ └── description-sync.md # DESCRIPTION ↔ NEWS.md drift check ├── commands/ # 16 slash commands (/rforge:*) ├── agents/ │ └── orchestrator.md # Pattern recognition + delegation ├── lib/ # Pure-Python analysis modules │ ├── discovery.py # Package detection + ecosystem layout │ ├── deps.py # Dependency graph + impact │ ├── status.py # DESCRIPTION + .STATUS health snapshot │ ├── init.py # ~/.rforge/context.json initializer │ └── formatters.py # Output formatting helpers └── docs/ # User-facing docs

## 贡献

改进思路：

- \[\]添加缓存以进行重复分析
- \[\]跟踪用户对工具选择的偏好
- \[\]添加更多图案类型
- \[\]改进时间估计
- \[\]添加结果导出（markdown、JSON）

## 许可证

麻省理工学院

## 链接

- v1.3.0吸收了之前的 `rforge-mcp` 原型（仅限本地，从未发布到GitHub或npm）。看 [`docs/migration/rforge-mcp-deprecation.md`](docs/migration/rforge-mcp-deprecation.md) 对于移民叙事。
- 克劳德代码：https://claude.com/code
- 文件：见 `docs/` 文件夹

______________________________________________________________________

**版本：** 0.1.0
**状态：** 积极开发
**兼容性：** 克劳德代码0.1.0+