wp-abilities-api

wp-abilities-api 스킬 개요

wp-abilities-api의 용도

wp-abilities-api 스킬은 WordPress Abilities API를 처음부터 끝까지 다루는 데 도움을 줍니다. PHP에서 ability와 category를 등록하고, REST로 노출하며, @wordpress/abilities에서 이를 소비하는 흐름까지 포함합니다. hook 순서, REST 노출 여부, 권한 동작을 매번 추측하지 않고도 안정적으로 처리해야 할 때 특히 유용한 wp-abilities-api 작업 흐름을 제공합니다.

가장 잘 맞는 사용 사례

이 스킬은 ability가 클라이언트에서 발견 가능해야 하거나, /wp-json/wp-abilities/v1/*에 나타나야 하거나, plugin, theme, mu-plugin, WordPress core checkout 안에서 깔끔하게 등록되어야 하는 백엔드 개발 작업에 적합합니다. “ability가 안 보인다”는 문제를 고치거나, 새로운 서버 측 abilities를 연결하거나, 클라이언트가 서버에 등록된 항목을 실제로 볼 수 있는지 검증할 때 특히 잘 맞습니다.

가장 중요한 점

wp-abilities-api의 핵심 가치는 라이프사이클 실수를 줄이는 데 있습니다. repository는 registration 타이밍, source scanning, REST exposure 확인을 강조하는데, 이는 코드가 겉보기엔 멀쩡해도 API 연결이 쉽게 어긋나기 때문입니다. 일반적인 프롬프트 작성보다 이 부분이 훨씬 중요합니다.

wp-abilities-api 스킬 사용 방법

설치하고 맥락에 맞게 배치하기

npx skills add WordPress/agent-skills --skill wp-abilities-api로 설치합니다. 그다음 agent가 repo root를 바라보게 하고, 작업이 core, plugin, theme, mu-plugin 중 어디에 해당하는지 알려주세요. wp-abilities-api install을 판단할 때는 대상 WordPress 버전도 함께 제공해야 합니다. WP 6.9+ 지원 여부에 따라 core 동작을 신뢰할 수 있는지, 아니면 plugin/package 경로를 써야 하는지가 달라지기 때문입니다.

스킬에 맞는 입력을 주기

가장 좋은 wp-abilities-api usage는 넓은 목표가 아니라 구체적인 작업에서 시작합니다. 좋은 입력에는 ability ID, category ID, 원하는 label, callback 형태, REST에서 보여야 하는지 여부가 들어갑니다. 예를 들어 “이 plugin에 site/clear-cache ability를 추가하고, REST에 노출하고, client가 목록을 볼 수 있게 해주세요”처럼 말하는 것이 좋습니다. “abilities를 설정해줘”보다 훨씬 낫습니다. 무엇을 어디에 만들어야 하는지 스킬이 정확히 알 수 있기 때문입니다.

먼저 읽어야 할 파일

먼저 SKILL.md를 보고, 다음으로 references/php-registration.md와 references/rest-api.md를 확인하세요. 이 두 파일에는 판단에 가장 중요한 정보가 담겨 있습니다. category를 ability보다 먼저 등록해야 하는지, 어떤 hook이 필요한지, 어떤 REST route를 확인해야 하는지 등이 포함됩니다. 기존 코드베이스에 wp-abilities-api guide가 맞는지 판단하려면 wp_register_ability(, wp_register_ability_category(, wp_abilities_api_init, wp_abilities_api_categories_init, wp-abilities/v1, @wordpress/abilities를 먼저 검색하세요.

잘못된 성공을 막는 워크플로 사용하기

실전적인 wp-abilities-api 워크플로는 이렇습니다. 버전 지원을 확인하고, 기존 등록을 찾고, category를 ability보다 먼저 추가한 뒤, REST 노출과 client 가시성을 검증합니다. 결과 품질이 중요하다면 agent에게 수정한 정확한 파일 경로, 각 registration에 사용한 hook, 그리고 ability가 wp-abilities/v1/abilities 또는 wp-abilities/v1/categories에 실제로 나타나는지 확인한 방법까지 포함해 달라고 요청하세요.

wp-abilities-api 스킬 FAQ

wp-abilities-api는 백엔드 개발에만 쓰이나요?

아닙니다. 다만 백엔드 개발에서 가장 강합니다. wp-abilities-api for Backend Development 사용 사례가 특히 빛나는 영역은 PHP registration, lifecycle hook, REST 노출, capability 스타일 체크입니다. 단발성 UI prompt나 정적인 code snippet만 필요하다면 일반적인 프롬프트로도 충분할 수 있습니다.

직접 프롬프트를 쓰는 것과 어떻게 다른가요?

일반 프롬프트도 목표는 설명할 수 있지만, wp-abilities-api는 WordPress 특유의 제약에 맞춘 집중된 워크플로를 제공합니다. hook 타이밍, REST 가시성, 버전 호환성, 새 항목을 추가하기 전에 기존 등록을 확인해야 하는 필요성까지 다룹니다. 덕분에 코드상으로는 존재하지만 REST에는 안 보이는 경우처럼 시행착오가 줄어듭니다.

초보자도 WordPress 내부 구조를 알아야 하나요?

기본적인 이해가 있으면 좋지만, repo root를 찾을 수 있고 plugin이나 theme 코드가 어디에 있는지만 알아도 충분히 사용할 수 있습니다. 초보자가 가장 많이 빠지는 함정은 필요한 입력을 빼먹는 것입니다. WordPress 버전, 프로젝트 유형, 변경이 들어갈 위치가 없으면 agent가 잘못된 registration 경로를 선택할 수 있습니다.

언제 이 스킬을 쓰지 말아야 하나요?

작업이 WordPress abilities와 관련이 없거나, 프로젝트가 WP 6.9 미만인데 필요한 package/plugin 경로를 추가할 수 없거나, client가 볼 수 있는 ability registration이 필요하지 않다면 wp-abilities-api를 쓰지 마세요. 이런 경우에는 스킬이 주는 절차적 비용에 비해 얻는 이점이 부족합니다.

wp-abilities-api 스킬 개선 방법

정확한 registration 대상을 먼저 알려주기

가장 좋은 결과는 ability ID, category, 의도한 노출 방식을 처음부터 명시할 때 나옵니다. “admin ability를 추가해줘” 대신 “acme/reindex-search를 acme-tools 아래에 등록하고, REST에 노출하고, JS client에서도 사용할 수 있게 해줘”라고 말하세요. 이렇게 하면 wp-abilities-api 스킬이 모호하거나 어긋난 출력을 만들 가능성이 줄어듭니다.

구현을 바꾸는 제약 조건을 함께 넣기

WordPress 버전, core인지 plugin/theme인지, WP-CLI 사용 가능 여부를 함께 알려주세요. 이런 정보는 install 경로, hook 사용 방식, 검증 단계를 바꿉니다. 생략하면 코드상으로는 맞아 보여도 실제 환경에서는 실패하는 결과가 나올 수 있습니다.

코드만 말고 검증까지 요청하기

가장 흔한 실패 원인은 hook 순서 오류, meta.show_in_rest 누락, REST route를 확인하지 않고 ability가 나타날 거라고 가정하는 것입니다. agent에게 wp-abilities/v1/abilities를 기준으로 검증하게 하고, 왜 해당 registration이 wp_abilities_api_categories_init 또는 wp_abilities_api_init에 들어가야 하는지도 설명해 달라고 하세요. 그러면 wp-abilities-api guide가 실제로 검증 가능한 워크플로가 됩니다.

repo 근거를 바탕으로 반복 개선하기

첫 시도가 불완전하다면, agent에게 정확한 기존 파일을 지정하고 처음부터 다시 쓰지 말고 그 구조에 맞추라고 하세요. 예를 들어 “includes/abilities.php의 기존 registration 패턴을 따르고, category naming은 일관되게 유지하고, 필요할 때만 REST visibility flag를 바꿔줘”라고 말하면 됩니다. 코드베이스와의 불일치 없이 wp-abilities-api usage를 개선하는 가장 빠른 방법입니다.