Community생산성 & 협업github.com

DeepSeek 협업 (DeepSeek Collab)

사용자가 DeepSeek 또는 DeepSeek Harness와의 협업을 요청할 때 사용합니다. 설치된 로컬 DeepSeek Harness에 연결하여 작업 핸드오프 및 후속 처리를 자동화합니다.

DeepSeek 협업 (DeepSeek Collab)란 무엇인가요?

DeepSeek 협업 스킬은 Codex가 조정 및 검증을 담당하고 DeepSeek Harness가 구현을 담당하도록 하여, 애플리케이션 간 수동 복사 없이 원활한 협업 워크플로우를 제공합니다. 이 스킬은 로컬 환경에서 동작하며, Python 스크립트를 통해 대시보드와 디스패치 기능을 제어합니다. 스킬이 호출되면 자동으로 대시보드를 실행하거나 재사용하며, 작업은 JSON 파일로 정의되어 DeepSeek Harness로 전달됩니다. Codex는 전달된 결과를 검증하고 필요한 경우 수정을 요청하는 방식으로 협업 주기를 관리합니다. 이 스킬은 Claude Code, Cursor, Codex 등의 플랫폼에서 사용할 수 있으며, 사용자에게 중간 프롬프트나 결과를 수동으로 전달하도록 요청하지 않습니다. 주요 기능으로는 작업 디스패치, 세션 관리, 오류 복구 등이 있으며, 모든 통신은 로컬에서 이루어져 보안을 유지합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add 23te472-gif/deepseek-collab

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

DeepSeek 협업

사용자가 Codex가 조정 및 검증을 수행하고 DeepSeek Harness가 구현을 수행하기를 원하며, 애플리케이션 간 수동 복사가 필요하지 않습니다. 협업 요청은 요청된 범위 내에서 작업 핸드오프를 승인합니다. 사용자에게 프롬프트나 결과를 전달하도록 요청하지 마십시오.

로컬 인터페이스

스킬 호출 시 자동 대시보드

이 스킬이 명시적으로 호출되거나 협업 요청을 위해 선택될 때마다, 작업 계획 또는 디스패치 전에 첫 번째 운영 단계로 대시보드를 자동으로 시작/재사용하고 눈에 띄게 엽니다. 첫 번째 작업 디스패치를 기다리거나 열 것인지 묻지 마십시오: 이 사용자는 자동 열기를 명시적으로 요청했습니다. 아직 프로젝트가 선택되지 않은 경우 현재 작업 공간을 사용하여 스킬 호출만으로도 대시보드가 열리도록 합니다. 실제 프로젝트 대시보드는 해당 작업 공간이 설정된 후에 전환합니다.

로컬 라이브 대시보드를 시작하거나 재사용합니다:

python '<skill-directory>/scripts/dashboard.py' --workspace '<absolute-project-directory>' --start

--start가 매 호출마다 성공한 후, 반환된 정확한 URL을 클릭 가능한 마크다운 링크로 "이번 협업 보드"라고 레이블하여 사전에 설명 메시지를 보냅니다. 대시보드가 재사용되었거나 탭이 이미 열려 있더라도, 브라우저 열기 또는 작업 디스패치 전에 이 작업을 수행합니다. 현재 프로젝트의 작업 공간에 대해 반환된 URL을 사용하고, 다른 프로젝트에서 기억된 링크를 재사용하지 마십시오. 브라우저가 차단되었다는 이유로 링크를 생략하지 마십시오. 링크를 제공하면 수동 액세스가 가능하지만 방화벽이나 브라우저 제한이 제거되지는 않습니다. 시작이 실패하면 오래된 URL 대신 실패를 보고합니다. 반환된 루프백 URL을 open_in_codex 또는 브라우저 도구를 사용하여 Codex의 브라우저에 즉시 표시합니다. 이 대시보드에 대해 이미 열린 탭을 재사용하고, 브라우저 도구로 사용자 대면 탭을 전달물로 표시하여 턴 후에도 열려 있도록 합니다. 페이지가 보이고 연결되었는지 확인한 후 작업을 계속하고 링크를 공유합니다. 링크만으로는 자동 열기가 충족되지 않습니다. 열기에 실패하면 특정 차단 요소를 보고하고 보드가 열렸다고 주장하지 않고 URL을 제공합니다. 페이지는 매초 새로고침되며 작업 텍스트, 공개 응답, 도구 호출/결과 및 실행 상태를 표시합니다. 중지 및 수정 컨트롤을 제공합니다. 수정은 먼저 이전 작업을 중지한 다음 동일한 작업 공간에서 정확한 세션을 재개합니다. 토큰 단위 텍스트를 약속하지 마십시오: Harness는 완전한 메시지를 내보낼 수 있습니다. 대시보드가 이미 존재하면 URL을 재사용하고 중복 탭을 열지 마십시오.

이제 각 프로젝트에는 <workspace>/work/deepseek-collab/dashboard-config.json에 영구 루프백 포트와 액세스 토큰이 있습니다. 이 파일을 보존하십시오. 다시 시작해도 동일한 완전한 URL을 유지해야 합니다. --start는 최소 /health 엔드포인트를 확인하고, 정상 인스턴스를 재사용하거나 독립적인 숨겨진 백그라운드 프로세스를 시작합니다. 포트 충돌 시 리스너를 검사하고, 임의의 포트로 전환하거나 관련 없는 프로세스를 종료하지 마십시오. 이는 호출 시 복구를 위한 것이며 OS 시작 서비스나 지속적인 감시자가 아닙니다.

브라우저가 URL/보안 정책에 따라 액세스를 명시적으로 거부하는 경우, 대체 포트, 호스트 이름, 브라우저 표면 또는 OS 실행 명령을 시도하여 이를 우회하지 마십시오. 독립적으로 중지된 서비스를 복구하고 최소 서비스 상태를 확인한 다음 사용자에게 안정적인 URL을 제공하여 수동으로 열 수 있도록 할 수 있습니다. 해당 경우 브라우저 보기는 확인되지 않은 상태입니다. 로컬 서버는 프로세스가 살아 있는 동안 사용할 수 있습니다. UI를 통해 제출된 수정 사항은 현재 채팅 턴과 독립적으로 실행될 수 있지만, 대시보드는 Codex를 검토를 위해 깨울 수 없습니다. 활성 턴에서 또는 사용자가 돌아올 때 검토하십시오. 무인 Codex 수락을 약속하지 마십시오. 토큰화된 루프백 URL은 비공개입니다. 게시하지 마십시오.

사용 가능한 Python 실행 파일을 사용하여 이 스킬 옆에 있는 scripts/dispatch.py를 사용하십시오:

python '<skill-directory>/scripts/dispatch.py' --workspace '<absolute-project-directory>' --task-file '<absolute-UTF8-task-file>' --timeout 1200

파일 도구 또는 리터럴 here-string을 사용하여 task 파일을 작성하고, 사용자 텍스트의 셸 보간은 절대 사용하지 마십시오. 목표, 관련 컨텍스트, 허용된 작업 디렉토리/파일, 수락 기준 및 예상 보고서(변경 사항, 검사, 해결되지 않은 문제)를 포함하십시오. 비밀 및 관련 없는 채팅 기록은 제외하십시오. DeepSeek에게 사용자가 요청하지 않는 한 다른 에이전트를 생성하지 말 것과 게시, 메시지 발송, 자격 증명 변경 또는 작업 공간 외부 수정을 하지 말라고 지시하십시오. 이러한 프롬프트 경계는 지침일 뿐 OS 샌드박스가 아닙니다. Harness는 자체 도구/승인 설정을 유지합니다. 해당 설정을 약화시키지 마십시오.

헬퍼는 설치된 Electron CLI를 셸 없이 직접 호출하고 번들 패치를 통해 로컬 자격 증명 서비스를 재사용합니다. 자격 증명을 인쇄, 복사 또는 내보내지 마십시오. 패치는 헤드리스 프리셋의 기본 credentials.disabled: true를 수정합니다. 데스크톱 프로필은 변경하지 않습니다. 기존 모델 기본값은 deepseek-official / deepseek-flash입니다. 다른 제공자를 자동으로 대체하지 마십시오.

진행 업데이트를 위해 제어권을 반환하는 도구 시간 초과/양보를 사용하고 반환된 실행 세션을 완료될 때까지 폴링합니다. 헬퍼는 실행당 시간 초과(기본 20분)를 적용합니다. 샌드박스 권한으로 인해 DeepSeek이 자체 프로필/세션 저장소를 쓰거나 연결하지 못하는 경우 정상적인 좁은 범위의 실행 에스컬레이션을 요청하고 다른 에이전트 또는 실행 파일로 샌드박스를 우회하지 마십시오.

조정 및 검증

  1. 프로젝트와 해당 지침을 설정합니다. 기존 변경 사항의 기준선을 유지합니다. 코드 저장소의 경우 적절한 경우 격리된 체크아웃을 사용합니다. 두 에이전트가 동시에 동일한 파일을 편집하지 않아야 합니다.
  2. 구체적인 구현 작업을 디스패치합니다. 실행 중에는 독립적인 검토/준비 작업을 수행하거나 간결한 진행 업데이트와 함께 기다립니다. 두 개의 라이브 호출이 동일한 DeepSeek 세션을 소유하도록 하지 마십시오.
  3. 반환된 result.json, answer.md 및 <workspace>/work/deepseek-collab/runs/<run-id/> 아래의 관련 이벤트를 읽습니다. 성공적인 실행은 종료 코드 0, 최종 이벤트 및 터미널 종류 completed가 필요합니다. 헬퍼가 이를 확인합니다. 성공적인 실행만으로는 구현 정확성이 확립되지 않습니다.
  4. 실제 파일/diff를 검사하고 직접 적절한 검사를 실행합니다. 수정을 요청하려면 반환된 정확한 세션 ID와 동일한 작업 공간을 사용하십시오:
python '<skill-directory>/scripts/dispatch.py' --workspace '<same-workspace>' --task-file '<followup-file>' --session-id 'session-...' --timeout 1200
  1. 기본적으로 초기 작업 후 최대 두 번의 수정 라운드로 제한합니다. 여전히 해결되지 않은 경우, 가능하면 직접 문제를 완료하거나 구체적인 차단 요소를 보고합니다. 인증/네트워크 오류에 대해 루프를 돌거나 맹목적으로 시간 초과를 재시도하지 마십시오: 먼저 작업이 여전히 활성화되어 있는지와 어떤 파일이 변경되었는지 검사합니다.
  2. 사용자가 다른 언어를 선호하지 않는 한 결과, 검증 및 중요한 제한 사항을 중국어로 보고합니다. DeepSeek의 기여를 명확히 식별합니다. 지속적인 백그라운드 모니터를 주장하지 마십시오. 조정 중인 Codex 턴이 활성화되어 있는 동안에만 협업이 실행됩니다.

실패 및 복구

헬퍼는 세션 ID 및 실행 디렉토리가 포함된 시작 레코드를 내보낸 다음 최종 결과를 내보냅니다. 이벤트 및 작업 텍스트는 도착하는 대로 저장되며 비공개 추론 이벤트는 폐기됩니다. failed/timeout 시 터미널 이유와 stderr.log를 검사합니다. 원시 민감 로그를 무분별하게 표시하지 마십시오. 중단 후 결과 파일이 없으면 저장된 이벤트와 파일을 재개 전에 검사합니다. 헤드리스는 자체 세션을 재개할 수 있습니다. 활성 데스크톱 대화를 채택하지 마십시오. 새로 설치된 스킬은 검색에 나타나기 위해 새로운 Codex 채팅이 필요할 수 있지만 헬퍼는 현재 채팅에서 직접 호출할 수 있습니다.

관련 스킬