식탁보 카탈로그에 기여해주셔서 감사합니다.
기여 방법, 파일 구성, 검증 도구 실행 방법은 README.md에 정리되어 있습니다. 이 문서는 그중에서도 기여하실 때 반드시 지켜주셔야 하는 규범을 따로 모은 것입니다.
카탈로그 조사와 변경안 작성에는 Aside와 같은 에이전트형 웹 브라우저를 권장합니다. 공식 홈페이지의 공개 설치 안내를 확인하고 기존 XML과 비교하여 변경안을 작성합니다. 대상 서비스 ID를 지정하는 요청 예시와 전체 절차는 카탈로그 최신화 안내에서 정리합니다.
조사 결과와 PR 본문에는 공식 출처 URL, 확인일, 미확인 항목을 남깁니다. 설치 안내 페이지와 직접 설치 파일 URL을 구분하고 실제 설치를 시험했는지도 함께 적습니다. XML의 출처 메타데이터는 아래 안내에 따라 선택적으로 기록할 수 있습니다. 최종 반영은 사람이 변경 근거와 검증 결과를 검토하여 결정합니다.
풀 리퀘스트를 제출하시기 전에 아래 명령으로 스키마 검증과 리소스 생성을 확인해주십시오.
dotnet run --file src/catalogutil.cs -- ./docs/ ./outputs/웹 페이지나 WSB 생성을 변경할 때에는 .NET 빌더 다음에 Python 생성기와 회귀 검사를 실행합니다. 명령과 출력 경로는 웹 카탈로그 운영 안내와 English guide에서 설명합니다. 생성 결과와 실제 Windows Sandbox 실행 시험 결과를 구분하여 PR에 기록합니다.
카탈로그 값을 확인하고 수집하실 때의 원칙은 docs/DATA_BOUNDARY.md에 정리되어 있습니다. 그중 기여자에게 직접 적용되는 두 가지는 다음과 같습니다.
제공사가 의도한 접근을 차단하거나 배포 정책을 변경한 경우, 그 차단을 우회하는 방식으로 확인한 값을 카탈로그에 반영하지 말아주십시오.
접근이 막혀 값을 확인하기 어려운 경우에는 다음과 같이 처리해주십시오.
- 확인이 불가능하다는 사실을 이슈나 풀 리퀘스트 본문에 적어주십시오.
- 해당 항목의 비활성화나 제거를 제안해주십시오.
- 제공사의 공개 안내 페이지에 정상적인 취득 경로가 안내되어 있다면 그 주소를 알려주십시오.
로그인, 결제, 회원 등급 뒤에 있는 리소스는 카탈로그의 대상이 아닙니다. 인증 없이 공개적으로 접근할 수 있는 배포 경로만 기록해주십시오.
대상 서비스의 이용 자체에 로그인이 필요한 것은 무방하지만, 설치 파일을 내려받기 위해 로그인이 필요한 항목은 수록하지 않습니다.
main 공개 카탈로그는 실제 테스트를 위해 BOK, KOSIS와 계산기의 고정 스크립트를 격리 평가 대상으로 제공합니다. 활성 항목 6개 중 기존 운영 호환 후보 3개와 스크립트 평가 후보 3개를 구분하며 스크립트 후보를 운영 호환성 통과로 승격하지 않습니다. 앱 PR #322는 아직 반영하지 않았으므로 현재 제품 대화는 설치한 스크립트의 자동 실행을 지원하지 않습니다. 실행 결과는 AppContainer 평가 보고서와 영문 보고서에 기록합니다. 이 예외는 MCP 연결이나 사용자 자격 증명 경로의 접수 재개를 포함하지 않습니다.
스킬 등록과 고정 버전 갱신에는 현재 호스트의 등재 기준과 검증 기록, English criteria and verification을 적용합니다. 현재 식탁보 대화는 shell_tool=false와 unified_exec=false를 유지하며 설치한 Python과 Node 스크립트 실행이나 MCP 서버 자동 설정을 지원하지 않습니다. 스크립트가 없는 진입점도 별도 MCP나 하위 스킬이 필수이면 실행 의존성을 기록합니다. 런타임 설치, SKILL.md 존재와 모델의 답변만으로 기능 실행 성공을 표시하지 않습니다.
PR에는 고정 원본, 필수 실행 경로, 사용 가능한 호스트 기능, 설치와 발견 결과, 실제 실행한 범위와 미검증 범위를 구분해 적습니다. 현재 호스트가 필수 단계를 지원하지 않는 후보는 사유와 XML 블록 전체를 주석으로 보존합니다. 새 활성 ID와 Source.Ref는 검증 기록의 두 언어 문서 및 src/testskills.cs의 등재 허용 목록과 함께 검토합니다. 카탈로그 검사를 통과해도 원본 스킬의 실행 성공을 뜻하지 않습니다.
사용자 API 키, 토큰이나 클라이언트 시크릿을 환경 변수로 전달받는 신규 스킬의 등록 접수를 현재 보류합니다. 환경 변수의 비밀값은 평문 노출과 자식 프로세스 상속의 위험이 있으며 식탁보의 스킬별 자격 증명 저장 및 전달 기능은 아직 구현하지 않았습니다. TableCloth #321의 대응 기능 개발과 검증을 마친 뒤 접수를 재개합니다.
사용자 키 없이 독립적으로 동작하는 기능을 제안하는 경우에는 지원 명령, 출력 범위와 추가 의존성을 명시하고 사용자 키를 사용하는 경로와 구분합니다. 기존 카탈로그 항목에 키 없는 독립 기능이 있더라도 신규 자격 증명 전달 경로는 계속 접수를 보류합니다. 시스템 또는 사용자 환경 변수, .env 파일이나 채팅 프롬프트로 키를 입력하게 하는 우회 사용법은 안내하지 않습니다. 코드, 카탈로그, 문서와 PR에는 실제 키, 토큰이나 클라이언트 시크릿을 포함하지 않으며 예시는 비밀값이 아닌 자리표시자를 사용합니다.
스킬의 등록, 제거와 실행 조건은 원격 스킬 카탈로그 안내와 영문 안내에서 설명합니다.
새로운 항목을 제출하실 때에는 그 값을 무엇을 근거로 언제 확인하셨는지 함께 남겨주시기를 권장합니다. 아래 속성은 모두 선택 사항이며, 비워두셔도 검증은 통과합니다.
| 속성 | 대상 | 내용 |
|---|---|---|
SourceUrl |
Service, Package |
확인의 근거가 된 공식 안내 페이지 주소입니다. |
VerifiedOn |
Service, Package |
확인한 날짜입니다. YYYY-MM-DD 형식으로 적어주십시오. |
VerifiedBy |
Service |
확인하신 분의 식별자입니다. GitHub 핸들을 권장합니다. |
<Service Id="ExampleBank" DisplayName="예시은행" Category="Banking" Url="https://www.example.com/"
SourceUrl="https://www.example.com/guide/security" VerifiedOn="2026-08-01" VerifiedBy="octocat">검증 도구는 다음의 경우 Warning을 표시합니다. Warning은 병합을 막지 않습니다.
SourceUrl은 있는데VerifiedOn이 없는 경우VerifiedOn이 오늘로부터 365일 이상 지난 경우SourceUrl이https가 아닌 경우
확인하지 못한 값은 추정해서 채우지 말고 비워두십시오. 기존 항목에 대한 소급 입력은 별도로 진행하므로 신규 항목 제출 시에만 신경 쓰시면 됩니다.
로고 이미지는 가능한 한 해당 기관이 공식적으로 배포하는 자산을 사용해주십시오. 표지 사용에 관한 방침은 TRADEMARKS.md를 참고해주십시오.
이미 수록된 항목의 정정이나 삭제를 요청하시는 경우에는 docs/REMOVAL_REQUEST.md의 절차를 따라주십시오.