Back to Details

agentic-workflow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AI 에이전트 워크플로우 (Workflow & Productivity)

AI Agent工作流（Workflow & Productivity）

When to use this skill

何时使用该Skill

  • 일상적인 AI 에이전트 작업 최적화
  • Git/GitHub 워크플로우 통합
  • MCP 서버 활용
  • 세션 관리 및 복구
  • 생산성 향상 기법 적용
  • 日常AI Agent工作优化
  • Git/GitHub工作流集成
  • MCP服务器运用
  • 会话管理与恢复
  • 生产力提升技巧应用

1. 에이전트별 주요 명령어

1. 各Agent核心命令

Claude Code 명령어

Claude Code命令

명령어기능사용 시점
/init
CLAUDE.md 초안 자동 생성새 프로젝트 시작
/usage
토큰 사용량/리셋 시간 표시매 세션 시작
/clear
대화 내용 초기화컨텍스트 오염 시, 새 작업 시작
/context
컨텍스트 윈도우 X-Ray성능 저하 시
/clone
대화 전체 복제A/B 비교 실험, 백업
/mcp
MCP 서버 관리MCP 활성화/비활성화
!cmd
Claude 처리 없이 즉시 실행빠른 상태 확인
命令功能使用时机
/init
自动生成CLAUDE.md初稿新项目启动时
/usage
显示令牌使用量/重置时间每次会话开始时
/clear
清空对话内容上下文污染时、新任务启动时
/context
上下文窗口X-Ray性能下降时
/clone
复制整个对话A/B对比实验、备份时
/mcp
MCP服务器管理启用/禁用MCP时
!cmd
无需Claude处理立即执行快速状态检查时

Gemini CLI 명령어

Gemini CLI命令

명령어기능
gemini
대화 시작
@file
파일 컨텍스트 추가
-m model
모델 선택
命令功能
gemini
启动对话
@file
添加文件上下文
-m model
选择模型

Codex CLI 명령어

Codex CLI命令

명령어기능
codex
대화 시작
codex run
명령 실행
命令功能
codex
启动对话
codex run
执行命令

2. 키보드 단축키 (Claude Code)

2. 键盘快捷键（Claude Code）

필수 단축키

必备快捷键

단축키기능중요도
Esc Esc
마지막 작업 즉시 취소최고
Ctrl+R
이전 프롬프트 히스토리 검색높음
Shift+Tab
x2		계획 모드 토글높음
Tab
/ 
Enter
프롬프트 제안 수락중간
Ctrl+B
백그라운드로 보내기중간
Ctrl+G
외부 에디터로 편집낮음
快捷键功能重要度
Esc Esc
立即撤销最后操作最高
Ctrl+R
搜索历史提示词高
Shift+Tab
x2		切换计划模式高
Tab
/ 
Enter
接受提示词建议中
Ctrl+B
转入后台中
Ctrl+G
外部编辑器编辑低

에디터 편집 단축키

编辑器编辑快捷键

단축키기능
Ctrl+A
줄 시작으로 이동
Ctrl+E
줄 끝으로 이동
Ctrl+W
이전 단어 삭제
Ctrl+U
줄 시작까지 삭제
Ctrl+K
줄 끝까지 삭제
快捷键功能
Ctrl+A
移至行首
Ctrl+E
移至行尾
Ctrl+W
删除前一个单词
Ctrl+U
删除至行首
Ctrl+K
删除至行尾

3. 세션 관리

3. 会话管理

Claude Code 세션

Claude Code会话

bash
undefined
bash
undefined

마지막 대화 이어서 시작

继续上一次对话

claude --continue
claude --continue

특정 세션 재개

恢复指定会话

claude --resume <session-name>
claude --resume <session-name>

대화 중 이름 지정

对话中命名

/rename stripe-integration
undefined
/rename stripe-integration
undefined

권장 별칭 설정

推荐别名设置

bash
undefined
bash
undefined

~/.zshrc 또는 ~/.bashrc

~/.zshrc 或 ~/.bashrc

alias c='claude' alias cc='claude --continue' alias cr='claude --resume' alias g='gemini' alias cx='codex'

---
alias c='claude' alias cc='claude --continue' alias cr='claude --resume' alias g='gemini' alias cx='codex'

---

4. Git 워크플로우

4. Git工作流

자동 커밋 메시지 생성

自动生成提交信息

"변경 사항을 분석하고 적절한 커밋 메시지를 작성한 후 커밋해줘"
"请分析变更内容并撰写合适的提交信息后完成提交"

Draft PR 자동 생성

自动生成Draft PR

"현재 브랜치의 변경 사항으로 draft PR을 만들어줘.
제목은 변경 내용을 요약하고, 본문에는 주요 변경 사항을 리스트로 작성해줘."
"请基于当前分支的变更内容创建draft PR。标题需概括变更内容，正文中请以列表形式列出主要变更点。"

Git Worktrees 활용

Git Worktrees运用

bash
undefined
bash
undefined

여러 브랜치 동시 작업

同时处理多个分支

git worktree add ../myapp-feature-auth feature/auth git worktree add ../myapp-hotfix hotfix/critical-bug
git worktree add ../myapp-feature-auth feature/auth git worktree add ../myapp-hotfix hotfix/critical-bug

각 worktree에서 독립적 AI 세션

每个worktree中独立运行AI会话

탭 1: ~/myapp-feature-auth → 새 기능 개발 탭 2: ~/myapp-hotfix → 긴급 버그 수정 탭 3: ~/myapp (main) → 메인 브랜치 유지
undefined
标签页1: ~/myapp-feature-auth → 新功能开发 标签页2: ~/myapp-hotfix → 紧急Bug修复 标签页3: ~/myapp (main) → 维护主分支
undefined

PR 리뷰 워크플로우

PR审查工作流

1. "gh pr checkout 123을 실행하고 이 PR의 변경 사항을 요약해줘"
2. "src/auth/middleware.ts 파일의 변경점을 분석해줘. 보안 이슈나 성능 문제가 있는지 확인해줘"
3. "이 로직을 더 효율적으로 바꿀 방법이 있을까?"
4. "네가 제안한 개선 사항을 적용하고 테스트를 실행해줘"
1. "请执行gh pr checkout 123并总结该PR的变更内容"
2. "请分析src/auth/middleware.ts文件的变更点，检查是否存在安全问题或性能隐患"
3. "有没有更高效的方法来优化这段逻辑？"
4. "请应用你提出的改进方案并执行测试"

5. MCP 서버 활용 (Multi-Agent)

5. MCP服务器运用（Multi-Agent）

주요 MCP 서버

核心MCP服务器

MCP 서버기능용도
Playwright웹 브라우저 제어E2E 테스트
Supabase데이터베이스 쿼리DB 직접 접근
Firecrawl웹 크롤링데이터 수집
Gemini-CLI대용량 분석1M+ 토큰 분석
Codex-CLI명령 실행빌드, 배포
MCP服务器功能用途
Playwright控制网页浏览器E2E测试
Supabase数据库查询直接访问数据库
Firecrawl网页爬取数据收集
Gemini-CLI大容量分析1M+令牌分析
Codex-CLI执行命令构建、部署

MCP 활용 예시

MCP运用示例

bash
undefined
bash
undefined

Gemini: 대용량 분석

Gemini: 大容量分析

ask-gemini "@src/ 전체 코드베이스 구조 분석해줘"
ask-gemini "@src/ 分析整个代码库结构"

Codex: 명령 실행

Codex: 执行命令

shell "docker-compose up -d" shell "npm test && npm run build"
undefined
shell "docker-compose up -d" shell "npm test && npm run build"
undefined

MCP 최적화

MCP优化

bash
undefined
bash
undefined

사용하지 않는 MCP 비활성화

禁用未使用的MCP

/mcp
/mcp

권장 수치

推荐数值

- MCP 서버: 10개 미만

- MCP服务器：少于10个

- 활성 도구: 80개 미만

- 激活工具：少于80个


---

---

6. Multi-Agent 워크플로우 패턴

6. Multi-Agent工作流模式

오케스트레이션 패턴

编排模式

[Claude] 계획 수립 → [Gemini] 분석/리서치 → [Claude] 코드 작성 → [Codex] 실행/테스트 → [Claude] 결과 종합
[Claude] 制定计划 → [Gemini] 分析/调研 → [Claude] 编写代码 → [Codex] 执行/测试 → [Claude] 汇总结果

실전 예시: API 설계 + 구현 + 테스트

实战示例：API设计 + 实现 + 测试

1. [Claude] 스킬 기반 API 스펙 설계
2. [Gemini] ask-gemini "@src/ 기존 API 패턴 분석" - 대용량 코드베이스 분석
3. [Claude] 분석 결과 기반 코드 구현
4. [Codex] shell "npm test && npm run build" - 테스트 및 빌드
5. [Claude] 최종 리포트 생성
1. [Claude] 基于Skill设计API规范
2. [Gemini] ask-gemini "@src/ 分析现有API模式" - 大容量代码库分析
3. [Claude] 基于分析结果实现代码
4. [Codex] shell "npm test && npm run build" - 测试及构建
5. [Claude] 生成最终报告

TDD 워크플로우

TDD工作流

"TDD 방식으로 작업해줘. 먼저 실패하는 테스트를 작성하고,
그 테스트를 통과시키는 코드를 작성해줘."
"请采用TDD方式工作。先编写失败的测试用例，再编写能通过该测试的代码。"

AI가:

AI将执行：

1. 실패하는 테스트 작성

1. 编写失败的测试用例

2. git commit -m "Add failing test for user auth"

2. git commit -m "Add failing test for user auth"

3. 테스트를 통과시키는 최소한의 코드 작성

3. 编写满足测试要求的最简代码

4. 테스트 실행 → 통과 확인

4. 执行测试 → 确认通过

5. git commit -m "Implement user auth to pass test"

5. git commit -m "Implement user auth to pass test"


---

---

7. 컨테이너 워크플로우

7. 容器工作流

Docker 컨테이너 설정

Docker容器配置

dockerfile
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
    curl git tmux vim nodejs npm python3 python3-pip
RUN curl -fsSL https://claude.ai/install.sh | sh
WORKDIR /workspace
CMD ["/bin/bash"]
dockerfile
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
    curl git tmux vim nodejs npm python3 python3-pip
RUN curl -fsSL https://claude.ai/install.sh | sh
WORKDIR /workspace
CMD ["/bin/bash"]

안전한 실험 환경

安全实验环境

bash
undefined
bash
undefined

컨테이너 빌드 및 실행

构建并运行容器

docker build -t ai-sandbox . docker run -it --rm
-v $(pwd):/workspace
-e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY
ai-sandbox
docker build -t ai-sandbox . docker run -it --rm
-v $(pwd):/workspace
-e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY
ai-sandbox

컨테이너 안에서 실험적 작업 수행

在容器内执行实验性操作


---

---

8. 문제 해결

8. 问题排查

컨텍스트 과다 시

上下文过载时

bash
/context  # 사용량 확인
/clear    # 컨텍스트 초기화
bash
/context  # 查看使用情况
/clear    # 清空上下文

또는 HANDOFF.md 생성 후 새 세션

或生成HANDOFF.md后开启新会话

undefined
undefined

작업 취소

撤销操作

Esc Esc  # 마지막 작업 즉시 취소
Esc Esc  # 立即撤销最后操作

성능 저하 시

性能下降时

bash
undefined
bash
undefined

MCP/도구 수 확인

查看MCP/工具数量

/mcp
/mcp

불필요한 MCP 비활성화

禁用不必要的MCP

컨텍스트 초기화

清空上下文


---

---

Quick Reference Card

速查卡片

=== 필수 명령어 ===
/clear      컨텍스트 초기화
/context    사용량 확인
/usage      토큰 확인
/init       프로젝트 설명 파일 생성
!command    즉시 실행

=== 단축키 ===
Esc Esc     작업 취소
Ctrl+R      히스토리 검색
Shift+Tab×2 계획 모드
Ctrl+B      백그라운드

=== CLI 플래그 ===
--continue  대화 이어가기
--resume    세션 복구
-p "prompt" Headless 모드

=== Multi-Agent ===
Claude      계획/코드 생성
Gemini      대용량 분석
Codex       명령 실행

=== 문제 해결 ===
컨텍스트 과다 → /clear
작업 취소 → Esc Esc
성능 저하 → /context 확인
=== 必备命令 ===
/clear      清空上下文
/context    查看使用情况
/usage      查看令牌
/init       生成项目说明文件
!command    立即执行

=== 快捷键 ===
Esc Esc     撤销操作
Ctrl+R      搜索历史记录
Shift+Tab×2 切换计划模式
Ctrl+B      转入后台

=== CLI参数 ===
--continue  继续对话
--resume    恢复会话
-p "prompt" 无头模式

=== Multi-Agent分工 ===
Claude      计划/代码生成
Gemini      大容量分析
Codex       命令执行

=== 问题排查 ===
上下文过载 → /clear
撤销操作 → Esc Esc
性能下降 → 用/context查看