SoDam Agent Codex — Development skill for Claude Code

SoDam-Agent-Codex

AI나 명령어를 처음 쓰는 사람도 따라 할 수 있는 SoDam-Agent Codex 포팅판 설치·사용 안내서

SoDam-Agent-Codex는 원본 **SoDam-Agent**의 전문 역할을 Codex에서 선택해 사용할 수 있도록 옮긴 저장소형 플러그인 마켓플레이스입니다. 웹앱 개발, 문서 작성, 리서치, 데이터, 마케팅, 보안 감사, DevOps, 고객지원, 제품관리, 번역을 위한 10개 팀과 사용자 소유 스킬을 안전하게 관리하는 1개 플러그인을 제공합니다.

이 저장소 자체는 별도 웹사이트, 모바일 앱, 서버 또는 데이터베이스가 아닙니다. Codex CLI에 마켓플레이스를 등록하고 필요한 플러그인을 추가하면, Codex가 포함된 `SKILL.md` 지침을 읽어 작업에 적용합니다.

언어와 문서 형식

• 한국어 Markdown: README.md
• English Markdown: README.en.md
• 한국어 HTML: README.html
• English HTML: README.en.html

네 문서는 프로젝트 최상위 폴더에 있습니다. 각 HTML 문서는 대응하는 Markdown 원문에서 생성되어 같은 내용을 담습니다.

목차

1. 처음 보는 분을 위한 한 문장 설명
2. 현재 상태와 확인 범위
3. 사전 준비물과 필요 프로그램
4. 다운로드 방법
5. 설치 방법
6. 5분 빠른 시작
7. 실행·사용 방법
8. 작동 원리와 워크플로우
9. 플러그인과 스킬 전체 목록
10. 명령어 모음
11. 폴더 구조와 아키텍처
12. 보안과 데이터 흐름
13. 파일·문서 위치
14. 개발·검증 방법
15. 업데이트 내용 요약
16. 문제·오류 대처
17. FAQ
18. 법률·저작권·라이선스·상업적 이용
19. 현재 한계와 미확인 항목
20. 업데이트·기여 체크리스트
21. 원본과 출처

1. 처음 보는 분을 위한 한 문장 설명

이 프로젝트는 **Codex 안에 전문가별 업무 설명서를 추가하는 도구 상자**입니다. 예를 들어 `docs-team`을 설치한 뒤 “문서팀으로 초보자 안내서를 작성해줘”라고 요청하면, 문서 작성·편집·사실 확인 역할의 지침을 작업에 적용합니다.

알아둘 점은 다음과 같습니다.

• 자동으로 모든 팀이 항상 실행되는 것은 아닙니다. 설치한 플러그인과 요청 내용에 따라 필요한 스킬을 사용합니다.
• 팀 스킬은 작은 요청이면 필요한 역할만 사용합니다.
• 사용자가 팀 작업이나 병렬 처리를 명시적으로 요청하지 않는 한 서브에이전트를 자동으로 만들지 않습니다.
• 삭제, 배포, 외부 전송처럼 영향이 큰 작업은 사용자 권한과 확인이 필요합니다.
• AI 결과는 검토가 필요합니다. 특히 법률, 보안, 개인정보, 배포 결과는 사람의 최종 확인이 필요합니다.

2. 현재 상태와 확인 범위

확인된 내용

• 마켓플레이스에 등록된 플러그인: 11개
• 전체 스킬: 46개
  • 팀 조율 스킬 10개
  • 전문 역할 스킬 31개
  • 사용자 스킬 관리 스킬 5개
• 플러그인 매니페스트: 현재 형식 plugin.json과 호환 형식 .codex-plugin/plugin.json을 함께 제공
• 웹앱팀과 리서치팀만 Context7 MCP 4.1.1을 사용하