zener-language

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Zener Language

Zener语言

Use this skill as the semantics companion to
idiomatic-zener
for non-trivial
.zen
work.
将此技能作为
idiomatic-zener
的语义配套工具,用于复杂的
.zen
开发工作。

Workflow

工作流程

  1. Start from nearby workspace code. Prefer the local package's patterns before generic examples.
  2. Open only the relevant reference file:
    • references/language.md
      for modules, nets/interfaces, components,
      io()
      ,
      config()
      , utilities, and tool-managed metadata
    • references/packages.md
      for imports, workspace layout, manifests, dependencies, and
      pcb.sum
    • references/stdlib.md
      for prelude, interfaces, units, checks, utils, properties, and generics
    • references/examples.md
      for example snippets
  3. pcb doc --package <package>
    shows the public API (types, io, config) of installed packages. It returns type-level listings, not field-level details — for interface field names, check the stdlib reference above or read the source in
    .pcb/stdlib/
    .
  4. For broader toolchain semantics, consult
    ~/.pcb/docs/spec.md
    and
    ~/.pcb/docs/packages.md
    .
  5. Check exact semantics before editing when the code touches unfamiliar syntax, manifests, imports, stdlib APIs, or package interfaces.
  6. Never invent syntax, stdlib modules, interfaces, fields, or package APIs.
  1. 从本地工作区代码入手。优先采用本地包的模式,而非通用示例。
  2. 仅打开相关参考文件:
    • references/language.md
      :涵盖模块、网络/接口、组件、
      io()
      config()
      、实用工具以及工具管理的元数据
    • references/packages.md
      :涵盖导入、工作区布局、清单、依赖项以及
      pcb.sum
    • references/stdlib.md
      :涵盖预导入内容、接口、单元、检查、工具类、属性以及泛型
    • references/examples.md
      :涵盖示例代码片段
  3. pcb doc --package <package>
    命令可显示已安装包的公开API(类型、io、配置)。它返回类型级别的列表,而非字段级详情——若需查看接口字段名称,请查阅上述标准库参考文件,或阅读
    .pcb/stdlib/
    中的源代码。
  4. 如需了解更广泛的工具链语义,请查阅
    ~/.pcb/docs/spec.md
    ~/.pcb/docs/packages.md
  5. 当代码涉及不熟悉的语法、清单、导入、标准库API或包接口时,在编辑前务必确认确切语义。
  6. 切勿自创语法、标准库模块、接口、字段或包API。