기술

딥시크가 공개한 슈퍼에이전트, 깃허브에서 부르면 PR로 답한다

딥시크가 10월 31일 깃허브에 공개한 dsh-superagent-prototype은 저장소 하나를 맡아 부르면 일하고 풀 리퀘스트로 답하는 에이전트입니다. 하는 일, 원칙, 설치 전에 알아 둘 조건을 README 기준으로 정리했습니다.

딥시크가 10월 31일 깃허브에 dsh-superagent-prototype을 올렸습니다. 11월 4일 기준 스타 17,897개, 포크 1,934개입니다. 라이선스는 MIT입니다.

근거: 저장소 README, SETUP.md, docs/000-philosophy.md, docs/002-authorization.md. 2026년 11월 4일에 읽었습니다. 직접 설치해 보지는 않았습니다.

하는 일

dsh-superagent는 깃허브 저장소 하나를 맡는 코딩 에이전트입니다. 딥시크의 에이전트 실행 환경인 DeepSeek Harness용 번들로 나왔습니다.

  1. 깃허브(선택하면 Feishu 채팅까지)를 지켜보다가, 허락된 사람이 부르면 작업 항목을 엽니다.
  2. 작업마다 따로 에이전트 세션과 폴더를 만들어 일합니다.
  3. 요청이 온 그 대화에 답합니다. 깃허브라면 보통 풀 리퀘스트입니다.

웹 패널은 사람이 손대야 할 것만 보여 줍니다.

원칙: 사람 주의를 가장 적게

README와 철학 문서가 가장 앞에 두는 문장은 “사람의 주의는 가능한 한 적게 쓰고, 가치는 가능한 한 많이 준다”입니다. 여기서 몇 가지 규칙이 나옵니다.

  • 부를 때만 움직입니다. 허락 목록에 있는 사람이 에이전트를 직접 불러야 요청으로 칩니다. 아무도 시키지 않은 일은 팀이 적어 둔 규칙이 있어야 하고, 처음에는 “했을 일”을 기록만 하는 모드로 시작합니다.
  • 필요할 때만 말합니다. 요청을 받으면 한 번 확인하고, 일하는 동안은 조용합니다. 결과가 나왔거나, 결정이 필요하거나, 끝내지 못했을 때 다시 씁니다.
  • 질문은 한 번에 하나. 긴 보고서 안에 묻어 두지 않습니다.
  • 메시지는 권한을 바꾸지 못합니다. 허락 목록과 규칙은 호스트가 지킵니다. 이슈나 댓글에 적힌 글은 판단 재료일 뿐입니다.

마지막 항목은 남이 쓴 이슈 본문으로 에이전트를 조종하려는 시도를 막는 장치입니다. 에이전트를 팀 저장소에 붙일 때 가장 먼저 걱정하는 부분이라 눈여겨볼 만합니다.

설치 전에 알아 둘 것

  • 연구용 시제품입니다. README 첫 줄이 “참고용 연구 시제품이며 딥시크의 정식 제품이 아니다”입니다. 버그가 있을 수 있고 코드 스타일도 고르지 않다고 적었습니다. 함께 낸 글에서 말한 설계 일부는 아직 구현되지 않았습니다.
  • 에이전트 전용 깃허브 계정이 필요합니다. 운영자 본인 계정은 권하지 않습니다. 에이전트가 쓰는 모든 글이 그 이름으로 남기 때문입니다.
  • 준비물이 많습니다. Node.js 22.19 이상, pnpm, git 2.32 이상, tmux, Python 3.8 이상, GitHub CLI 2.48 이상, DeepSeek Harness(DSH)와 모델 제공자 설정이 필요합니다.
  • 설치는 코딩 에이전트에게 맡기는 방식입니다. “이 저장소의 SETUP.md를 읽고 같이 설치하자”고 말하면, 에이전트가 질문을 하나씩 하고 전체 계획을 한 번 보여 준 뒤 설치합니다. 비밀값은 채팅으로 받지 않습니다.
  • 자동 병합은 기본으로 꺼 둡니다. 권장 답도 “사람이 병합”입니다.

오늘 할 일

설치보다 docs/000-philosophy.md 한 장을 먼저 읽어 보길 권합니다. 쓰는 에이전트가 무엇이든, “언제 말을 걸고 언제 조용할지”를 정하는 기준으로 쓸 수 있습니다.

쇼츠로 보기

이 글은 비치콤버스 쇼츠 No.23의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/23.

김현빈 Developer & Writer

기술, 포스팅 관련 질문, 프로젝트 협업 등 연락주시면 언제든지 회신 드립니다.

esc

↑↓ 고르기↵ 열기? 단축키

해변에서 주운 것

읽으러 가기 →
guest@beachcombers — zsh

단축키

⌘K 또는 /
글·작업·개발일지 찾기
R
해변 산책 — 아무 글 하나 줍기
`
터미널 열기
←→
쪽 넘기기 (휠·스와이프도 됩니다)
?
이 안내
esc
닫기