appautomaton/agent-designer

언어: 영어 | 中文

AI 코딩 에이전트(AI coding agents) — Codex, Claude Code, Gemini를 위한 휴대 가능한 스킬 워크스페이스(skills workspace).

에이전트에게 명확한 워크플로우(workflows), 안전한 기본값(safe defaults), 다회차 협업 능력(multi-turn collaboration capabilities)을 부여하는 구조화되고 재사용 가능한 스킬(skills)을 설계하세요. 에이전트가 자유분방하게 작업하기보다 체계적으로 작업하기를 원하는 모든 프로젝트의 시작점으로 이 저장소(repo)를 클론(Clone)하세요.

협업 스킬 (Collaboration skills) — 세션 연속성(session continuity)을 가진 브릿지 스크립트(bridge scripts)를 통해 에이전트가 서로에게 작업을 위임할 수 있도록 합니다:

스킬 (Skill)	목적 (Purpose)
collaborating-with-claude	Claude Code CLI에 위임 (리뷰, diff, 컨설팅)
collaborating-with-antigravity	Antigravity CLI agy에 위임 (리뷰, 웹 검색, 이미지 분석)
collaborating-with-gemini	2026-06-18 폐기 예정 — Gemini CLI; collaborating-with-antigravity를 사용하세요
collaborating-with-codex	Codex CLI에 위임 (구현, 진단, 리뷰)

이슈 기반 개발 (Issue-driven development) — 작업을 계획(plans)과 추적 가능한 이슈 CSV(Issue CSVs)로 구조화합니다:

스킬 (Skill)	목적 (Purpose)
issue-driven-workflow	계획(Plan) → 이슈 CSV(Issue CSV) → 상태 추적을 포함한 자율 실행

팁 (Tip)

• (선택 사항) 이 저장소를 템플릿으로 사용하세요: 클론(clone)한 뒤, git 히스토리를 삭제(rm -rf .git)하고, 다시 초기화(git init)하세요.
• AGENTS.md를 작성하세요 — 프로젝트 역할, 제약 조건, 스택, 안전 규칙을 포함합니다.
• 이슈 기반 워크플로우를 추가하려면: 에이전트에게 "AGENTS.md 위에 AGENTS.issues.template.md를 적용해줘"라고 요청하세요.
• 작업 시작 — 에이전트에게 계획을 세우거나, 이슈 CSV를 생성하거나, 다른 에이전트와 협업하도록 요청하세요.
• 예시: "[대상]을 위한 계획과 이슈 CSV를 생성해줘."

skills/ ← 스킬 소스 (실제 콘텐츠)
collaborating-with-claude/ ← 브릿지 스크립트 + SKILL.md + 참조
collaborating-with-antigravity/ ← 브릿지 스크립트 + SKILL.md + 참조 (agy; gemini를 대체함)
...

각 스킬은 점진적 공개 (progressive disclosure) 방식을 따릅니다:

레벨 1 (메타데이터 (metadata))—name + description

YAML 프론트매터 (frontmatter)에 위치합니다. 항상 로드되며, 탐색 (discovery) 용도로 사용됩니다.

레벨 2 (instructions (지침))— SKILL.md 본문입니다. 스킬 (skill)이 호출될 때 로드됩니다. 워크플로 (workflow), 안전성 (safety), 빠른 시작 (quick start) 정보를 포함합니다.

레벨 3 (resources (리소스))— scripts/, references/, assets/를 포함합니다. 필요할 때 (on demand) 로드됩니다. 심층 문서 (deep docs), 템플릿 (templates), 헬퍼 스크립트 (helper scripts)를 포함합니다.

• 이 리포지토리 (repo)는 워크플로 우선 (workflow-first) 방식입니다 — 대부분의 변경 사항은 코드가 아닌 텍스트입니다.
• 브릿지 스크립트 (bridge scripts)는 CLI 도구들을 래핑 (wrap)하며, 세션 연속성 (session continuity)을 가진 구조화된 JSON을 반환합니다.
• 스킬 (skills)은 최소한의 조정만으로 Codex 및 Claude Code 간에 이식 가능합니다.
• 브릿지 스크립트 (bridge scripts)를 직접 호출하는 경우, python3를 권장합니다.

영감을 받은 곳: