name	xrk-coding-style
description	编写或审查 core/src 代码时的写法与性能规范（全局裸名、状态、I/O、异步、HTTP）。改 Core 前必读。

业务 core/ — 裸名 AgentRuntime/msgSegment，勿 global.；HTTP 用 req.agentRuntime + HttpResponse（success 对象拍平约定见 skill xrk-http-api）
类字段存 Map/缓存，constructor 只 super() + 固定配置
热路径 fs/promises，批加载 forEachBatch，出站 fetch + AbortSignal.timeout（服务端；浏览器 Core www 见 xrk-www-compat）
错误 normalizeError，Shell #utils/exec-async.js
有 package.json 的子 Core 不用 # 别名
改 core/*/www：读 xrk-www-compat（/xrk→./web-compat.js；产品页只内联；勿用根名 shared）

改代码前对照 docs/coding-style.md 文末清单 + .cursor/rules/xrk-dev-requirements.mdc。

Más de este repositorio

mismo repositorio

当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。

当你需要开发或排查 HTTP API（core/*/http/*.js）、理解 HttpApi 基类、HttpApiLoader、业务层约定时使用。

编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。浏览器环境 ≠ Node 26。

当你需要快速理解 system-Core 提供哪些 HTTP API/工作流/插件/Tasker/Web 控制台能力，或定位某个模块在哪实现时使用。

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

当你需要理解 XRK-AGT 的运行时核心（AgentRuntime 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。

name	xrk-coding-style
description	编写或审查 core/src 代码时的写法与性能规范（全局裸名、状态、I/O、异步、HTTP）。改 Core 前必读。

业务 core/ — 裸名 AgentRuntime/msgSegment，勿 global.；HTTP 用 req.agentRuntime + HttpResponse（success 对象拍平约定见 skill xrk-http-api）
类字段存 Map/缓存，constructor 只 super() + 固定配置
热路径 fs/promises，批加载 forEachBatch，出站 fetch + AbortSignal.timeout（服务端；浏览器 Core www 见 xrk-www-compat）
错误 normalizeError，Shell #utils/exec-async.js
有 package.json 的子 Core 不用 # 别名
改 core/*/www：读 xrk-www-compat（/xrk→./web-compat.js；产品页只内联；勿用根名 shared）

改代码前对照 docs/coding-style.md 文末清单 + .cursor/rules/xrk-dev-requirements.mdc。