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.
在进行重要的.zen文件相关工作时,请将本技能作为
idiomatic-zener
的语义配套工具使用。

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. For installed package or registry APIs, run
    pcb doc --package <package>
    instead of guessing. This skill is the canonical owner of that workflow.
  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. 仅打开相关的参考文件:
    • 若涉及模块、网络/接口、组件、
      io()
      config()
      、工具类以及工具管理的元数据,请查看
      references/language.md
    • 若涉及导入、工作区布局、清单、依赖项以及
      pcb.sum
      ,请查看
      references/packages.md
    • 若涉及预导入内容、接口、单元、检查、工具类、属性以及泛型,请查看
      references/stdlib.md
    • 若需要示例代码片段,请查看
      references/examples.md
  3. 对于已安装的包或注册表API,请运行
    pcb doc --package <package>
    命令查询,不要凭猜测操作。本技能是该工作流程的权威指南。
  4. 若需了解更广泛的工具链语义,请查阅
    ~/.pcb/docs/spec.md
    ~/.pcb/docs/packages.md
  5. 当代码涉及不熟悉的语法、清单、导入、标准库API或包接口时,编辑前请先确认确切的语义。
  6. 切勿自行创造语法、标准库模块、接口、字段或包API。

Notes

注意事项

  • Use this with
    idiomatic-zener
    for non-trivial
    .zen
    creation, editing, refactoring, or review.
  • Use
    reference-design
    for vendor and reference-circuit translation work.
  • Use
    component-search
    when the problem is finding or importing a part rather than understanding the language.
  • 在进行重要的.zen文件创建、编辑、重构或评审时,请结合
    idiomatic-zener
    使用本技能。
  • 若需进行厂商和参考电路的转换工作,请使用
    reference-design
    技能。
  • 若问题是查找或导入某个部件而非理解语言,请使用
    component-search
    技能。