튜토리얼

스킬 만들기 및 사용하기

Bob에게 반복 가능한 changelog 항목 워크플로우를 가르치는 재사용 가능한 스킬을 만들고, 명시적으로 호출하거나 Bob이 자동으로 활성화하도록 합니다.

스킬은 Bob에게 특화된 반복 가능한 워크플로우를 가르치는 재사용 가능한 명령 세트입니다. 동일한 형식 규칙이나 체크리스트를 모든 프롬프트에 다시 입력하는 대신, SKILL.md 파일에 워크플로우를 한 번만 정의하면 됩니다. 그러면 Bob은 스킬을 직접 호출하든 Bob이 자동으로 활성화하든, 스킬이 적용될 때마다 해당 지침을 따릅니다.

이 튜토리얼에서는 Keep a Changelog 형식을 사용하여 CHANGELOG.md 파일에 항목을 추가하는 스킬을 만듭니다(파일이 없으면 생성). 슬래시 명령으로 스킬을 명시적으로 호출한 다음, 두 번째 변경을 수행하고 스킬 이름을 언급하지 않고 Bob에게 기록하도록 요청하여 Bob이 설명을 기반으로 자동으로 스킬을 활성화하는 것을 확인합니다.

사전 요구 사항

이 튜토리얼을 완료하려면 다음이 필요합니다:

git clone https://github.com/IBM/galaxium-travels

changelog 항목 스킬 만들기

채팅 인터페이스 열기

내비게이션 바 옆의 Bob 아이콘을 클릭하거나 단축키 Option + Command + B(macOS) 또는 Ctrl + Alt + B(Windows)를 사용하여 Bob 채팅 인터페이스를 엽니다.

채팅 인터페이스의 모드 선택기를 사용하여 Agent 모드로 전환합니다. Agent 모드는 Bob이 스킬을 활성화하고 파일을 편집하는 데 필요한 도구 접근 권한을 제공합니다.

Skills 설정 열기

Bob에서 스킬을 만드는 방법은 여러 가지입니다. 사용자 인터페이스(UI)를 사용하거나, 안내된 설정을 위해 Bob 채팅에서 /create-skill 명령을 사용할 수 있습니다.

이 튜토리얼에서는 Bob 설정의 Skills 탭을 사용하여 스킬을 만듭니다.

  1. 채팅 인터페이스 아래에서 Bob Settings를 클릭합니다.
  2. 왼쪽 사이드바에서 Skills를 클릭합니다.
  3. + 버튼을 클릭하여 새 스킬을 만듭니다.

설정 열기

스킬 세부 정보 입력하기

스킬 생성 양식에 다음 값을 입력합니다:

필드
Skill Namechangelog-entry
DescriptionAdds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready.
Allow Bob to use this skill켜짐
Scope & Locationgalaxium-travels

Skill Name은 스킬을 직접 호출하기 위해 입력하는 것으로, 예를 들어 /changelog-entry입니다. Description은 이름으로 호출하지 않을 때 Bob이 스킬이 요청에 적용되는지 결정하기 위해 읽는 것입니다.

Allow Bob to use this skill이 켜져 있으면, 프롬프트가 필요할 때 Bob이 스스로 스킬을 사용하거나 명시적으로 호출할 수 있습니다. Scope & Locationgalaxium-travels로 설정하면 스킬이 프로젝트의 .bob/skills/ 디렉터리에 저장되어, git이 코드와 함께 추적하고 팀이 접근할 수 있습니다. 대신 **Global (all workspaces)**를 선택하면 스킬이 저장소 외부의 ~/.bob/skills/에 저장됩니다.

Skill Instructions 텍스트 상자에 다음을 입력합니다:

---
name: changelog-entry
description: Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready.
user-invocable: true
---

Add an entry to CHANGELOG.md using the Keep a Changelog format (https://keepachangelog.com/).

- If CHANGELOG.md does not exist, create it at the project root with this structure before adding an entry:

  # Changelog

  All notable changes to this project are documented in this file.
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

  ## [Unreleased]

- Add new entries under the `## [Unreleased]` section, under one of these subheadings: `### Added`, `### Changed`, `### Fixed`, `### Removed`. Create the subheading if it is not already present under `## [Unreleased]`.
- Write each entry as a single bullet point in the imperative mood ("Add", not "Added"), starting with a capital letter, with no trailing period.
- Base the entry on the actual diff, not on the wording of the request. Run `git diff` to review what changed before writing the entry.
- Only edit CHANGELOG.md. Do not stage or commit the change.

Create를 클릭합니다.

Bob은 스킬을 galaxium-travels/.bob/skills/changelog-entry/SKILL.md에 저장합니다.

스킬을 직접 호출하기

스킬을 이름으로 호출하여 Bob이 따르는 지침을 확인합니다.

작은 변경하기

기록할 것을 만들기 위해 Bob에게 작고 위험도 낮은 편집을 요청합니다:

Add a one-line note to the end of the README.md that says "Powered by IBM Bob."

Bob이 README.md를 편집합니다. 메시지가 표시되면 편집을 승인합니다.

스킬로 변경 사항 기록하기

채팅 인터페이스에서 /changelog-entry를 입력하고 Enter를 누르거나 나타나는 /changelog-entry 제안을 클릭합니다. 그런 다음 다음 프롬프트를 입력합니다:

Add a changelog entry for this change.

Bob은 스킬 도구를 사용하고 파일을 편집하는 권한을 요청할 수 있습니다. 메시지가 표시되면 승인합니다. Bob은 changelog-entry 스킬을 로드하고, 프로젝트에 CHANGELOG.md가 없으므로 생성하며, 스킬에 정의된 형식을 따르는 항목을 추가합니다. 예:

## [Unreleased]

### Added

- Add "Powered by IBM Bob." note to the end of README.md

항목 확인하기

Bob에게 changelog를 보여달라고 요청합니다.

Show me CHANGELOG.md

항목은 이전 단계에서 Bob이 생성한 changelog 항목과 일치합니다.

Bob이 스킬을 자동으로 활성화하게 하기

채팅 인터페이스 위의 + 버튼을 클릭하여 새 작업 창을 시작합니다.

두 번째 변경을 수행하고 스킬 이름을 언급하지 않고 Bob에게 기록하도록 요청합니다. Allow Bob to use this skill을 켜진 상태로 두었으므로, Bob은 스킬의 description에서 스킬이 적용됨을 인식하고 스스로 활성화할 수 있습니다.

또 다른 작은 변경하기

Add a one-line comment above the main heading in README.md that says "Galaxium Travels".

메시지가 표시되면 편집을 승인합니다.

스킬을 명명하지 않고 Bob에게 변경 사항 기록 요청하기

Update the changelog for this edit.

Bob은 요청이 changelog-entry 스킬의 description과 일치함을 인식하고 /changelog-entry를 입력하지 않아도 활성화합니다. 메시지가 표시되면 스킬 및 파일 편집 권한을 승인합니다. Bob은 같은 형식으로 다른 항목을 추가합니다.

항목 확인하기

Bob에게 changelog를 보여달라고 요청합니다.

Show me CHANGELOG.md

이 설정이 켜져 있으면, Bob은 changelog-entry를 포함한 스킬이 적용될 때마다 먼저 묻지 않고 자동으로 활성화합니다.

스킬 관리하기

changelog-entry를 만든 Bob 설정의 Skills 탭은 현재 및 전역 워크스페이스에서 사용 가능한 모든 스킬을 볼 수 있는 곳이기도 합니다. 워크스페이스에 로드된 스킬을 확인하고, 스킬이 프로젝트(.bob/skills/)에서 왔는지 전역(~/.bob/skills/) 위치에서 왔는지 확인하고, 스킬을 편집하거나 삭제하는 데 사용하세요.

정리하기

이 튜토리얼에서 만든 파일을 제거하려면:

  1. Bob Settings에서 Skills를 클릭한 다음 changelog-entry 스킬을 삭제합니다.
  2. 사전 요구 사항에서 클론한 galaxium-travels 디렉터리를 삭제합니다. 이렇게 하면 이 튜토리얼에서 만든 CHANGELOG.mdREADME.md 편집 내용도 제거됩니다.

다음 단계

이 튜토리얼에서는 스킬을 통해 워크플로우를 한 번 정의하고 Bob이 일관되게 적용하게 할 수 있다는 것을 배웠습니다. /skill-name으로 스킬을 명시적으로 호출하든, Bob이 description을 기반으로 자동으로 활성화하게 하든 관계없이요.

커스텀 모드 추가하기로 이동하여 커스텀 모드가 역할 정의, 동작 지침, 도구 접근을 특정 작업을 위한 전문화된 페르소나로 결합하는 방법을 알아보세요.

이 주제는 어떤가요?