chief-of-staff로 서브 에이전트를 통합해 장기 목표를 진행하기
機械翻訳 / Machine-translated
원문: chief-of-staffでサブエージェントを束ねて長期目標を進める（cccskills）
스킬 페이지: chief-of-staff
이 글의 결론
chief-of-staff를 도입하면 Claude Code나 Codex의 에이전트가 장기 목표의 진행 담당자가 됩니다.
작업은 서브 에이전트에게 배분하고, 진행 담당자 자신은 이용자와의 대화를 계속하는 형태입니다.
이 글에서는 Wiki를 통한 기록 방법과 작업 환경을 개선하는 사고방식을 설명합니다.
후반부에는 설치 방법과 요청문 예시도 소개합니다.
chief-of-staff를 호출하면, 에이전트는 목표의 책임자로서 행동합니다.
직접 손을 움직이지 않고 작업을 서브 에이전트에게 맡기는 진행 담당자입니다.
요청 예시는 다음과 같습니다.
/chief-of-staff 사내용 관리 화면을 Next.js로 마이그레이션하는 목표를, 여러 번의 교환으로 나눠 진행하고 싶습니다.
진행 담당을 부탁드립니다.
처음에 나오는 것은 Wiki 위치에 관한 상의입니다.
Wiki는 서로 링크된 Markdown 페이지를 모은 폴더로, 세션이 끝나도 남아 있는 기억으로 사용됩니다.
아직 Wiki가 없는 목표라면, 처음 기록하기 전에 이용자와 위치를 정하게 됩니다.
위치가 정해지면 실제 작업은 백그라운드 서브 에이전트에게 배분됩니다.
진행 담당자와의 대화는 막히지 않으므로, 마이그레이션 도중에도 우선순위 변경이나 궁금한 점을 그 자리에서 상의할 수 있습니다.
서브 에이전트에 대한 지시는 간략하게 정리됩니다.
정보는 조사 메모나 과거 커밋, Wiki 페이지의 위치를 알려주는 방식으로 전달됩니다.
이 스킬의 특징은, 작업에 들어가기 전에 에이전트가 동작하는 환경을 어떻게 개선할지를 반드시 먼저 고민한다는 점입니다.
마이그레이션 작업을 진행하는 동시에, 오류를 방지하는 Lint 규칙 추가나 개발 서버 로그를 읽을 수 있게 하는 제안이 돌아옵니다.
chief-of-staff는 장기 목표를 하나의 세션에서 계속 추적하기 위한 진행 방식을, 통합하여 에이전트에게 부여하는 스킬입니다.
내용은 다음 5가지로 나눌 수 있습니다.
진행 담당자는 두 가지 관점을 병행하여 갖습니다.
하나는 "당면 과제를 어떻게 해결할 것인가"라는 전술적 관점입니다.
다른 하나는 "다음 과제가 원활하게 진행되도록 환경을 어떻게 바꿀 것인가"라는 전략적 관점입니다.
작업은 모두 서브 에이전트가 수행하고, 진행 담당자는 자신의 컨텍스트 윈도우(한 번에 기억할 수 있는 대화의 양)를 비워 둡니다.
백그라운드에서 동작하는 에이전트를 사용하므로, 이용자와의 대화는 멈추지 않습니다.
설명을 반복하지 않도록, 이미 있는 자료는 위치를 알려주는 것만으로 공유합니다.
대화 안에만 있는 지식은 대화가 압축되면 사라집니다.
그래서 진행 담당자는 결정 사항이나 반복적으로 발생하는 문제, 이용자의 선호 등을 1페이지에 1테마씩 Wiki에 기록합니다.
index.md에 두는 것은 전체 페이지 목록과 각 페이지의 한 줄 요약입니다.
이슈나 풀 리퀘스트, 서브 에이전트의 보고 같은 원본 자료는 옮겨 쓰지 않고 출처로서 인용합니다.
Wiki를 유용한 상태로 유지하기 위한 작업은 다음 3가지입니다.
| 작업 | 타이밍 | 내용 |
|---|---|---|
| Ingest | 오래 도움이 될 것을 알게 됐을 때 | 관련 페이지 전체와 index.md를 업데이트한다 |
| Query | 판단하기 전 | index.md와 참조처를 읽고, 남길 가치 있는 답변은 페이지로 만든다 |
| Lint | 정기적으로 | 모순, 고립된 페이지, 링크 오류, 오래된 기술을 찾는다 |
Wiki는 "현재 상태"가 아니라 이력으로 기록하는 것이 규칙입니다.
기술에는 "2026-10-13에 ○○로 결정했다"와 같이 날짜를 붙입니다.
코드에 관한 기술에는, 그 내용이 올바른 시점의 커밋을 리포지토리 이름과 함께 첨부합니다.
상황이 바뀌어도 오래된 기술은 고쳐 쓰지 않습니다.
새로운 날짜의 기술을 추가하고, 오래된 쪽에는 대체되었음을 표시합니다.
진행 담당자는 에이전트가 무리 없이 올바르게 작업할 수 있는 환경 조성에 힘씁니다.
이용자의 메시지를 받을 때마다 개선의 여지를 찾는 것도 요구되는 역할 중 하나입니다.
개선 대상은 다음과 같습니다.
아울러 "우회책을 만들지 않는다"는 규칙도 지키게 합니다.
임시방편 핵은 인정하지 않으며, 규약에서의 이탈은 기능 개발 전에 수정하는 것이 원칙입니다.
실행 환경이 지원하는 경우, 목표 달성에 도움이 되는 정기 스케줄을 제안합니다.
Wiki의 Lint도 정기 실행의 후보로 제시되는 작업 중 하나입니다.
터미널에서 다음 명령어를 실행하세요.
Claude Code나 Codex 등 설치할 에이전트는 실행 중에 선택할 수 있습니다.
npx skills add https://github.com/mattpocock/skills --skill chief-of-staff
에이전트에게 설치를 맡기는 경우, 다음 문장을 그대로 보내세요.
내용 확인부터 배치까지 맡길 수 있습니다.
次の Agent Skill をインストールしてください。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/chief-of-staff
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/chief-of-staff/、Codex なら ~/.agents/skills/chief-of-staff/ に配置してください。
저장 위치는 모든 프로젝트에서 사용할지, 특정 프로젝트에서만 사용할지에 따라 선택하세요.
| 에이전트 | 모든 프로젝트에서 사용 | 특정 프로젝트에서만 사용 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 프로젝트의 .claude/skills/ |
| Codex | ~/.agents/skills/ | 프로젝트의 .agents/skills/ |
이 스킬은 에이전트가 스스로 판단하여 호출하지 않도록 설정되어 있습니다.
사용할 때는 Claude Code라면 /chief-of-staff와 같이 이름을 지정하여 호출하세요.
요청문에 장기 목표와 현재 상황을 적어 두면 대화가 빠르게 진행됩니다.
대표적인 예시는 다음 3가지입니다.
/chief-of-staff 자사 서비스의 테스트를 정비하여 릴리스 전 수동 확인을 줄이고 싶습니다.
이 목표의 담당을 정리하여 진행해 주세요.
Wiki가 없으면 위치 상의부터 시작합니다.
그 후 조사나 테스트 작성은 서브 에이전트에게 배분되고, 진행 담당자는 진행 상황 보고와 다음 판단 상의를 담당하는 형태입니다.
작업을 진행하면서, 다음 작업이 수월해지는 규약이나 환경 개선도 검토해 주세요.
진행 중인 작업과 별개로 개선안이 돌아옵니다.
오류를 감지하는 Lint 규칙 추가나 CODING_STANDARDS.md 정비, 로그 및 테스트 환경 데이터베이스를 읽을 수 있게 하는 안 등입니다.
이 목표에서 계속해야 하는 정기 작업이 있나요?
실행 환경이 지원하는 경우, Wiki Lint 같은 정기 스케줄이 제안됩니다.
지원하지 않는 환경에서는 이 제안이 나오지 않습니다.
사용하기 전에 실행 환경과 권한 처리를 확인하세요.
같은 mattpocock/skills 리포지토리에는 장기 작업의 전후에 조합하기 좋은 스킬이 있습니다.
claude-handoff는 진행 중인 대화를 인계용으로 요약하여 새로운 백그라운드 에이전트에게 전달하는 스킬입니다.
대화가 길어졌을 때 작업 방침과 참조 자료를 정리하여 이어서 맡길 수 있습니다.
code-review는 지정한 커밋이나 브랜치를 기준으로 변경 사항을 확인하는 스킬입니다.
개발 규약 준수와 사양 구현을 나누어 보고하므로, chief-of-staff로 정비한 규약이 지켜지고 있는지 확인하는 데 적합합니다.
ask-matt는 상황에 맞는 관련 스킬과 사용 순서를 안내해 주는 상담 담당자입니다.
다음에 어떤 스킬을 사용할지 망설일 때 상의할 수 있습니다.
자동으로는 동작하지 않습니다.
에이전트가 스스로 판단하여 호출하지 않는 설정이므로, 이름을 지정하여 호출해야 합니다.
중요한 경위는 Wiki에 남습니다.
대화 안에만 있는 지식은 압축으로 사라지므로, 결정 사항과 발견 내용을 날짜와 함께 Wiki에 기록하여 다음 세션으로 이어가는 구조입니다.
스킬의 범위는 실행 환경이 지원하는 경우에 정기 스케줄을 제안하는 것까지입니다.
실제로 등록할지 여부는 제안을 보고 이용자가 결정하세요.
chief-of-staff는 장기 목표의 진행 담당을 에이전트에게 맡기는 스킬입니다.
작업은 서브 에이전트에게 배분되고, 이용자는 진행 담당자와 대화를 계속하면서 판단에 집중할 수 있습니다.
경위는 날짜가 붙은 Wiki에 기록되며, 요청할 때마다 규약이나 작업 환경의 개선안도 제시됩니다.
자세한 내용은 cccskills 페이지를 확인하세요.
이 글은 cccskills의 읽을거리 「chief-of-staffでサブエージェントを束ねて長期目標を進める」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 chief-of-staff 페이지에 있습니다.