기술 구축 또는 재사용

반복 가능한 작업과 목표 Microsoft 환경이 있는 경우 이 문서를 사용하여 기술을 구축할지 아니면 기존 기술 콘텐츠를 조정할지 결정하세요. 그런 다음 제품의 작성 단계를 선택합니다. 빌드 또는 재사용 중입니다. 결과는 패키지 & 테스트 전에 통합할 준비가 된 종속성 및 테스트 증거가 있는 기술 구현입니다.

기술 재사용 또는 확장

선언적 에이전트의 경우 에이전트 작성기 및 에이전트 도구 키트는 에이전트 간 재사용을 지원하지 않습니다. 선언적 에이전트의 기술의 지원 매트릭스를 따르십시오. 한 에이전트에 연결된 기술을 다른 에이전트와 공유할 수 있다고 가정하지 마세요.

스킬을 만들기 전에:

  1. 필요한 작업을 이미 수행하는 승인된 기술을 검토합니다.
  2. 대상 에이전트 또는 Microsoft 환경에서 기술 형식과 기능을 지원하는지 확인합니다.
  3. 지침, 리소스, 스크립트, 도구 및 데이터 액세스를 검토합니다.
  4. 기존 기술 콘텐츠를 조정하기 전에 대상 환경의 문서화된 재사용 제한을 확인하세요.
  5. 소유권, 버전 관리, 공유, 지원, 기대치 업데이트 확인
  6. 대표적인 입력과 예상 출력으로 기술을 테스트합니다.

기존 승인된 기술이 요구 사항을 충족하지 않거나 대상 환경이 재사용을 지원하지 않는 경우 새 기술을 만듭니다.

구현 경로 선택

전문성 개발을 위한 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용 플러그 인 빌드

아티팩트를 게시 경로와 일치

아티팩트에 대한 게시 지침을 따릅니다.

하나의 아티팩트를 지원한다고 해서 모든 플러그인 패키지에 대한 게시 자격이 설정되는 것은 아닙니다. 게시는 사용자 액세스, 동의 또는 연결 설정을 완료하지 않습니다.

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을 참조하세요.

기술 구현하기

해당 작업을 완료합니다.

  1. 작업, 준비, 예상 결과, 경계, 성공 기준을 정의합니다.
  2. 기술 지침을 만들거나 가져옵니다.
  3. 필요한 지원 리소스 및 스크립트를 추가합니다.
  4. 필요한 도구, 원격 MCP 서버, API, ID, 권한 또는 데이터 종속성을 구성합니다.
  5. 지원되는 파일 형식, 스크립트 형식, 샌드박스 동작, 저장소 및 민감도 요구 사항을 확인합니다.
  6. 예상, 모호, 지원되지 않는 시나리오 및 실패 시나리오를 테스트합니다.
  7. 기술 버전, 소유자, 종속성, 알려진 제한 사항 및 지원 프로세스를 기록합니다.

Copilot Chat에서 직접 사용하는 기술은 Copilot Chat 기술 빌드를 참조하세요. 선언적 에이전트의 현재 지원 및 런타임 제약 조건은 선언적 에이전트의 기술을 참조하세요. Copilot Cowork의 경우 도우미 파일 제한을 참조하세요. 둘 이상의 경험에 스킬을 배포할 때 모든 대상 호스트의 요구 사항을 적용합니다.

기술이 작동하는지 확인

다음은 다음과 같은 경우에 기술을 통합할 준비가 된 것입니다.

  • 대상 에이전트 또는 환경에서 로드하고 사용할 수 있습니다.
  • 해당 명령은 정의된 작업을 일관되게 수행합니다.
  • 필요한 리소스, 스크립트, 도구 및 데이터를 사용할 수 있습니다.
  • 사용 권한 및 외부 종속성은 개발 또는 테스트 환경에서 작동합니다.
  • 지원되지 않거나 실패한 작업은 이해할 수 있는 동작을 생성합니다.
  • 소유권, 버전 관리, 제한 사항 및 테스트 증거가 기록됩니다.

계획의 다른 구성 요소를 계속 진행합니다. 완료되면 구성 요소를 통합하고 테스트한 다음 패키지 & 테스트 로 이동하여 플러그인 패키지를 만듭니다.