본문으로 건너뛰기
cccskills
무료GitHub에 공개

smoke-test

Check a DeerFlow installation from code updates through deployment and basic service checks. Supports local and Docker setups, verifies frontend pages and API health, and produces a report with results and troubleshooting recommendations.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

End-to-end smoke test skill for DeerFlow. Guides through: 1) Pulling latest code, 2) Docker OR Local installation and deployment (user preference, default to Local if Docker network issues), 3) Service availability verification, 4) Health check, 5) Final test report. Use when the user says "run smoke test", "smoke test deployment", "verify installation", "test service availability", "end-to-end test", or similar.

연동 도구Docker
설치 방법 보기

이럴 때 유용합니다

  • Checking DeerFlow after installation
  • Verifying startup after a code update
  • Checking a Docker deployment
  • Documenting frontend and API test results

포함된 파일(12)

  • SKILL.md9.9 KB
  • references/SOP.md11.3 KB
  • references/troubleshooting.md10.4 KB
  • scripts/check_docker.sh2.0 KB
  • scripts/check_local_env.sh2.4 KB
  • scripts/deploy_docker.sh1.7 KB
  • scripts/deploy_local.sh1.5 KB
  • scripts/frontend_check.sh6.2 KB
  • scripts/health_check.sh3.0 KB
  • scripts/pull_code.sh1.2 KB
  • templates/report.docker.template.md4.4 KB
  • templates/report.local.template.md4.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

DeerFlow Smoke Test Skill

This skill guides the Agent through DeerFlow's full end-to-end smoke test workflow, including code updates, deployment (supporting both Docker and local installation modes), service availability verification, and health checks.

Deployment Mode Selection

This skill supports two deployment modes:

  • Local installation mode (recommended, especially when network issues occur) - Run all services directly on the local machine
  • Docker mode - Run all services inside Docker containers

Selection strategy:

  • If the user explicitly asks for Docker mode, use Docker
  • If network issues occur (such as slow image pulls), automatically switch to local mode
  • Default to local mode whenever possible

Structure

smoke-test/
├── SKILL.md                          ← You are here - core workflow and logic
├── scripts/
│   ├── check_docker.sh               ← Check the Docker environment
│   ├── check_local_env.sh            ← Check local environment dependencies
│   ├── frontend_check.sh             ← Frontend page smoke check
│   ├── pull_code.sh                  ← Pull the latest code
│   ├── deploy_docker.sh              ← Docker deployment
│   ├── deploy_local.sh               ← Local deployment
│   └── health_check.sh               ← Service health check
├── references/
│   ├── SOP.md                        ← Standard operating procedure
│   └── troubleshooting.md            ← Troubleshooting guide
└── templates/
    ├── report.local.template.md      ← Local mode smoke test report template
    └── report.docker.template.md     ← Docker mode smoke test report template

Standard Operating Procedure (SOP)

Phase 1: Code Update Check

  1. Confirm current directory - Verify that the current working directory is the DeerFlow project root
  2. Check Git status - See whether there are uncommitted changes
  3. Pull the latest code - Use git pull origin main to get the latest updates
  4. Confirm code update - Verify that the latest code was pulled successfully

Phase 2: Deployment Mode Selection and Environment Check

Choose deployment mode:

  • Ask for user preference, or choose automatically based on network conditions
  • Default to local installation mode

Local mode environment check:

  1. Check Node.js version - Requires 22+
  2. Check pnpm - Package manager
  3. Check uv - Python package manager
  4. Check nginx - Reverse proxy
  5. Check required ports - Confirm that ports 2026, 3000, and 8001 are not occupied

Docker mode environment check (if Docker is selected):

  1. Check whether Docker is installed - Run docker --version
  2. Check Docker daemon status - Run docker info
  3. Check Docker Compose availability - Run docker compose version
  4. Check required ports - Confirm that port 2026 is not occupied

Phase 3: Configuration Preparation

  1. Check whether config.yaml exists
    • If it does not exist, run make config to generate it
    • If it already exists, check whether it needs an upgrade with make config-upgrade
  2. Check the .env file
    • Verify that required environment variables are configured
    • Especially model API keys such as OPENAI_API_KEY

Phase 4: Deployment Execution

Local mode deployment:

  1. Check dependencies - Run make check
  2. Install dependencies - Run make install
  3. (Optional) Pre-pull the sandbox image - If needed, run make setup-sandbox
  4. Start services - Run make start (production mode)
  5. Wait for startup - Give all services enough time to start completely (90-120 seconds recommended)

Docker mode deployment (if Docker is selected):

  1. Initialize Docker environment - Run make docker-init
  2. Start Docker services - Run make up (production mode)
  3. Wait for startup - Give all containers enough time to start completely (60 seconds recommended)

Phase 5: Service Health Check

Local mode health check:

  1. Check process status - Confirm that Gateway, Frontend, and Nginx processes are all running
  2. Check frontend service - Visit http://localhost:2026 and verify that the page loads
  3. Check API Gateway - Verify the http://localhost:2026/health endpoint
  4. Check LangGraph-compatible API - Verify the /api/langgraph/* route exposed by Gateway
  5. Frontend route smoke check - Run bash .agent/skills/smoke-test/scripts/frontend_check.sh to verify key routes under /workspace. The script auto-detects whether authentication is enabled and, if so, registers / logs in a smoke-test user so the real pages are verified rather than the login redirect.

Docker mode health check (when using Docker):

  1. Check container status - Run docker ps and confirm that all containers are running
  2. Check frontend service - Visit http://localhost:2026 and verify that the page loads
  3. Check API Gateway - Verify the http://localhost:2026/health endpoint
  4. Check LangGraph-compatible API - Verify the /api/langgraph/* route exposed by Gateway
  5. Frontend route smoke check - Run bash .agent/skills/smoke-test/scripts/frontend_check.sh to verify key routes under /workspace. The script auto-detects whether authentication is enabled and, if so, registers / logs in a smoke-test user so the real pages are verified rather than the login redirect.

Optional Functional Verification

  1. List available models - Verify that model configuration loads correctly
  2. List available skills - Verify that the skill directory is mounted correctly
  3. Simple chat test - Send a simple message to verify the end-to-end flow

Phase 6: Generate Test Report

  1. Collect all test results - Summarize execution status for each phase
  2. Record encountered issues - If anything fails, record the error details
  3. Generate the final report - Use the template that matches the selected deployment mode to create the complete test report, including overall conclusion, detailed key test cases, and explicit frontend page / route results
  4. Provide follow-up recommendations - Offer suggestions based on the test results

Execution Rules

  • Follow the sequence - Execute strictly in the order described above
  • Idempotency - Every step should be safe to repeat
  • Error handling - If a step fails, stop and report the issue, then provide troubleshooting suggestions
  • Detailed logging - Record the execution result and status of each step
  • User confirmation - Ask for confirmation before potentially risky operations such as overwriting config
  • Mode preference - Prefer local mode to avoid network-related issues
  • Template requirement - The final report must use the matching template under templates/; do not output a free-form summary instead of the template-based report
  • Report clarity - The execution summary must include the overall pass/fail conclusion plus per-case result explanations, and frontend smoke check results must be listed explicitly in the report
  • Optional phase handling - If functional verification is not executed, do not present it as a separate skipped phase in the final report

Known Acceptable Warnings

The following warnings can appear during smoke testing and do not block a successful result:

  • Feishu/Lark SSL errors in Gateway logs (certificate verification failure) can be ignored if that channel is not enabled
  • Warnings in Gateway logs about missing methods in the custom checkpointer, such as adelete_for_runs or aprune, do not affect the core functionality
  • The frontend_check.sh script automatically handles authentication. When auth is enabled it registers / logs in a smoke-test user (smoke-test@deerflow.dev by default) to verify the real /workspace/* pages. The registration may produce a log entry from the auth provider, which is expected and harmless.

Key Tools

Use the following tools during execution:

  1. bash - Run shell commands
  2. present_file - Show generated reports and important files
  3. task_tool - Organize complex steps with subtasks when needed

Success Criteria

Smoke test pass criteria (local mode):

  • Latest code is pulled successfully
  • Local environment check passes (Node.js 22+, pnpm, uv, nginx)
  • Configuration files are set up correctly
  • make check passes
  • make install completes successfully
  • make dev starts successfully
  • All service processes run normally
  • Frontend page is accessible
  • Frontend route smoke check passes (/workspace key routes)
  • API Gateway health check passes
  • Test report is generated completely

Smoke test pass criteria (Docker mode):

  • Latest code is pulled successfully
  • Docker environment check passes
  • Configuration files are set up correctly
  • make docker-init completes successfully
  • make up completes successfully
  • All Docker containers run normally
  • Frontend page is accessible
  • Frontend route smoke check passes (/workspace key routes)
  • API Gateway health check passes
  • Test report is generated completely

Read Reference Files

Before starting execution, read the following reference files:

  1. references/SOP.md - Detailed step-by-step operating instructions
  2. references/troubleshooting.md - Common issues and solutions
  3. templates/report.local.template.md - Local mode test report template
  4. templates/report.docker.template.md - Docker mode test report template

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Turn academic papers into structured reviews that explain findings, strengths, weaknesses, and research methods. Assess originality and supporting evidence, compare relevant literature, and provide specific improvement suggestions in a detailed review or brief summary.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Understanding a paper's findings and limitations
  • Preparing a draft peer review
  • Checking experimental design and reproducibility
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

Find Python input/output calls that may stall asynchronous backend work, then fix or guard each relevant path with runtime tests. Verify that tests fail when blocking behavior returns and pass after the fix is restored.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking asynchronous Python changes before a pull request
  • Triaging blocking input/output across the codebase
  • Adding tests for cleanup and error branches
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

bootstrap

무료

Create or update a SOUL.md file that defines an AI partner’s behavior through a guided conversation. Clarify communication style, autonomy, honesty, and expectations, then review a concise English profile before saving it with setup_agent.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Define an AI partner’s initial personality and role
  • Adjust tone and how the AI expresses disagreement
  • Clarify which decisions the AI can make independently
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

Turn data into chart images by selecting a suitable format from 26 options. Visualize trends, comparisons, distributions, flows, or relationships, then receive the image URL and the complete settings used to generate it.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Visualize changes over time
  • Compare categories and proportions
  • Show distributions and correlations
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

Send research and analysis tasks to a running DeerFlow instance through its HTTP API, an interface for exchanging requests. Retrieve responses, continue conversations, upload documents, and inspect available models, skills, agents, and service health.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Delegate research and analysis to DeerFlow
  • Upload documents for a conversation
  • Resume an earlier conversation
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

Turn source code into project documentation, from a README with installation steps and examples to API references, architecture diagrams, developer guides, and changelogs. Match the scope and comment format to the project's size and programming language.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Creating a README with installation steps and usage examples
  • Documenting public functions, parameters, and return values
  • Preparing architecture and contributor guides for new developers
bytedance/deer-flow8.4만2026년 10월 19일 업데이트

bytedance의 스킬 모두 보기

이 스킬의 문제 신고