altium-library

Altium 라이브러리 제작·검증

라이브러리는 한 번에 맞지 않는다. 틀리는 지점이 정해져 있어서 그걸 순서로 막는 게 핵심이다. 아래 순서는 실제로 10건의 결함이 난 세션에서 역산한 것이다. 잡히는 결함과 안 잡히는 결함이 갈렸다:

• 숫자·기준파일과 대조 가능한 것 → 검산으로 잡힌다
• 그 물건이 물리적으로 뭔지, 툴이 어떻게 그리는지 → 검산으로 안 잡힌다. 그래서 §2 와 §6 이 있다

0. 도구 분담 — 이건 안 바뀐다

하는 일	도구
생성·수정	altium_monkey (파이썬). Altium 없이 파일을 직접 쓴다
검증·조회	altium-mcp MCP. 읽기 전용으로만

altium-mcp 의 create_schematic_symbol / create_pcb_footprint 는 실행 중인 Altium 의 활성 문서에 직접 쓴다. 사용자가 열어둔 남의 라이브러리를 오염시킬 수 있고, 어느 문서가 활성인지 확실히 보장할 방법이 없다. 생성에 쓰지 마라.

파이썬은 반드시 이 인터프리터:

python

3.12 venv 다. altium-monkey 가 Requires-Python <3.13 이라 시스템 3.13 에는 안 깔린다. 패키지 추가는 uv pip install --python <위 경로> <패키지> (venv 에 pip 가 없다).

작업 폴더 — 부품 하나 = 폴더 하나

<작업폴더> 는 라이브러리 작업을 모아 두는 곳이고 프로젝트 폴더와 별개다. 스킬 폴더 안에 만들지 마라 (git pull 때 섞인다).

정해진 게 없으면 사용자에게 묻고, 답이 없으면 프로젝트 옆에 altium-lib-work/ 를 만들어 쓰고 그 경로를 알린다. 한 번 정하면 계속 거기 쌓는다.

산출물과 중간물을 한 폴더에 몰면 부품 두세 개만 늘어도 뭐가 뭔지 못 찾는다. (커넥터 하나에 파일 29개가 평평하게 쌓이는 일이 실제로 생긴다.)

<작업폴더>\
├── index.md            부품 목록·상태·공용 라이브러리 반영 여부
└── <MPN>/              폴더명은 MPN. 괄호·슬래시 등 경로에 나쁜 문자는 뺀다
    ├── build.py        생성 코드. 근거와 판단 이유가 주석에 — 이게 진실이다
    ├── out/            산출물(.PcbLib/.SchLib). 공용 라이브러리로 옮기는 건 여기서만
    ├── work/           도면 렌더, 측정 기록(measure-commands.md), 일회용 스크립트(adhoc/)
    └── check/          검증용 사본(_chk, _v2 …). 언제든 지워도 되는 것

• build.py 는 OUT = Path(__file__).parent / "out" 로 쓴다
• 도면에서 잰 명령과 중간 결과를 work/measure-commands.md 에 남긴다. clip 좌표·스케일·검산값이 없으면 나중에 재현이 안 된다
• 일회용 분석 스크립트를 부품 폴더마다 복제하지 마라. 범용화해서 이 스킬의 scripts/ 로 올리고, 부품 폴더에는 쓴 명령만 기록한다
• 새 부품을 끝내면 index.md 에 한 줄 추가한다 (산출물·상태·공용 반영 여부·미해결)

1. 이미 있는지 먼저 본다

새로 만들기 전에 기존 라이브러리를 검색한다. 심볼은 이미 있고 풋프린트만 없는 경우가 흔하다.

라이브러리 폴더 경로는 환경마다 다르다. 프로젝트 폴더 → Altium 워크스페이스 (%APPDATA%\Altium\Altium Designer {GUID}\LastWorkspace\*.DsnWrk 안에 .LibPkg 절대경로가 그대로 있다) → 사용자에게 묻는다 순으로 찾는다.

python scripts/survey_library.py <라이브러리 폴더 또는 .PcbLib/.SchLib>
python scripts/survey_library.py <폴더> --find PCN10      # 부분 문자열
python scripts/survey_library.py <폴더> --pins 96         # 핀 수로