xrk-project-overview

当需要从整体理解 XRK-AGT 的架构、目录、运行流程和技术栈时使用。

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/sunflowermm/XRK-AGT --skill xrk-project-overview

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

name	xrk-project-overview
description	当需要从整体理解 XRK-AGT 的架构、目录、运行流程和技术栈时使用。

定位与分层：docs/底层架构设计.md（架构单一事实源）
启动链：docs/startup.md
目录树：PROJECT_OVERVIEW.md、docs/README.md
Node 26：docs/node-26-runtime.md、skill xrk-node-runtime（写 Core 服务端必读）
Core www：skill xrk-www-compat（浏览器兼容层 / 内联垫片）

定位：融合智能体业务逻辑的通用后端 — Runtime 在 src/，业务在 core/。
分层：AgentRuntime（Runtime）→ 基础设施（Loader/基类）→ Tasker / 事件 → Core 业务。
业务在 core/<名>/(plugin|http|stream|tasker|events|commonconfig|www/<app>)；src/ 仅基础设施与工厂。
启动：见 docs/startup.md（app.js → bootstrap → start.js → agent-runtime.js）。
Node ≥ 26.0（package.json engines）；包管理仅 pnpm。

编码约定见 skill xrk-node-runtime 与 docs/node-26-runtime.md（本 skill 不重复禁止项表）。写 www/ 见 xrk-www-compat。

类型	路径
业务	`core/<core>/` 各子目录
基类/加载器	`src/infrastructure/`
工具	`src/utils/`（`bootstrap.js`、`process-signals.js`、`exec-async.js` 等）
工厂	`src/factory/`
前端	`core/<core>/www/<app>/`
浏览器兼容	`core/system-Core/www/xrk/modules/web-compat.js`