agentskills.codes
PR

project-workflow

by sumanin5ProductivitySource

Provides startup commands and environment consistency for local and Docker development workflows.

DevopsContainersCI/CDNode.jsPythonFastAPI

Install

mkdir -p .claude/skills/project-workflow && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13858" && unzip -o skill.zip -d .claude/skills/project-workflow && rm skill.zip

Installs to .claude/skills/project-workflow

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

项目启动、环境搭建与日常开发工作流。涵盖 local 与 docker 两种模式下的启动指令。
47 charsno explicit “when” trigger
Beginner

Key capabilities

  • →Set up Python/FastAPI backend environment
  • →Set up Next.js frontend environment
  • →Orchestrate development environment with Docker Compose
  • →Synchronize API SDKs after backend schema changes
  • →Initialize database and inject admin data

How it works

The skill guides through setting up local or Docker-based development environments for Python/FastAPI and Next.js projects, including dependency installation, database initialization, and API SDK generation.

Inputs & outputs

You give it
Project repository clone
You get back
Running local or containerized development environment

When to use project-workflow

  • →Set up project environment from scratch
  • →Sync API SDKs after schema changes
  • →Initialize local database and admin data
  • →Switch between local and containerized development

About this skill

项目工作流与启动规范

🏗️ 基础底座

本项目遵循以下通用开发标准：

🚀 项目特定启动流程

在遵循通用规范的基础上，本项目有以下特有逻辑：

1. 本地开发模式 (推荐，响应最快)

后端 (FastAPI)

  • 目录: /backend
  • 前提: 已安装 uv
  • 启动: uv run fastapi dev app/main.py
  • 端口: 8000
  • 文档: http://localhost:8000/docs

前端 (Next.js)

  • 目录: /frontend
  • 前提: 已安装 pnpm
  • 启动: pnpm dev
  • 端口: 3000
  • 注意: 本地模式下，前端通过 next.config.ts 中的 rewrites 代理到 127.0.0.1:8000。

2. 容器开发模式 (环境一致性)

  • 命令: docker compose -f docker-compose.dev.yml up
  • 特点:
    • 支持热更新 (Hot Reload)。
    • 自动处理数据库、Redis 等基础设施。
    • 前端通过 Docker 网络连接后端 (http://backend:8000)。

🛠️ 初始化流程 (新环境)

如果是第一次克隆项目，请按此顺序执行：

  1. 环境准备:

    • 复制 .env.example -> .env (根据需要修改)。
    • 确保安装了 uv, pnpm, docker。

  2. 后端初始化:

    cd backend
uv sync               # 安装依赖
make db-migrate       # 初始化数据库表结构
uv run app/initial_data.py  # 注入初始管理员数据

  3. 前端初始化:

    cd frontend
pnpm install          # 安装依赖
pnpm api:generate     # 生成 API SDK（强烈建议）

  4. 内容同步:

    ./scripts/sync-posts.sh  # 将 content/ 下的示例内容同步到数据库

🔄 日常开发循环

  1. 修改代码:
    • 后端逻辑修改。
    • 前端 UI 修改。
  2. 同步 API (如果后端 Schema 变了):
    • 执行 ./scripts/generate-api.sh。
  3. 验证:
    • 运行测试: cd backend && make test。
    • 检查 lint: make lint (backend) / pnpm lint (frontend)。

⚠️ 常见问题启动检查项

  • 数据库连接失败: 检查 .env 中的 DATABASE_URL 是否正确（本地通常是 localhost，Docker 内通常是 db）。
  • 前端 SSR 报错: 检查 BACKEND_INTERNAL_URL 环境变量是否配置正确。
  • 端口占用: 确保 3000 和 8000 端口未被其他服务占用。

When not to use it

  • →When the project does not use Python/FastAPI or Next.js
  • →When the project does not use Docker for development

Prerequisites

uvpnpmdocker

Limitations

  • →The workflow is specific to Python/FastAPI and Next.js projects.
  • →The skill assumes the use of uv, pnpm, and Docker.
  • →The skill focuses on development environment setup, not deployment.

How it compares

This skill provides a tailored workflow for a specific Python/FastAPI and Next.js project setup, including Docker orchestration and API SDK synchronization, unlike generic environment setup instructions.

Compared to similar skills

project-workflow side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
project-workflow (this skill)06moReviewBeginner
pipeline-plugin-development13moNo flagsAdvanced
agent-sandbox16moNo flagsIntermediate
lead-devops01moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

pipeline-plugin-development

TencentBlueKing

流水线插件开发完整指南，涵盖插件创建、task.json 配置规范、多语言开发示例（Python/Java/NodeJS/Golang）、输入输出规范、错误码规范、发布流程、调试方法。当用户需要开发蓝盾流水线插件、配置 task.json、处理插件输入输出或排查插件错误时使用。

112

agent-sandbox

ruvnet

Agent skill for sandbox - invoke with $agent-sandbox

11

lead-devops

AbhiGTM19

Assists the user with infrastructure, Docker containerization, and deployment pipelines for the MedVision API.

00

production-dockerfile

phenobarbital

Generate production-ready Dockerfiles with multi-stage builds, security best practices, and optimization. Use when containerizing Python applications for production deployment.

00

devops-python-engineer

lek-x

DevOps and Python service delivery for repositories that need build or runtime debugging, CI/CD changes, containerization, deployment automation, infrastructure updates, observability improvements, or backend Python code changes. Use when Codex must act like a DevOps engineer who can also implement

00

DevOps Engineer Skills

lanmata

Consolidated skill set for the DevOps Engineer agent — Maven build, Docker, GitHub Actions, CI/CD orchestration, and release management

00

Search skills

Search the agent skills registry