scaffold-exercises

scaffold-exercises 스킬 개요

scaffold-exercises는 저장소의 명명 규칙과 lint 기준에 맞는 연습문제 디렉터리를 만드는 데 초점을 둔 설정형 스킬입니다. 새 섹션을 추가하거나, 연습문제용 골격만 먼저 만들거나, problem/solution/explainer 레이아웃을 추측 없이 표준화해야 할 때 특히 유용합니다. 이 스킬의 핵심은 단순히 “폴더를 만드는 것”이 아니라, 내용 작성, 리뷰, 그리고 pnpm ai-hero-cli internal lint까지 통과할 수 있는 유효한 연습문제 스캐폴드를 만드는 데 있습니다.

scaffold-exercises는 무엇을 위한 것인가

이미 추가할 학습 콘텐츠는 정해져 있지만, 이를 담을 깔끔한 디렉터리 골격이 필요할 때 scaffold-exercises 스킬을 사용하세요. 코스 작성자, 유지보수 담당자, 그리고 여러 섹션에 걸쳐 반복 가능한 연습문제 구조를 만들어야 하는 에이전트에게 잘 맞습니다.

가장 잘 도움이 되는 상황

이 스킬은 번호가 붙은 섹션, 번호가 붙은 연습문제, 그리고 각 변형 폴더 안의 필수 readme.md 파일처럼 저장소 규칙이 엄격할수록 더 강력합니다. 특히 자주 초안을 잡는 워크플로를 갖고 있다면 scaffold-exercises 설치가 큰 도움이 됩니다. 실제 내용을 쓰기 전에 형식 오류를 줄여 주기 때문입니다.

사용자에게 기대하는 것

이 스킬은 섹션 번호, 연습문제 번호, 연습문제 이름, 그리고 의도한 변형 타입을 제공할 수 있다고 가정합니다. 요청이 모호해도 스캐폴드는 만들 수 있지만, problem, solution, explainer 사용 사례가 분명히 구분될수록 결과물의 완성도가 높아집니다.

scaffold-exercises 스킬 사용 방법

scaffold-exercises 설치하기

다음 명령으로 scaffold-exercises 스킬을 설치하세요:

npx skills add mattpocock/skills --skill scaffold-exercises

이 명령이 저장소에서 실제로 사용하는 scaffold-exercises 설치 경로입니다. 설치한 뒤에는 이를 일반적인 글쓰기 프롬프트가 아니라 디렉터리 생성 워크플로로 사용해야 합니다.

구조화된 브리프를 입력하기

가장 좋은 scaffold-exercises 사용법은 대상 섹션, 연습문제, 원하는 변형을 짧고 명확하게 적는 것입니다. 예를 들면: “exercises/02-generation/02.01-rerank-basics/에 explainer/와 solution/ 스텁을 만들어 주세요. 이름은 dash-case로 유지하고, 각 readme에 내용이 들어가야 합니다.”라는 식입니다. “강의 하나를 스캐폴드해 주세요”보다 훨씬 낫습니다. 필요한 경로와 반드시 존재해야 할 파일을 분명히 알려 주기 때문입니다.

먼저 올바른 파일을 읽기

먼저 SKILL.md를 읽고, 그다음 저장소의 연습문제 규칙을 살펴보세요. 특히 섹션 명명 방식, 필수 하위 폴더, 스텁 내용이 중요합니다. 저장소에 다른 곳의 보조 가이드가 있다면, 무엇이든 생성하기 전에 그 파일도 확인하세요. scaffold-exercises에서는 디렉터리 형식, 기본 변형, 그리고 코드 파일이 필요한지 아니면 readme만 있으면 되는지가 핵심 판단 포인트입니다.

저장소의 최소 유효 패턴을 따르기

안전한 scaffold-exercises 가이드는 먼저 디렉터리를 만들고, 그다음 비어 있지 않은 readme.md 파일을 추가하고, 마지막으로 실제 변형에 코드가 들어갈 때만 main.ts를 추가하는 것입니다. 초안 단계라면 보통 explainer/를 기본값으로 두는 편이, 아직 완성되지 않은 학습자 작업처럼 보이는 problem 파일을 억지로 만드는 것보다 낫습니다. 제목은 연습문제 이름과 맞추고, 첫 초안 플레이스홀더에서는 깨진 링크를 피하세요.

scaffold-exercises 스킬 FAQ

scaffold-exercises는 새 연습문제에만 쓰나요?

아닙니다. scaffold-exercises 스킬은 새 섹션을 추가하거나, 기존 연습문제 시리즈를 표준화할 때도 도움이 됩니다. 더 깊은 내용을 쓰기 전에 저장소의 연습문제 구조가 유효해야 하는 모든 경우에 유용합니다.

일반 프롬프트 대신 꼭 이 스킬을 써야 하나요?

구조가 문장보다 더 중요할 때는 이 스킬을 사용하세요. 일반 프롬프트로도 아이디어는 설명할 수 있지만, 명명 규칙, 필수 폴더, lint 친화적인 스텁을 지켜야 한다면 scaffold-exercises가 더 적합합니다.

scaffold-exercises는 초보자도 쓰기 쉬운가요?

네, 연습문제 이름과 대상 폴더를 구분할 수 있다면 그렇습니다. 초보자가 가장 흔히 하는 실수는 변형 타입을 너무 모호하게 적거나 섹션/연습문제 번호 체계를 무시하는 것입니다. 그러면 그럴듯해 보이지만 저장소 규칙에 맞지 않는 경로가 만들어질 수 있습니다.

언제 scaffold-exercises를 쓰지 말아야 하나요?

학습용 문안만 필요하거나, 아이디어 정리만 하면 되거나, 디렉터리 제약이 없는 일회성 markdown 초안만 필요하다면 scaffold-exercises를 쓰지 마세요. 이 스킬은 저장소 구조를 다루는 도구이지, 콘텐츠를 대신 써 주는 지름길이 아닙니다.

scaffold-exercises 스킬 개선 방법

더 정확한 경로와 변형 의도를 제시하기

가장 큰 품질 향상은 정확한 디렉터리와 각 하위 폴더의 역할을 지정하는 데서 나옵니다. 좋은 요청은 무엇이 있어야 하는지를 분명히 적습니다. 예를 들면: “exercises/03-ranking/03.02-bm25-tuning/에 problem/, solution/, explainer/ readme를 만들어 주세요. problem/ 폴더에는 TODO를 넣고, solution/ 폴더에는 참고용 개요를 넣고, explainer/는 개념 설명에만 머물러야 합니다.” 이런 식으로 요청하면 scaffold-exercises 스킬이 첫 시도에서 올바른 구조를 만들 가능성이 높아집니다.

자주 나는 실패 패턴을 점검하기

가장 흔한 문제는 잘못된 번호, 누락된 readme.md, 내용 없는 플레이스홀더, 그리고 스텁만으로 충분한 연습문제에 불필요하게 코드 파일을 추가하는 것입니다. 또 다른 흔한 실수는 같은 경로 안에 섹션 수준 이름과 연습문제 수준 이름을 섞는 것입니다. scaffold-exercises 가이드는 명명 규칙과 콘텐츠 기대치를 분리해서 관리할 때 가장 잘 작동합니다.

첫 스캐폴드 이후에 다시 다듬기

생성 후에는 각 폴더에 필요한 파일이 들어 있는지, 각 readme의 문구가 실제 연습문제 타입과 맞는지 확인하세요. 나중에 코드가 필요하다고 판단되면, 학습 경험이 실제로 달라지는 위치에만 main.ts를 추가하면 됩니다. scaffold-exercises에서는 다음 순서가 가장 빠른 개선 루프입니다: 스캐폴드 만들기, lint 실행하기, 이름 수정하기, 그다음 내용 확장하기.