스킬: Briks에 말투, 사실, 규칙 알려주기

#스킬이란

Skills 페이지는 이렇게 요약해요. “Guidance the builder follows on your workspace's projects when a task fits it: your tone, your facts, your conventions. The studio's own design and code rules always come first.”

모든 스킬은 세 부분으로 이뤄져요:

스킬은 워크스페이스에 속해요. 켜 둔 스킬은 그 워크스페이스의 모든 프로젝트에 적용되고, 다른 워크스페이스에는 적용되지 않아요. 동시에 최대 25개까지 켤 수 있어요. 목록 위에는 켜진 개수가 표시돼요. 예를 들면 "3 of 4 on. The builder receives the ones that are on with every job in this workspace, and only here."처럼요.

#스킬을 쓰는 때와 쓰지 않는 때

스킬은 지식을 더할 뿐 디자인을 정하지는 않아요. 검은색 푸터처럼 모양에 대한 고정 규칙은 Settings, Preferences의 Rules in your own words를 쓰세요. 거기는 “Kept to, build after build.”예요.

새로 만들거나 수정한 스킬은 다음 빌드나 변경부터 적용돼요. 그때까지는 게시된 사이트가 바뀌지 않아요.

#스킬을 관리할 수 있는 사람

Owner와 Admin은 스킬을 추가, 수정, 켜고 끄기, 업데이트, 삭제할 수 있어요. Admin 역할 설명은 “Manages members, settings, templates and skills, and moves projects.”예요. Editor와 Viewer는 Skills 페이지를 열어 목록을 볼 수 있지만, 스위치는 회색으로 비활성화되고 Add skill 버튼은 없어요. 멤버와 역할을 참고하세요.

#스킬 추가

Add skill을 클릭해요. Add a skill이라는 상자에서 시작하는 방법 세 가지를 보여 줘요. “시작 방법을 고르세요. 빌더가 받기 전에 모든 스킬을 직접 읽고 수정할 수 있어요.”

AI로 초안 작성

Draft a skill with AI의 What the skill should do에 Briks가 알아야 하거나 늘 해야 할 일을 20자에서 4,000자 사이로 적어 주세요. Draft it을 누르면 스튜디오에 “Usually under a minute.”라고 안내돼요. 초안은 Review the drafted skill에서 열리니 읽어 보고 고치세요. Add skill을 누르면 “added. It stays off until you turn it on.”라고 나와요.

GitHub에서 가져오기

Import a skill from GitHub에 공개 저장소의 SKILL.md, 폴더 또는 저장소 전체의 GitHub 링크를 붙여넣고 Read it을 클릭하세요. 링크에 스킬이 여러 개 있으면 목록에서 하나를 고르고 Read this one을 클릭하세요. Review the imported skill에는 커밋과 함께 스킬 전체가 나와요. "Read it all: the builder follows it as written." 가져오기는 한 시간에 최대 30번까지 읽을 수 있어요.

가져온 스킬은 내가 읽은 커밋에 고정돼요. 더 새로운 버전을 받으려면 스킬 메뉴를 열고 Check for update를 선택하세요. 최신 상태이거나, 저장하기 전에 검토할 수 있도록 새 버전이 열려요.

#안전성 점검 결과

모든 스킬은 입력하는 동안 읽고 저장할 때 다시 읽어요. 위험해 보이는 부분이 있으면 Read these before adding it 패널에 발견한 내용이 나오고, “I have read the instructions and they are safe to follow.”에 체크할 때까지 Add skill은 기다려요. 그러면 스킬에는 목록에서 Read before use 태그가 붙고 같은 설명이 달려요. 찾는 내용은 다음과 같아요:

• “빌더에게 앞서 정한 규칙이나 지시를 무시하라고 요구해요.”
• "제작 도구가 누구인지, 또는 시스템이 무엇을 말하는지 바꾸려 해요."
• “키, 시크릿, 자격 증명을 언급해요.”
• “다른 주소로 요청을 보내려고 해요.”
• “다른 주소의 스크립트를 페이지에 추가해요.”
• “텍스트를 코드로 실행하거나 원시 HTML을 설정하는 코드를 요구해요.”
• 언급된 웹 주소의 개수예요.

#끄기, 편집 또는 삭제

각 스킬 오른쪽에는 스위치가 있고, Edit, 가져온 스킬용 Check for update, Delete가 있는 메뉴가 있어요. 새 스킬은 모두 꺼진 상태로 시작하므로, Briks가 쓰기 전에 먼저 읽어 볼 수 있어요. 끄면 스킬은 나중을 위해 남아 있어요. 25개가 켜져 있으면 나머지 스킬의 스위치는 하나를 끌 때까지 회색으로 비활성화돼요. 삭제하기 전에 먼저 확인을 묻는데, “The builder stops receiving it from the next change on.”라고 나와요.

#따라 해 볼 만한 스킬 세 가지

#제대로 작동하는 스킬 작성하기

• When to use it에는 “any menu page or dish list”처럼 작업을 구체적으로 적으세요. 모호하게 쓰면 Briks가 그 스킬을 쓰지 않을 수 있어요.
• 규칙은 해야 할 일로 쓰고, 이유가 분명하지 않으면 이유도 함께 적어 주세요.
• 옳은 예와 틀린 예를 하나씩 들어 주세요. 좋은 예 하나가 규칙 다섯 개보다 효과가 큰 경우가 많아요.
• 정보를 최신으로 유지하세요. 가격이나 주소가 바뀌면 스킬을 고친 다음 변경을 요청해야 라이브 사이트에 반영돼요.
• 스킬 하나에는 주제 하나만 담으세요. 어조 스킬과 사실 스킬을 나누면 긴 스킬 하나에 둘을 담을 때보다 바꾸고 업데이트하기 쉬워요.