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

## 权威文档

- **主文档**：`docs/coding-style.md`（速查表 + 分节规范）
- 挂载：`docs/runtime-surface.md`
- Node API：`docs/node-26-runtime.md` · skill **`xrk-node-runtime`**
- Loader：`docs/infrastructure-shared.md`

## 30 秒记忆

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

## 审查

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