반복 가능한 작업과 목표 Microsoft 환경이 있는 경우 이 문서를 사용하여 기술을 구축할지 아니면 기존 기술 콘텐츠를 조정할지 결정하세요. 그런 다음 제품의 작성 단계를 선택합니다. 빌드 또는 재사용 중입니다. 결과는 패키지 & 테스트 전에 통합할 준비가 된 종속성 및 테스트 증거가 있는 기술 구현입니다.
기술 재사용 또는 확장
선언적 에이전트의 경우 에이전트 작성기 및 에이전트 도구 키트는 에이전트 간 재사용을 지원하지 않습니다. 선언적 에이전트의 기술의 지원 매트릭스를 따르십시오. 한 에이전트에 연결된 기술을 다른 에이전트와 공유할 수 있다고 가정하지 마세요.
스킬을 만들기 전에:
- 필요한 작업을 이미 수행하는 승인된 기술을 검토합니다.
- 대상 에이전트 또는 Microsoft 환경에서 기술 형식과 기능을 지원하는지 확인합니다.
- 지침, 리소스, 스크립트, 도구 및 데이터 액세스를 검토합니다.
- 기존 기술 콘텐츠를 조정하기 전에 대상 환경의 문서화된 재사용 제한을 확인하세요.
- 소유권, 버전 관리, 공유, 지원, 기대치 업데이트 확인
- 대표적인 입력과 예상 출력으로 기술을 테스트합니다.
기존 승인된 기술이 요구 사항을 충족하지 않거나 대상 환경이 재사용을 지원하지 않는 경우 새 기술을 만듭니다.
구현 경로 선택
전문성 개발을 위한 Work IQ Dev 도구로 시작하세요. 대상 환경 및 프로젝트 유형에 맞는 경로를 선택하세요. 공유 SKILL.md 형식은 에이전트 간 재사용 또는 게시 자격을 설정하지 않습니다.
| 개발 접근 방식 | 기술 아티팩트 및 scope | 다음으로 시작 |
|---|---|---|
| Work IQ Dev 도구 | 독립 실행형 플러그 인의 최상위 기술 폴더 또는 기존 선언적 에이전트 프로젝트에 추가된 기술입니다. 이들은 별도의 작성 경로입니다. | Work IQ Dev 도구 및 아래 경로 세부 정보를 사용하여 플러그인 빌드 |
| Copilot Chat 기술 작성 및 플러그 인 배포 | 제품별 작성 및 배포 지침을 따릅니다. | Copilot Chat을 위한 기술 구축 |
| 에이전트 작성기 | 선언적 에이전트에 업로드된 완전한 기술 ZIP 또는 에이전트 빌더의 설명에서 생성된 기술입니다. | 에이전트 빌더를 사용하여 기술 추가 |
| Microsoft 365 에이전트 도구 키트 | 독립 실행형 기술 ZIP이 아닌 기존 선언적 에이전트 프로젝트에 추가된 기술 디렉터리입니다. | 에이전트 도구 키트를 사용하여 기술 추가 |
| Copilot Cowork | Microsoft 365 앱 패키지에 등록된 기술 폴더입니다. Cowork 패키지 요구 사항 및 제한을 사용합니다. | Copilot Cowork용 플러그 인 빌드 |
아티팩트를 게시 경로와 일치
아티팩트에 대한 게시 지침을 따릅니다.
- 독립 실행형 WIQD 플러그인:선택한 사용자와 공유하거나 organization's catalog에 제출합니다. 공유는 카탈로그 게시가 아닙니다.
- Copilot Cowork 패키지:테넌트에 게시를 따릅니다.
- 기술이 있는 선언적 에이전트: Microsoft Marketplace 제출을 위해 에이전트 게시 를 따르세요.
하나의 아티팩트를 지원한다고 해서 모든 플러그인 패키지에 대한 게시 자격이 설정되는 것은 아닙니다. 게시는 사용자 액세스, 동의 또는 연결 설정을 완료하지 않습니다.
GitHub Copilot은 기술 지침, 지원 스크립트, 리소스, 테스트 및 리포지토리 변경을 지원할 수 있습니다. 대상 환경 및 작성 도구는 지원되는 기술 형식 및 런타임을 결정합니다.
Work IQ Dev 도구
WIQD는 두 가지 기술 작성 경로를 제공합니다.
-
wiqd plugin add skill독립 실행형 플러그 인 프로젝트에 최상위 기술을 추가합니다. 플러그인은 기술 전용이거나 기술을 지원되는 에이전트 또는 원격 MCP 커넥터와 결합할 수 있습니다. 대상 제품의 지원을 별도로 확인합니다. -
wiqd agent add skill기존 선언적 에이전트 프로젝트에 기술을 추가합니다. 이 경로는 기본적으로 꺼져 있는 기능 플래그를 사용합니다agent-skills.
두 경로 모두 기반 기능을 만들 SKILL.md지만 서로 다른 프로젝트 유형에서 작동합니다. WIQD 플러그인 형식에서 기술 이름은 폴더 이름과 일치해야 하며 설명에는 이를 활성화하는 구가 포함되어야 합니다.
플러그인이란? 및 플러그인 작성 참조를 참조하세요.
WIQD 원본 유효성 검사(wiqd plugin validate --mode source)는 기술 콘텐츠를 검사하지 않습니다. 패키징 후 실제 ZIP 경로로 실행 wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" 합니다. 패키지 유효성 검사는 해당 ZIP의 캡처된 복사본을 Microsoft 365 유효성 검사 서비스에 업로드하며 인증이 필요할 수 있습니다. 반환된 결과를 검토합니다. 패스는 런타임 동작을 설정하지 않습니다.
유효성 검사 및 MVL을 참조하세요.
기술 구현하기
해당 작업을 완료합니다.
- 작업, 준비, 예상 결과, 경계, 성공 기준을 정의합니다.
- 기술 지침을 만들거나 가져옵니다.
- 필요한 지원 리소스 및 스크립트를 추가합니다.
- 필요한 도구, 원격 MCP 서버, API, ID, 권한 또는 데이터 종속성을 구성합니다.
- 지원되는 파일 형식, 스크립트 형식, 샌드박스 동작, 저장소 및 민감도 요구 사항을 확인합니다.
- 예상, 모호, 지원되지 않는 시나리오 및 실패 시나리오를 테스트합니다.
- 기술 버전, 소유자, 종속성, 알려진 제한 사항 및 지원 프로세스를 기록합니다.
Copilot Chat에서 직접 사용하는 기술은 Copilot Chat 기술 빌드를 참조하세요. 선언적 에이전트의 현재 지원 및 런타임 제약 조건은 선언적 에이전트의 기술을 참조하세요. Copilot Cowork의 경우 도우미 파일 제한을 참조하세요. 둘 이상의 경험에 스킬을 배포할 때 모든 대상 호스트의 요구 사항을 적용합니다.
기술이 작동하는지 확인
다음은 다음과 같은 경우에 기술을 통합할 준비가 된 것입니다.
- 대상 에이전트 또는 환경에서 로드하고 사용할 수 있습니다.
- 해당 명령은 정의된 작업을 일관되게 수행합니다.
- 필요한 리소스, 스크립트, 도구 및 데이터를 사용할 수 있습니다.
- 사용 권한 및 외부 종속성은 개발 또는 테스트 환경에서 작동합니다.
- 지원되지 않거나 실패한 작업은 이해할 수 있는 동작을 생성합니다.
- 소유권, 버전 관리, 제한 사항 및 테스트 증거가 기록됩니다.
계획의 다른 구성 요소를 계속 진행합니다. 완료되면 구성 요소를 통합하고 테스트한 다음 패키지 & 테스트 로 이동하여 플러그인 패키지를 만듭니다.