TL;DR

  • agent-topics는 큰 프로젝트의 논의를 주제별로 나누고, 주제마다 서브에이전트 하나를 배정해 결론에 도달한 뒤 메인 세션에서 통합하는 도구임.
  • 서브에이전트 세션은 셸(shell)을 활용해 살아 있는 상태로 유지되며, 사용자가 마무리하라고 지시할 때만 보고함.
  • Claude Code 버전은 플러그인 마켓플레이스 설치와 수동 설치를 지원함.
  • opencode 버전은 테스트 중이며, 스킬과 명령 파일을 각각의 디렉터리에 복사하는 방식임.
  • 두 버전은 스킬 이름을 공유하므로, 하네스(harness)에 맞는 버전 하나만 설치해야 이름 충돌을 피할 수 있음.

agent-topics

  • 결론에 도달할 때까지 서브에이전트와 대화를 진행하고, 이후 모든 내용을 메인 세션에서 통합하는 방식임.
  • 여러 작업을 동시에 추적하고 의도에 따라 집중 대상을 나누는 데 적합함.
  • 셸을 활용해 서브에이전트 세션을 계속 유지함.

스킬

  • agent-topics: 논의를 여러 주제로 나누고 주제마다 서브에이전트 하나를 배정함. 각 에이전트와 직접 대화할 수 있으며, 메시지 사이에는 대기하다가 마무리 지시를 받으면 결과를 보고함.
  • Claude Code: 사용 가능함.
  • opencode: 개발 진행 중임.

설치 — Claude Code

  • 저장소를 플러그인 마켓플레이스로 추가한 뒤 스킬을 설치하는 방식임: claude plugin marketplace add codechriscode/agent-topics, claude plugin install agent-topics@agent-topics.
  • 세션 안에서 /plugin marketplace add codechriscode/agent-topics와 /plugin install agent-topics@agent-topics를 실행하는 설치 방법도 있음.
  • 스킬 이름은 agent-topics이며 플러그인 맥락에서는 agent-topics: 접두사가 붙음. 스킬이 바로 표시되지 않으면 세션을 재시작하거나 /reload-plugins를 실행함.

수동 설치 — 마켓플레이스 미사용

  • agent-topics 저장소를 복제한 뒤 스킬 폴더를 개인 스킬 디렉터리로 복사함: git clone https://github.com/codechriscode/agent-topics, mkdir -p ~/.claude/skills, cp -r agent-topics/claude/agent-topics/skills/agent-topics ~/.claude/skills/.

설치 — opencode(진행 중, 테스트 중)

  • opencode 버전은 두 개의 파일로 구성되며, 스킬과 명령을 별도 디렉터리에 두므로 두 파일을 모두 복사함.
  • agent-topics 저장소를 복제하고 디렉터리를 만든 뒤 파일을 복사함: git clone https://github.com/codechriscode/agent-topics, mkdir -p ~/.config/opencode/skills/agent-topics ~/.config/opencode/command, cp agent-topics/opencode/agent-topics/SKILL.md ~/.config/opencode/skills/agent-topics/, cp agent-topics/opencode/agent-topics/command/agent-topics.md ~/.config/opencode/command/.
  • 이후 /agent-topics <topics>를 리터럴 슬래시 명령으로 사용할 수 있으며, 구문을 통해서도 스킬이 활성화됨.

두 버전 공통 사항

  • 두 버전은 같은 스킬 이름을 사용함. opencode도 ~/.claude/skills/를 읽으므로, 두 버전을 검색 대상 디렉터리에 함께 설치하면 이름 충돌이 발생함.
  • 사용하는 하네스에 맞는 버전 하나만 설치함.

유지 관리 담당자용

  • 플러그인을 수정한 뒤 푸시하기 전에 claude plugin validate .로 검증함.

라이선스

  • MIT