gen-ajax-page
fetch API 기반 Ajax 인터랙션이 포함된 Mustache 페이지를 생성하는 스킬. "/gen-ajax-page"를 입력하거나, "Ajax 페이지 만들어줘", "비동기 페이지 만들어줘" 같은 요청에 트리거된다. 대상 기능과 호출할 API 엔드포인트를 인터뷰로 수집한 뒤 바로 코드를 생성한다.
SKILL.md.claude/skills/gen-ajax-page/SKILL.md
GitHubGen Ajax Page
fetch API를 사용한 Ajax 인터랙션이 포함된 Mustache 페이지를 생성하는 스킬이다.
언제 사용하는가
- 페이지 새로고침 없이 부분 갱신이 필요한 UI를 만들 때
- 중복체크, 댓글 CRUD, 좋아요, 실시간 검증 등 Ajax가 필요한 기능
- "Ajax 페이지 만들어줘", "비동기 페이지 만들어줘" 요청 시
인터뷰 항목
다음 정보를 질문으로 수집한다. 한 번에 하나씩 묻는다.
- 대상 기능 — 어떤 기능의 페이지인지 (예: 댓글 목록/등록/삭제, 유저네임 중복체크)
- 호출할 API 엔드포인트 — 어떤 REST API를 호출하는지 (예:
GET /api/reply,POST /api/reply) - UI 요소 — 필요한 입력 필드, 버튼, 표시 영역
- 갱신 방식 — 전체 목록 다시 로드 vs 해당 요소만 추가/삭제
사용자가 이미 충분한 정보를 제공했다면 추가 질문 없이 바로 생성한다.
생성 규칙
반드시 _docs/.ai/rules/common-rule.md의 프론트엔드 규칙을 따른다:
기본 원칙
- POST 요청 기본:
<form>태그 +name속성으로 제출 (페이지 이동 방식) - Ajax가 필요한 경우만 fetch 사용 (중복체크, 부분 갱신 등)
fetch 패턴
async function fetchData() {
let response = await fetch("/api/board", {
method: "GET",
headers: {
"Content-Type": "application/json"
}
});
let responseBody = await response.json();
if (responseBody.status === 200) {
// 성공 처리
render(responseBody.body);
} else {
alert(responseBody.msg);
}
}
POST/PUT/DELETE 패턴
async function saveData() {
let requestBody = {
title: document.querySelector("#title").value,
content: document.querySelector("#content").value
};
let response = await fetch("/api/board", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify(requestBody)
});
let responseBody = await response.json();
if (responseBody.status === 200) {
// 성공 처리
alert("저장 완료");
location.reload();
} else {
alert(responseBody.msg);
}
}
DOM 조작 패턴
function render(dataList) {
let el = document.querySelector("#list-area");
el.innerHTML = "";
dataList.forEach(item => {
el.innerHTML += `
<div class="item" id="item-${item.id}">
<span>${item.title}</span>
<button onclick="deleteItem(${item.id})">삭제</button>
</div>
`;
});
}
출력 예시 — 댓글 Ajax 페이지
{{>layout/header}}
<h2>댓글</h2>
<!-- 댓글 입력 -->
<div>
<textarea id="comment" placeholder="댓글을 입력하세요"></textarea>
<button onclick="replySave()">등록</button>
</div>
<!-- 댓글 목록 -->
<div id="reply-list"></div>
<script>
let boardId = {{boardId}};
// 페이지 로드 시 댓글 목록 조회
replyList();
async function replyList() {
let response = await fetch(`/api/board/${boardId}/reply`);
let responseBody = await response.json();
if (responseBody.status === 200) {
renderReplies(responseBody.body);
} else {
alert(responseBody.msg);
}
}
function renderReplies(replies) {
let el = document.querySelector("#reply-list");
el.innerHTML = "";
replies.forEach(reply => {
el.innerHTML += `
<div class="reply-item" id="reply-${reply.id}">
<strong>${reply.username}</strong>
<p>${reply.comment}</p>
${reply.isOwner ? `<button onclick="replyDelete(${reply.id})">삭제</button>` : ""}
</div>
`;
});
}
async function replySave() {
let comment = document.querySelector("#comment").value;
if (!comment.trim()) {
alert("댓글을 입력하세요");
return;
}
let response = await fetch(`/api/board/${boardId}/reply`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ comment: comment })
});
let responseBody = await response.json();
if (responseBody.status === 200) {
document.querySelector("#comment").value = "";
replyList(); // 목록 새로고침
} else {
alert(responseBody.msg);
}
}
async function replyDelete(id) {
let response = await fetch(`/api/board/${boardId}/reply/${id}`, {
method: "DELETE"
});
let responseBody = await response.json();
if (responseBody.status === 200) {
replyList(); // 목록 새로고침
} else {
alert(responseBody.msg);
}
}
</script>
{{>layout/footer}}
생성 위치
src/main/resources/templates/{domain}/{page-name}.mustache
주의사항
- Ajax가 불필요한 단순 폼 제출은 이 스킬을 사용하지 않는다 →
gen-controller로 일반 폼 생성 - API 엔드포인트가 먼저 존재해야 한다. 없으면 사용자에게 알린다
Resp래퍼 응답 구조(status,msg,body)에 맞춰 처리한다- XSS 방지를 위해 사용자 입력을 innerHTML에 넣을 때 주의한다