ReddRadar
Agent skill
local-services
Start, stop, and check local development services with intelligent minimum-set management. Trigger when services need to be running for functional verification or manual testing — starts the minimum required set (infrastructure + tgo-api + tgo-ai) by default, with optional extras auto-detected from git diff or specified manually. Includes status checking and graceful shutdown.
Install this agent skill to your Project
npx add-skill https://github.com/tgoai/tgo/tree/main/.skills/local-services
SKILL.md
local-services
Purpose
Start, stop, and check local development services. Knows the minimum required set and can auto-detect additional services needed based on code changes.
Trigger
- Before running functional verification (services must be running)
- When starting a development session
- When agent needs to test API changes at runtime
Minimum Services
The core platform requires only 3 things to be functional:
- Infrastructure — PostgreSQL, Redis, WuKongIM (
make infra-up) - tgo-api — Core API gateway (port 8000)
- tgo-ai — LLM / Agent runtime (port 8081)
All other services are optional and can be added based on what you're working on.
Service Map
| Service | Make target | Port | When needed |
|---|---|---|---|
| Infrastructure | make infra-up |
5432/6379/5001 | Always |
| tgo-api | make dev-api |
8000 | Always |
| tgo-ai | make dev-ai |
8081 | Always |
| tgo-rag | make dev-rag |
18082 | Knowledge base / RAG changes |
| tgo-platform | make dev-platform |
8003 | Channel integration changes |
| tgo-workflow | make dev-workflow |
8004 | Workflow engine changes |
| tgo-plugin-runtime | make dev-plugin |
8090 | Plugin / MCP tool changes |
| tgo-device-control | make dev-device |
8085 | Device management changes |
| tgo-web | make dev-web |
5173 | Admin frontend changes |
| tgo-widget-js | make dev-widget |
5174 | Visitor widget changes |
| RAG worker | make dev-rag-worker |
— | Document processing tasks |
| Workflow worker | make dev-wf-worker |
— | Workflow execution tasks |
Usage
# Start minimum services (infra + api + ai)
bash .skills/local-services/scripts/start.sh
# Start minimum + specific extras
bash .skills/local-services/scripts/start.sh rag web
# Start minimum + auto-detect extras from git diff
bash .skills/local-services/scripts/start.sh --auto
# Start everything
bash .skills/local-services/scripts/start.sh --all
# Check what's running
bash .skills/local-services/scripts/status.sh
# Stop all services
bash .skills/local-services/scripts/stop.sh
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
tgoai/tgo
implementation-strategy
Analyze change impact across services before starting implementation. Trigger before modifying runtime, API, or cross-service code — maps changed files to service ownership, outputs the dependency graph between affected services, and lists upstream/downstream sync points that may need coordinated updates.
tgoai/tgo
functional-verification
Use tgo-cli (staff) and tgo-widget-cli (visitor) to verify API and service changes at runtime, beyond static lint/build checks. Trigger after modifying backend API endpoints, service logic, chat flow, agent config, knowledge/RAG, workflow, or platform integration — requires local services to be running. Auto-detects changed services from git diff and runs the corresponding CLI smoke tests (system info, CRUD listing, chat e2e).
tgoai/tgo
db-migration-check
Verify that SQLAlchemy model changes have corresponding Alembic migration files. Trigger when any file under models/*.py or models/**/*.py is modified — checks git diff for model changes and confirms matching alembic/versions/*.py files exist, failing if a service has model changes without a migration.
tgoai/tgo
streaming-protocol-check
Check streaming protocol consistency across all producer and consumer services. Trigger when modifying code related to streaming, SSE, WuKongIM, json-render, or MixedStreamParser — lists all files in tgo-ai (producer), tgo-api (relay), tgo-web, tgo-widget-js, and tgo-widget-miniprogram (consumers) that handle the same protocol and may need coordinated updates.
tgoai/tgo
pr-draft-summary
Generate a PR change summary grouped by service after work is finished. Trigger when wrapping up a task and ready to commit or create a pull request — reads git diff and git log, groups changed files by service directory, and outputs a markdown-formatted summary with file lists, commit history, and diff stats.
tgoai/tgo
cross-service-sync
Detect schema, type, or API interface changes and find files in other services that may need synchronized updates. Trigger when modifying files under schemas/, types/, or interfaces/ directories — extracts changed class/type names from the diff and searches all other services for references, outputting a list of potentially stale consumers.
Didn't find tool you were looking for?