Community코딩 & 개발github.com

a-freshcat/workspace-main-conversation

공유 작업 공간의 대화 분업, 파일 귀속 및 정리를 관리합니다. 활성화된 작업 공간에 진입하거나, 공유 쓰기 작업을 수행하거나, 흩어진 산출물을 정리할 때 사용합니다.

workspace-main-conversation란 무엇인가요?

이 스킬은 '작업 공간 협업 v2.1' 규칙을 구현하여 여러 AI 에이전트가 하나의 공유 작업 공간에서 효율적으로 협력할 수 있도록 지원합니다. 주요 기능으로는 역할 기반 작업 분업(주 대화/하위 대화), 파일 소유권 추적 및 충돌 방지, 작업 등록 및 상태 관리, 그리고 흩어진 산출물 정리 등이 있습니다. 대화 컨텍스트를 활용하여 작업 공간 상태를 최소한으로 유지하며, 필요 시에만 세부 정보를 읽어오는 방식을 채택합니다. Codex 및 DSH 플랫폼을 지원하며, 작업 공간 진입/복원, 작업 등록, 파일 쓰기 전 충돌 확인, 최종 요약 보고서 생성 등의 명령어를 제공합니다. 이를 통해 여러 AI 에이전트가 동일한 프로젝트에서 충돌 없이 협업할 수 있는 체계적인 프레임워크를 제공합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add a-freshcat/workspace-main-conversation

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

작업 공간 협업 v2.1

목표: 적은 상태로 협업을 지원하고, 세부 사항은 필요에 따라 읽습니다. 구체적인 작업 분담은 사용자 지정을 따릅니다. 스크립트 경로는 이 skill 디렉터리를 기준으로 합니다. 작업 공간 매개변수는 절대 경로를 사용합니다. Codex 및 DSH에 적용됩니다.

진입 또는 복원

node scripts/workspace.mjs context --workspace WORKSPACE --session SESSION을 실행합니다. SESSION은 실행 환경이 제공하는 현재 대화 ID를 사용합니다. ID를 얻을 수 없으면 unknown을 유지하며, 신원을 추측하거나 소유권을 주장하지 않습니다. 작업 공간이 활성화되지 않은 경우 사용자의 원래 작업을 계속합니다. 사용자가 명시적으로 주 대화를 지정하고 관리를 활성화한 경우에만 init을 실행합니다. 새 컨텍스트는 먼저 전체 브리핑을 가져옵니다. 동일한 컨텍스트의 후속 호출에서는 마지막으로 완전히 처리된 --since STAMP를 전달하여 변경 사항만 읽습니다. scope=declared-metadata는 등록 정보만 확인합니다. 이는 원본 파일이 변경되지 않았거나 등록되지 않은 대화가 존재하지 않음을 증명하지 않습니다.

실행

  • role=main: 등록된 작업을 집계하고, 알림을 처리하며, 충돌 및 중복 작업을 검토합니다. 단계가 끝나면 summary로 sum.md를 생성합니다.
  • role=child: 자신의 작업 기록과 산출물만 유지 관리합니다. 컨텍스트가 필요할 때는 우선 detail --task ID를 사용합니다.
  • 작업 수락, 상태 변경, 결과 인계 시 task --file INPUT.json으로 등록합니다. 필드 및 명령어는 명령어 참조를 참조하세요. 일반적인 응답은 대장을 수정할 필요가 없습니다.
  • 공유 쓰기 전에 먼저 writes를 등록합니다. 소유권 충돌이 발생하면 직렬로 인계합니다. check는 등록된 경로를 확인하고, 편집하기 전에 대상 파일을 다시 읽습니다.
  • sum.md는 주 대화 스크립트가 생성합니다. 하위 대화는 각자의 기록을 업데이트합니다. 동일한 내용은 작업 버전을 증가시키지 않습니다.

정보가 부족할 때

more=true는 동일한 --since와 --offset NEXT를 사용하여 관련 페이지를 모두 읽은 다음 stamp를 저장합니다. unknown, 불완전한 스캔 또는 구문 분석 오류는 모두 문제로 유지됩니다. 자세한 파일 검사는 check --offset N을 사용합니다. 흩어진 산출물, 소유권 불명 또는 소유권 주장(claims)을 발견하면 소유권 주장 및 정리를 읽습니다. DSH 로그 단서가 필요한 경우에만 포렌식 명령어를 읽습니다. 이전 작업 공간 활성화는 마이그레이션을 참조하세요. 일상적인 작업은 브리핑만 읽습니다. 현재 사용 가능한 상태에만 의존합니다. 주 대화 인계는 명시적인 handoff를 사용합니다. 파일 시간이 대화 실행 여부를 의미하지는 않습니다. 이러한 기록은 협업을 조정하지만, 도구 권한을 대체하지 않으며 규약을 따르지 않는 외부 쓰기를 막지 않습니다.

관련 스킬