@hile/core SKILL

本文档面向代码生成器与维护者，目标是确保生成代码严格符合容器语义。

1. 强约束（必须遵守）

1. 服务必须使用 async (shutdown) 形态定义。
2. 只能通过 defineService / container.register 产出服务对象。
3. 只能通过 loadService / container.resolve 获取服务实例。
4. 外部资源创建后必须立即注册 shutdown。
5. 禁止在模块顶层缓存 await loadService(...) 结果。
6. 依赖服务必须在服务函数内部加载。
7. 多个 teardown 默认按 LIFO 顺序执行。
8. container.shutdown() 必须执行所有已通过 shutdown(fn) 注册的回调；在 shutdown 进行中才完成启动并调用 curDown 的服务，也会在让出一次事件循环后被关掉（避免竞态漏关）。

2. 生命周期与超时约束

容器生命周期：init -> ready -> stopping -> stopped。