AgentSkillsCN

ts-circuit-dsl

编写并审查用于电气领域的TypeScript电路DSL，随后使用ts2scm生成规范化的SCM，并通过fmt/lint进行验证。

SKILL.md
--- frontmatter
name: ts-circuit-dsl
description: Write and review TypeScript circuit DSL for elec, then generate canonical scm with ts2scm and validate with fmt/lint.

TS Circuit DSL

Use this skill when the user wants to create or modify circuit definitions in TypeScript (examples/*.ts) for elec.

Goal

Produce valid, deterministic circuit specs in TS, then convert to canonical .scm and validate.

Required Flow

  1. •Define component templates with defineComponent(...).
  2. •Create circuit with defineCircuit({ target: "pico" | ... }).
  3. •Add instances via addPart(...).
  4. •Set component values via setPartProp(...).
  5. •Connect nets via connect(...).
  6. •Define bus constraints (currently setI2c(...) for I2C).
  7. •Export default c.toIR().
  8. •Run:
  • •npm run build
  • •node dist/src/cli.js ts2scm <input.ts> -o <output.scm>
  • •node dist/src/cli.js fmt --check <output.scm>
  • •node dist/src/cli.js lint <output.scm>

Rules

  • •Keep naming stable and explicit (U_*, R_*, C_*, net names).
  • •Do not mutate IR directly. Use builder APIs.
  • •Keep outputs deterministic by relying on canonical generator, not manual SCM edits.
  • •If lint fails, fix TS and regenerate SCM.

References

  • •API examples: references/api-patterns.md
  • •Authoring checklist: references/checklist.md