AgentSkillsCN

agent-studio

开发、运行并调试 AGENT-Studio 仓库（Next.js 前端 + FastAPI 后端）。适用于仓库的入门引导、服务的启动与停止（restart.sh、3115/8000 端口）、环境变量、日志记录，以及常见的开发工作流。本仓库的开发与故障排查：前后端启动与关闭、端口与日志、环境变量、代码检查与构建、关键目录定位。

SKILL.md
--- frontmatter
name: agent-studio
description: Develop, run, and debug the AGENT-Studio repo (Next.js frontend + FastAPI backend). Use for repo onboarding, starting/stopping services (restart.sh, ports 3115/8000), env vars, logs, and common dev workflows. 本仓库开发/排障：启动前后端、端口/日志、环境变量、lint/build、定位关键目录。

Agent Studio (Repo)

Navigate the repo

  • •Run ./restart.sh to start the full stack (kills ports 8000/3115, starts FastAPI, then Next dev on 3115).
  • •Find frontend entry points in src/app/ and shared UI in src/components/.
  • •Find chat API in src/app/api/chat/route.ts.
  • •Find backend API in backend/main.py and game engine code in backend/engine/.
  • •Read architectural notes before large refactors:
    • •docs/dev_docs/2025-12-31-chat-architecture-refactor.md
    • •docs/dev_docs/2025-12-31-game-playground-roadmap.md
    • •docs/refactoring_docs/2026-01-01-playground-page-refactor.md

Run common workflows

  • •Start frontend only: npm install then npm run dev -- -p 3115.
  • •Start backend only: cd backend && (source .venv/bin/activate || true) && python main.py.
  • •Lint/build: npm run lint, npm run build.

Check configuration quickly

  • •Set OPENROUTER_API_KEY in .env.local for chat (src/app/api/chat/route.ts).
  • •Verify backend health at http://localhost:8000/health.
  • •Tail backend logs at backend/backend.log when using ./restart.sh.