에이전트 스킬
핵심 요약
Skill은 AI 에이전트가 언제 어떤 순서로 도구를 사용할지 알려주는 지침입니다. CLI 승인이나 서버 권한 검사를 우회하지 않습니다.
설치·보호·라이선스·검증 중 목적에 맞는 Skill을 선택하고, 변경 후에는 실행 증적을 확인하세요.
4개의 완성된 스킬 매니페스트가 skills/에 있습니다 — 각각은 에이전트 런타임이 로드할 수 있는 frontmatter(name, description)를 가진 SKILL.md입니다. 정직한 상태 규율과 도구 시퀀스를 인코딩하며, 자체 코드는 갖지 않습니다.
| 스킬 | 파일 | 사용자가 요청할 때 사용… |
|---|---|---|
yetdapay-install | skills/yetdapay-install/SKILL.md | 웹사이트에 기부/피드백 표면 추가 — 호스티드 링크({SITE_ORIGIN}/h/{public_id}로의 <a>) 또는 네이티브 SDK 위젯. 프레임워크 분석, public_id 처리, 설치 체크리스트 커버. |
yetdapay-protect | skills/yetdapay-protect/SKILL.md | 모듈에 protect 파이프라인 실행 — yp-mcp 도구 또는 yp CLI 직접을 통한 init → analyze → plan → review → 사용자 승인 → apply → verify. |
yetdapay-license | skills/yetdapay-license/SKILL.md | 서버 측 라이선스 라이프사이클 조사 — 라이선스 목록/조회, PoP 바인딩, 사용량, 보안 이벤트 — 및 공개 라이선스 검증. |
yetdapay-verify | skills/yetdapay-verify/SKILL.md | 증거 해석 — .devpay/evidence/*.record.json 읽기, protect verify 실행, license-verify 판정 해석. |
4개 모두에 인코딩된 공통 규율
- 범위 분리. 셀러 범위 작업은 자격 증명이 필요하고, 공개 표면은
public_id만 얻습니다. 스킬은 이를 섞기를 거부합니다. - planned ≠ applied ≠ verified. 증거 용어는 문자 그대로 전파됩니다 —
PARTIALLY_VERIFIED는 성공으로 승격되지 않습니다. - 읽기 후 쓰기. 조사 도구가 먼저 실행되고, apply 단계는 사용자가 정확한 플랜 sha를 승인하는 것에 게이트됩니다.
- 샌드박스 정직성. 기부는
status:"sandbox"입니다 — 절대 실제 돈이 아니며, 스킬은 결제 캡처를 암시하는 대신 그렇게 말합니다.
스킬이 MCP 서버에 매핑되는 방식
| 스킬 | 주요 표면 |
|---|---|
yetdapay-install | 게이트웨이 도구 yetdapay_integration_* / yetdapay_*_configure + 프롬프트 setup_donation_and_feedback |
yetdapay-protect | yp-mcp 도구 yetdapay_project_analyze … yetdapay_protection_verify + 프롬프트 protect_project |
yetdapay-license | 게이트웨이 읽기 도구 yetdapay_license_*, yetdapay_usage_counters, yetdapay_security_events, yetdapay_license_verify (또는 동등한 REST 엔드포인트) |
yetdapay-verify | yp-mcp verify + .devpay/evidence/ 레코드 + 공개 /licenses/verify |
알아둘 가치가 있는 가드레일
yetdapay-protect는 사용자가 현재 플랜 sha를 승인해야 합니다 —approved:true없는yetdapay_protection_apply는 CLI가 실행되기 전에 거부되고, sha 드리프트는 새 플랜을 통해서만 다시 바인딩됩니다.yetdapay-license는 셀러 조사(자격 증명 필요)와 바이어/공개 검증(key-in/verdict-out, 무인증)을 구별합니다 — 바이어 셀프 서비스 API는 없고, 이메일은 자격 증명이 아닙니다.yetdapay-install은 생성된 코드에서 자격 증명을 지어내지 않으며AGENT/MANUAL_REVIEW결과를 생성된 코드가 아닌 handoff로 취급합니다.