hile

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hile AI Development Skill

Hile AI开发技能

Use this skill to generate or edit Hile applications with the current

@hile/*

APIs. Keep the body lean; load only the relevant references for the task.

使用此技能借助当前的

@hile/*

API生成或编辑Hile应用。保持内容精简；仅加载与任务相关的参考资料。

Required Workflow

必备工作流程

Read
```
references/package-map.md
```
to choose the package card and recipe for the user request.
Read
```
references/conventions.md
```
before editing code.

Start from the closest complete example in

references/packages/*.md

references/recipes/*.md

Read
```
references/anti-patterns.md
```
before finalizing.
If docs conflict with source code or tests in a Hile repository, trust source/tests and update the docs.

阅读
```
references/package-map.md
```
，为用户需求选择合适的包卡片和方案。
编辑代码前阅读
```
references/conventions.md
```
。

从

references/packages/*.md

或

references/recipes/*.md

中最接近的完整示例开始。

最终定稿前阅读
```
references/anti-patterns.md
```
。
如果文档与Hile仓库中的源代码或测试存在冲突，以源代码/测试为准并更新文档。

High-Risk Rules

高风险规则

Do not call
```
loadService()
```
at module top level; call it inside boot services, controllers, models, message handlers, queue workers, or functions.
Load
```
@hile/http
```
controllers before
```
http.listen()
```
in new code.
```
@hile/http
```
Zod validation validates only; parse again when the handler needs coerced data.
```
MessageModem._send()
```
and
```
Application.call()
```
return promises. Await them directly.
Redis lock, idempotency, rate limit, cache, and queue helpers are not exactly-once guarantees.
Queue handlers and retryable HTTP/RPC handlers with side effects need idempotency or a stronger business uniqueness wall.

不要在模块顶层调用
```
loadService()
```
；应在启动服务、控制器、模型、消息处理器、队列工作器或函数内部调用。
在新代码中，需在
```
http.listen()
```
之前加载
```
@hile/http
```
控制器。
```
@hile/http
```
的Zod验证仅做验证；当处理器需要强制转换的数据时，需重新解析。
```
MessageModem._send()
```
和
```
Application.call()
```
返回Promise，需直接使用await等待。
Redis锁、幂等性、速率限制、缓存和队列助手不提供精确一次的保证。
带有副作用的队列处理器和可重试的HTTP/RPC处理器需要幂等性或更强的业务唯一性保障。

Reference Router

参考路由

Always begin with:

```
references/package-map.md
```
: choose what package solves the task.
```
references/conventions.md
```
: lifecycle, ESM, file layout, and response conventions.
```
references/anti-patterns.md
```
: failure modes to avoid before finalizing.

Then load the relevant package card or recipe:

```
references/anti-patterns.md
```
```
references/conventions.md
```
```
references/index.md
```
```
references/package-map.md
```
```
references/packages/core-lifecycle.md
```
```
references/packages/create-hile.md
```
```
references/packages/http-next.md
```
```
references/packages/http.md
```
```
references/packages/infrastructure.md
```
```
references/packages/mcp.md
```
```
references/packages/messaging-micro.md
```
```
references/packages/model-context.md
```
```
references/packages/reactivity.md
```

references/packages/redis-reliability.md

```
references/packages/reloader.md
```
```
references/packages/rsc.md
```

references/recipes/http-api-model-typeorm.md

references/recipes/http-next-fullstack.md

references/recipes/mcp-distributed-gateway.md

references/recipes/micro-registry-read-apis.md

references/recipes/micro-rpc-message-loader.md

references/recipes/new-project-scaffold.md

references/recipes/queue-worker-idempotency.md

references/recipes/redis-cache-singleflight.md

```
references/recipes/rsc-plugin-host.md
```
```
references/recipes/runtime-config.md
```

references/recipes/stable-runtime-reload.md

始终从以下内容开始：

```
references/package-map.md
```
：选择能解决任务的包。
```
references/conventions.md
```
：生命周期、ESM、文件布局和响应规范。
```
references/anti-patterns.md
```
：定稿前需避免的失败模式。

然后加载相关的包卡片或方案：

```
references/anti-patterns.md
```
```
references/conventions.md
```
```
references/index.md
```
```
references/package-map.md
```
```
references/packages/core-lifecycle.md
```
```
references/packages/create-hile.md
```
```
references/packages/http-next.md
```
```
references/packages/http.md
```
```
references/packages/infrastructure.md
```
```
references/packages/mcp.md
```
```
references/packages/messaging-micro.md
```
```
references/packages/model-context.md
```
```
references/packages/reactivity.md
```

references/packages/redis-reliability.md

```
references/packages/reloader.md
```
```
references/packages/rsc.md
```

references/recipes/http-api-model-typeorm.md

references/recipes/http-next-fullstack.md

references/recipes/mcp-distributed-gateway.md

references/recipes/micro-registry-read-apis.md

references/recipes/micro-rpc-message-loader.md

references/recipes/new-project-scaffold.md

references/recipes/queue-worker-idempotency.md

references/recipes/redis-cache-singleflight.md

```
references/recipes/rsc-plugin-host.md
```
```
references/recipes/runtime-config.md
```

references/recipes/stable-runtime-reload.md

Verification

验证

When editing a Hile repo, prefer the repository commands. Common checks are:

bash

pnpm run build
pnpm run test

For package publishing changes, dry-run pack representative packages and confirm

AI.md

ships with npm packages.

编辑Hile仓库时，优先使用仓库命令。常见检查如下：

bash

pnpm run build
pnpm run test

对于包发布变更，对代表性包进行干运行打包，并确认

AI.md

随npm包一同发布。