이식 가능한 에이전트 skill

SQLBraid는 skills/sqlbraid/에 공식 Agent Skill을 제공합니다. 이 skill은 일반적인 SQL 지식만으로 안전하게 추론할 수 없는 SQLBraid 고유 규칙, 즉 결과 종류, 값과 구조적 보간의 구분, 물리 연결 범위, 어댑터 capability, 메타데이터 증거, 코드 생성을 에이전트에 알려줍니다.

표준 skills CLI로 설치할 수 있습니다.

npx skills add Clickin/SQLBraid --skill sqlbraid

skill은 애플리케이션 개발을 중심으로 구성됩니다.

• 일반 SQL을 ORM이나 query-builder DSL로 바꾸지 않고 그대로 유지합니다.
• sql.rows, sql.command, sql.call로 결과 의도를 명시합니다.
• 일반 보간은 값 바인딩으로 취급하고, 식별자나 SQL 구조에는 명시적인 structural helper를 사용합니다.
• 트랜잭션과 세션의 pinning, 선택한 어댑터가 실제로 제공하는 capability를 보존합니다.
• 프로젝트의 의미론적 증거가 있으면 SQLBraid LSP 또는 JSON CLI inspection을 사용합니다.
• 메타데이터는 완전한 카탈로그가 아니라 개방 세계의 긍정적 증거로 취급합니다.
• 생성된 파일을 직접 수정하지 않고 설정이나 메타데이터를 고친 뒤 sqlbraid codegen --check를 실행합니다.

세부 query, runtime, tooling 규칙은 skills/sqlbraid/references/ 아래에 함께 제공되므로 호환 에이전트가 필요한 작업에서만 추가 context로 읽을 수 있습니다.

SQLBraid에는 MCP가 필요하지 않습니다. LSP, CLI inspection, portable skill은 서로 독립적인 통합 경로입니다.

skill을 설치하지 않은 에이전트를 위해 문서 사이트는 llms.txt 인덱스와 각 문서의 raw Markdown도 제공합니다. 이 산출물은 문서 빌드와 함께 생성되므로 /latest는 현재 문서를 따르고 /v/<version>은 해당 릴리스의 불변 snapshot에 고정됩니다.

드라이버와 executor 작성자는 사용자 지정 transport를 구현하기 전에 드라이버 작성자 바인딩 가이드도 읽으세요.