research/roocodeinc-roo-code/deep-dive.md

# RooCodeInc/Roo-Code 深度研究

## 研究级别

- 当前级别：L2 结构深度研究。
- 研究对象：`RooCodeInc/Roo-Code`。
- 证据来源：本目录 `raw/` 下的 GitHub 元数据、release 快照、规则文件和本地仓库工作树。
- 观察日期：2026-07-03。

## L2 结论

`RooCodeInc/Roo-Code` 的核心价值不是当前采用，而是归档工具的生命周期样本。它曾经是一个大型
TypeScript 多 Agent 编辑器项目，仓库中保留了 `.roomodes`、`.roo/` 规则与技能、monorepo
工作区、VS Code 应用、核心包、release 资产和安全文档，但 GitHub 观测状态已经是 archived。

对本仓最重要的启发是：高星项目也必须被生命周期治理约束。已归档项目可以研究结构，不能作为
默认采用对象。

## 本地证据

- `domain.yml`：`archived: true`，最新 release 为 `v3.54.0`，研究优先级为 P3。
- `raw/repository/.roomodes`：模式定义入口。
- `raw/repository/.roo/`：Roo 规则、技能、命令和配置入口。
- `raw/repository/apps/`：应用层目录，包含 CLI、docs、VS Code 相关应用。
- `raw/repository/packages/`：包层目录，包含 core、ipc、types 等共享模块。
- `raw/repository/pnpm-workspace.yaml`：monorepo 工作区入口。
- `raw/repository/package.json`：项目脚本和依赖入口。
- `raw/repository/SECURITY.md`：安全政策。
- `raw/repository/releases/`：release 图片资产。

## 关键机制

### 显式模式和规则文件

`.roomodes` 和 `.roo/` 说明多 Agent 工具需要把模式、规则、技能和命令显式文件化。模式不是口头
提示，而是工具运行时可读取的配置资产。

### monorepo 分层

`apps/` 和 `packages/` 的拆分体现了大型工具项目的常见边界：应用入口、文档、测试环境和共享核心
能力分开维护。对本仓有启发的是“入口和核心能力要分层”，不是要复制其前端或扩展实现。

### 归档状态是硬事实

该项目 stars 很高，但已经归档。研究结论必须尊重生命周期字段：归档对象只能作为历史结构和设计
参考，不能作为活跃生态推荐。

## 可迁移模式

- 在资源治理中把 archived 设为强降级信号。
- 对 agent 工具研究记录模式文件、规则文件、技能文件和命令文件的边界。
- 为本仓 `skills/` 和 Agent 规则建立“模式、规则、技能、命令”四类概念边界。
- 研究大型工具时优先看 apps/packages 分层、脚本入口、安全文档和 release 资产。
- 对已归档项目保留替代入口或分叉观察字段。

## 对本仓的影响

该对象对本仓的直接影响是治理规则，而不是工具采用：

- `assets/external-resources/` 应把归档状态作为资源生命周期字段。
- `research/` 对 archived 项目应默认降级为设计参考。
- `skills/` 可借鉴显式模式/规则/命令边界，但不复制其运行时。
- 资源推荐页需要区分“可采用工具”“历史参考”“已归档设计样本”。

## 风险和待验证项

- 已归档状态意味着安全、兼容性和生态活跃度都不能默认满足。
- 仓库规模大，本轮只做结构研究，没有运行构建、测试或扩展。
- 该项目具体实现和当前主流工具生态可能已经分叉或迁移。
- 本仓是知识库，不应引入 Roo-Code 的 UI、runtime 或 monorepo 复杂度。

## 下一步 L3 验证任务

- 在资源 schema 中增加 archived、forked、replaced_by 和 last_verified 字段。
- 为研究域契约增加 archived 项目处理规则：只能作为参考，不能进入默认推荐。
- 对 `.roomodes`、`.roo/rules`、`.roo/skills` 做一次概念边界拆解，迁移到 Agent 规则设计文档。
- 查找当前活跃替代项目或分叉，并建立后续观察队列。