Community코딩 & 개발github.com

lisper

엄격한 Common Lisp 및 Emacs Lisp 코드 검토와 생성을 위한 스킬입니다. 경고 없는 컴파일, 구조화된 조건, 위생적인 매크로, 순수 함수형 코어, 렉시컬 바인딩 규율, 의미적 술어, 문서화된 심볼, 비파괴적 리스트 의미론을 보장합니다. Common Lisp 또는 Elisp 작업에서 모델 완전성, 매크로 위생, 조건/재시작 설계, 버퍼/프로세스 경계 격리, checkdoc/package-lint/sblint 준수, 코드 크기 제한이 필요할 때 사용하세요.

lisper란 무엇인가요?

이 스킬은 Common Lisp와 Emacs Lisp 코드의 품질을 엄격하게 유지하도록 설계된 AI 어시스턴트 규칙 집합입니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트가 Lisp 코드를 생성하거나 검토할 때 사용됩니다. 핵심 원칙은 코드가 모델을 정확히 표현하고, 고차 함수를 우선 사용하며, 매크로는 평가 제어에만 사용하고, 순수 변환과 부수 효과를 분리하며, 렉시컬 스코프를 기본으로 하고, 불변성과 명시적 타입을 준수하는 것입니다. 또한 조건 시스템을 구조화하고, 문서화와 네임스페이스 규칙을 따르며, 자원 수명을 동적 범위 내에서 관리하고, 코드 크기와 구조에 대한 명확한 기준을 제시합니다. 이 스킬은 경고 없는 컴파일, 위생적인 매크로, 의미적 술어 사용, 모델 완전성 유지, 검증 가능한 품질 기준을 통해 Lisp 코드의 신뢰성과 유지보수성을 높이는 데 중점을 둡니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RyanKung/Lisper/tree/master

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

lisper은(는) 무엇을 하나요?

작동 규칙

이 스킬을 일련의 주장(assertions)으로 사용하세요. 각 주장을 충족, 위반, 또는 사용자 제약에 의해 명시적으로 연기된 것으로 취급하세요. 취향 주장보다는 정확한 코드 사실을 선호하세요. 주장을 참으로 만드는 패키지, 심볼, 구조체, 조건, 매크로 확장, 불변 조건, 테스트 또는 부수 효과 경계를 명시하세요.

사실을 진술하세요. 증인을 명명하세요. 취향을 논하지 마세요.

Common Lisp 또는 Emacs Lisp 코드에 대해 보고할 때는 짧은 선언문으로 작성하세요:

  • 불변 조건은 생성자에 있습니다.
  • 동적 범위는 unwind-protect에 의해 제한됩니다.
  • 매크로가 평가 순서를 누출합니다.
  • 조건이 구조화되어 있습니다.
  • 파괴적 리스트 연산이 호출자 구조를 변이시킵니다.
  • 술어가 노출되었습니다.
  • 컴파일러 경고가 남아 있습니다.
  • 버퍼 효과가 순수 코어로 누출됩니다.

주장

  1. 코드는 모델을 그림으로 나타냅니다. S-표현식은 텍스트 이전에 구문 트리입니다. 문제의 모든 실제 상태를 보존하세요. 심볼, 태그된 구조체 (defstruct / cl-defstruct), CLOS 클래스, 또는 명시적 생성자가 있는 대수적 alist/plist를 사용하세요. 의미적으로 사용되지 않는 차이점만 지우세요.

  2. 고차 함수는 매크로가 다시 쓰기 전에 합성됩니다. Lisp는 람다 계산법이 먼저입니다: 함수는 일급 값이고, 클로저는 렉시컬 환경을 전달하며, 커링(apply-partially 또는 (lambda (x) ...) 반환)은 다중 매개변수 연결을 대체합니다. 동일한 구조가 두 번 나타나면 검사하고, 세 번 나타나면 고차 결합자, 커리된 클로저 또는 제네릭 함수로 추상화하세요. 절대 10개의 인수를 가진 절차적 헬퍼를 사용하지 마세요. 매크로는 평가를 제어하거나, 렉시컬 심볼을 바인딩하거나, 컴파일 타임 보일러플레이트를 제거하기 위해서만 도입하세요. 모든 매크로는 값 인수를 최대 한 번, 왼쪽에서 오른쪽 순서로 평가하고, gensym / make-symbol (with-gensyms)로 임시 변수를 바인딩해야 합니다.

  3. 순수 데이터 변환은 이미지의 가변 세계 밖에 남아 있어야 합니다. 명령형 let + setq + push + nreverse 루프보다는 catamorphism(cl-reduce / seq-reduce), 동형 매핑(mapcar / seq-keep), 술어 파이프라인(seq-filter)을 선호하세요. 순수한 심볼/리스트/구조체 변환을 버퍼 변이, 프로세스 IO, 파일 시스템 상태, 네트워크 스트림, 타이머 및 전역 스페셜 (*earmuffs*)과 분리하세요. 코어 함수는 값을 받아 값을 반환합니다. 호스트 효과는 명명된 경계 함수에 남아 있습니다.

  4. 렉시컬 스코프는 기본 법칙입니다. 모든 Emacs Lisp 파일은 1번째 줄에 ;; -*- lexical-binding: t; -*-로 시작해야 합니다. Common Lisp 또는 Emacs Lisp의 모든 동적 스페셜 변수는 *earmuffs*(또는 CL 상수의 경우 +plus-signs+)를 착용하고, setq / setf로 전역적으로 변이하기보다는 let으로 동적으로 다시 바인딩해야 합니다. 단, 전역 구성을 변경하는 것이 명시적 계약인 경우는 예외입니다.

  5. 불변 조건은 명제입니다. 불변 조건을 먼저 타입(satisfies를 사용한 deftype, ftype 선언, defstruct :type 슬롯)으로 표현하고, 두 번째로 스마트 생성자(:constructor), 세 번째로 런타임 단언(check-type / cl-check-type), 네 번째로 테스트, 마지막으로 주석으로 표현하세요. 생성자는 구조체가 슬롯 불변 조건을 충족한다는 증명입니다.

  6. 조건은 원시 문자열이 아닌 대수적 사실입니다. 명시적 조건 계층 구조를 정의하세요(Common Lisp에서는 define-condition, Emacs Lisp에서는 define-error). 구조화된 조건을 error / cerror / signal로 신호하여 호출자가 오류 메시지 하위 문자열을 일치시키지 않고 handler-case, handler-bind 또는 condition-case로 처리할 수 있게 하세요. 복구 정책이 호출자에 속하고 메커니즘이 저수준 함수에 속할 때는 Common Lisp 재시작(restart-case)을 사용하세요.

  7. Cons-셀 소유권은 의미론적 주장입니다. 함수의 이름과 docstring이 명시적으로 파괴적 동작(nreverse, nconc, delete, sort, cl-delete, 공유 cons-셀에 대한 setf)을 선언하지 않는 한, 입력 리스트, 트리 및 시퀀스를 불변으로 취급하세요. 따옴표 붙은 리터럴('(a b c))이나 빌린 호출자 리스트에 파괴적 연산을 절대 적용하지 마세요. 변이가 시작되는 경계에서만 구조체를 복제하세요(copy-list, copy-tree, copy-sequence).

  8. 품질은 입증되어야 하지 주장되어서는 안 됩니다. 바이트 컴파일러 경고 0개, checkdoc / package-lint 오류 0개, SBCL STYLE-WARNING 진단 0개는 최소 기준일 뿐입니다. 순수 변환, 매크로 확장 법칙, 경계 입력, 비지역 탈출 시 동적 정리, 수정된 회귀에 대한 ERT(ert-deftest) 또는 FiveAM/Rove/Parachute 테스트를 추가하세요. 테스트 이름은 그것이 입증하는 명제를 나타냅니다.

  9. 문서화와 네임스페이스 접두사는 공개 계약의 일부입니다.

    • Common Lisp: 전체 :use 오염 없이 명시적 패키지(defpackage / uiop:define-package)를 정의하고, :cl 이상을 사용하지 마세요. 모든 내보낸 함수, 매크로, 클래스, 변수 및 조건을 문서화하세요.
    • Emacs Lisp: 모든 공개 심볼에 <package>- 접두사를, 모든 내부 심볼에 <package>-- 접두사를 붙이세요. 첫 번째 줄이 완전한 문장이고 매개변수 참조가 UPPERCASE인 checkdoc-준수 docstring을 작성하세요. Package-Requires와 ;;; Commentary: 헤더를 정확하게 선언하세요.
  10. 리소스 수명은 동적 범위로 제한됩니다. 수동 할당과 정리를 오류 가능성이 있는 표현식과 절대 짝짓지 마세요. 모든 임시 버퍼 변경, 포인트 이동, 파일 핸들, 프로세스, 소켓 또는 훅 설치는 unwind-protect(또는 with-open-file, with-temp-buffer, save-excursion, save-restriction, save-match-data)로 감싸세요. 비지역 탈출(throw, return-from, signal, error)은 전역 상태와 버퍼를 깨끗하게 남겨야 합니다.

  11. 크기와 괄호 레이아웃은 구조적 신호입니다. 각 소스 파일을 1000줄 미만으로, 각 defun / defmacro 실행 가능 본문(docstring 및 declare 양식 제외)을 80줄 미만으로 유지하세요. docstring을 자르거나, 설명 주석을 삭제하거나, 여러 개의 순차적 부수 효과 양식을 한 줄에 밀어넣어 줄 수 제한을 우회하지 마세요. 닫는 괄호 )))를 후행 줄에 단독으로 배치하지 마세요. 표준 Lisp 양식 의미론에 따라 들여쓰기하세요(모든 Elisp 매크로에 (declare (indent ...)) 선언). 파일과 함수를 임의의 줄 수 조각이나 모호한 utils 버킷이 아닌 도메인 명제로 분할하세요.

  12. 논리에는 이름이 필요합니다. 도메인 명제를 표현할 때 호출 지점에서 원시 car/cdr/nth 체인(cadddr), 중첩된 assoc/plist-get 연결, 또는 다중 절 and/or/not 표현식을 노출하지 마세요. 명명된 접근자와 -p 또는 p로 끝나는 의미적 술어(예: order-matchable-p, same-principal-p, session-active-p)를 정의하세요.

모델 완전성

패키지, 구조체 및 함수를 선택하기 전에 코드를 일관되게 만드는 공식 모델의 이름을 지정하세요.

매크로 및 구문 변환:

  • 매크로는 구문에서 구문으로의 컴파일러 패스입니다: $\text{AST}{\text{surface}} \to \text{AST}{\text{core}}$.
  • 표면 문법(비구조화 람다 리스트), 바인딩 규율, 모든 하위 형식의 평가 다중성 및 대상 확장을 지정하세요.
  • macroexpand-1 / macrostep으로 위생을 확인하세요: 자유 심볼 캡처 없음, 효과적인 인수의 다중 평가 없음, 런타임 eval 없음.
  • 매크로가 정의로 확장되는 경우, 호스트 컴파일러와 검사기를 위해 소스 위치와 선언(declare, docstring 배치)을 보존하세요.

대화형 상태, 버퍼 및 동시 프로세스:

  • 대화형 시스템은 버퍼 또는 스레드 이전의 상태 전이 관계입니다.
  • 도메인 상태 값을 렌더링 버퍼(Emacs UI) 또는 작업자 스레드/소켓(CL/Emacs 프로세스)과 분리하세요.
  • 비동기 프로세스 출력(Emacs 프로세스 필터/센티넬, CL 스레드/채널)을 전체 상태 전이를 공급하는 개별 이벤트로 모델링하세요: $\text{State} \times \text{Event} \to (\text{State} \times \text{List}[\text{Effect}])$.
  • Emacs Lisp의 프로세스 필터는 임의의 청크 경계를 수신할 수 있습니다. 도메인 이벤트를 디스패치하기 전에 불완전한 프레임을 명시적으로 버퍼링하고 파싱하세요.
  • 타이머, 센티넬 또는 콜백이 비동기적으로 실행될 때 버퍼-로컬 상태(defvar-local)를 종료된 버퍼(buffer-live-p)에 대해 보호하세요.

조건, 재시작 및 비지역 제어:

  • 무엇이 잘못되었는지(조건 데이터)와 복구 방법(CL의 재시작, Elisp의 구조화된 핸들러) 및 어떤 복구를 선택할지(외부 정책 핸들러)를 분리하세요.
  • 정확히 무시된 조건 유형이 좁혀지고 대체 값이 유효한 도메인 상태가 아닌 한, 베어 (ignore-errors ...) 또는 (condition-case nil ... (error nil))로 조건을 삼키지 마세요.

형식 논리 주석

ftype, deftype 또는 cl-defstruct가 완전히 표현하지 못하는 증명 의무를 명확히 할 때만 형식 주석을 사용하세요. 표준 Lisp 주석 계층 구조(;;;; 섹션, ;;; 최상위, ;; 본문 정렬, ; 여백)에 따라 함수/형식 내부에서는 ;;를, 최상위 레벨에서는 ;;;를 사용하세요.

;;; Pre: (and ( <= 0 start end (length sequence)) (listp sequence))
;;; Post: (and (equal result (subseq sequence start end))
;;;            (not (eq result sequence)))
(defun slice-copy-checked (sequence start end)
  "Return a fresh subsequence of SEQUENCE from START to END."
  (check-type sequence list)
  (assert (<= 0 start end (length sequence)))
  (copy-list (subseq sequence start end)))

;;; Invariant: (null (intersection (work-set-pending ws) (work-set-completed ws) :test #'equal))
;;; Preservation: `work-set-complete' removes ID from `pending' before consing onto `completed'.
(defstruct (work-set (:copier nil))
  (pending nil :type list)
  (completed nil :type list))

;;; Law: (equal (decode-packet (encode-packet x)) x) for all valid packet structs X.

다음 양식을 선호하세요:

  • Pre: 호출자가 충족해야 하는 조건.
  • Post: 함수가 보장하는 조건, 신선함/공유(eq 대 equal) 포함.
  • Invariant: 구조체/버퍼/세션 연산 전반에 걸쳐 보존되는 명제.
  • Law: 테스트가 입증해야 하는 대수적 또는 매크로 확장 관계.
  • Preservation: 전이 또는 unwind-protect 형식이 불변 조건을 참으로 유지하는 이유.

의미적 술어

도메인 논리를 선언적으로 표현하기 위해 Lisp -p / p 규칙을 따르는 명명된 술어를 사용하세요:

  • 단일 단어 어근(Common Lisp 규칙): evenp, Orderp -> orderp, validp (또는 Elisp에서는 패키지 접두사 심볼에 대해 일관되게 -p).
  • 하이픈 연결 어근(CL 및 Elisp 모두): order-matchable-p, same-principal-p, lispm-session-live-p.

선호:

(when (order-matchable-p order resting-order)
  (match-order book order resting-order))

(when (same-principal-p actor owner)
  (grant-access actor resource))

피하세요:

(when (and (not (eq (order-side order) (order-side resting-order)))
           (>= (order-price order) (order-price resting-order))
           (plusp (order-quantity order)))
  (match-order book order resting-order))

(when (and (equal (principal-id actor) (principal-id owner))
           (eq (principal-realm actor) (principal-realm owner)))
  (grant-access actor resource))

또한 도메인 논리에서 깊은 위치적 리스트 접근((cadddr record), (nth 4 item))을 피하세요. defstruct / cl-defstruct 또는 명명된 접근자 함수를 정의하여 호출 지점에서 cons 토폴로지 대신 도메인 개념을 읽도록 하세요.

구현 규율

도메인에서 시작하고 방언의 함수적 의미론을 존중하세요.

  • 커링, 부분 적용 및 결합자:
    • 호출자의 let* 바인딩을 미러링하는 6개 이상의 위치 매개변수를 가진 절차적 헬퍼를 추출하거나, let*를 일회용 foo--part-1 / foo--part-2 서브루틴으로 슬라이싱하여 긴 함수를 분해하지 마세요.
    • 로컬 let*가 이미 제공하는 렉시컬 스코프를 시뮬레이션하기 위해 "가짜 커링"(예: (lambda (getter-fn) (lambda () ...)))을 도입하지 마세요.
    • 대신, 진정한 도메인 불변 조건을 렉시컬 클로저로 커리하고((defun domain--matcher (query role) (lambda (event) ...)) 또는 (apply-partially #'fn fixed-arg)), 작은 단항/이항 변환을 합성하세요: $f \circ g = \lambda x., f(g(x))$.
    • 반복적인 명령형 폴링, 사이클-안전 그래프 순회 또는 리소스 브래킷 패턴을 단계 함수 (funcall step item)를 받아 값을 반환하는 고차 결합자로 대체하세요.
  • 동등성 정밀도: eql(숫자/문자), equal(구조적 문자열/리스트) 또는 equalp / 도메인 동등성이 필요한 곳에 eq를 절대 사용하지 마세요. 타입의 동등 관계와 일치하는 가장 엄격한 동등성 술어를 선택하고, 키가 문자열 또는 복합 값일 때 assoc, member, gethash, remove, cl-find에 명시적으로 :test #'equal을 전달하세요.
  • Emacs Lisp 특이사항:
    • 1번째 줄은 ;; -*- lexical-binding: t; -*-를 선언해야 합니다.
    • cl-lib(cl-defstruct, cl-loop, cl-destructuring-bind, cl-check-type)를 사용하고, 더 이상 사용되지 않는 런타임 cl 패키지는 사용하지 마세요.
    • 모든 포인트, 마크, 내로잉 및 매치-데이터 부수 효과를 save-excursion, save-restriction 및 save-match-data로 보호하세요.
    • 비동기 경계를 넘어 current-buffer를 가정하기보다는 버퍼 전달 또는 명시적 (with-current-buffer buf ...)를 선호하세요.
    • 매크로에 (declare (indent ...) (debug ...))를 주석으로 달아 들여쓰기와 Edebug 계측이 자동으로 작동하도록 하세요.
  • Common Lisp 특이사항:
    • SBCL이 컴파일 타임 타입 추론 및 완전성 검사를 수행할 수 있도록 공개 도메인 함수에 대해 (declaim (ftype (function (...) ...) name))을 선언하세요.
    • 처리되지 않은 변형이 즉시 구조화된 타입 오류를 신호하도록 개방형 case / typecase 대신 etypecase / ecase / ctypecase를 사용하세요.
    • 리더 테이블 오염 및 내보내지 않은 심볼 누출(pkg::internal-sym)을 피하세요.
    • 깨끗한 종속성 DAG를 가진 ASDF 패키지-추론 또는 명시적 직렬 :components를 선호하세요.
  • 프로덕션 경로에서 금지된 구성:
    • 함수 디스패치 또는 코드 구성을 위한 런타임 eval 금지(funcall, apply 또는 컴파일 타임 매크로 사용).
    • 선언되지 않은 자유 변수에 대한 동적 setq 금지.
    • 따옴표 붙은 리터럴 또는 소유되지 않은 호출자 리스트에 대한 제자리 변이(nconc, nreverse, delete, sort) 금지.

관련 스킬