ReddRadar
Agent skill
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).
Install this agent skill to your Project
npx add-skill https://github.com/tgoai/tgo/tree/main/.skills/functional-verification
SKILL.md
functional-verification
Purpose
Use tgo-cli (staff) and tgo-widget-cli (visitor) to verify API/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 — when local services are running.
Prerequisites
- Local services must be running (
make dev-allor individualmake dev-*) - tgo-cli configured (
~/.tgo/config.jsonwith server + token, viatgo auth login) - tgo-widget-cli configured (
~/.tgo-widget/config.json, viatgo-widget init)
What it does
- Checks CLI build status and config availability
- Verifies server reachability
- Based on
git diff, maps changed services to verification commands:
| Changed Service | Verification |
|---|---|
| tgo-api | tgo system info, tgo auth whoami, tgo conversation list --limit 1 |
| tgo-ai | tgo chat team --message "ping", tgo agent list --limit 1 |
| tgo-rag | tgo knowledge list --limit 1 |
| tgo-workflow | tgo workflow list --limit 1 |
| tgo-platform | tgo platform list |
| tgo-api + visitor flow | tgo-widget platform info, tgo-widget chat send --message "ping" --no-stream |
- Outputs pass/fail per check
Usage
# Auto-detect from git diff
bash .skills/functional-verification/scripts/verify.sh
# Target specific service
bash .skills/functional-verification/scripts/verify.sh tgo-api
# Full smoke test (all checks)
bash .skills/functional-verification/scripts/verify.sh --all
Manual verification commands
Staff-side (tgo-cli)
TGO_CLI="node repos/tgo-cli/dist/index.js"
# System health
$TGO_CLI system info
$TGO_CLI auth whoami
# Chat e2e (sends to AI, gets response)
$TGO_CLI chat team --message "say ok"
# CRUD verification
$TGO_CLI agent list
$TGO_CLI provider list
$TGO_CLI knowledge list
$TGO_CLI workflow list
$TGO_CLI conversation list --limit 1
$TGO_CLI visitor list --limit 1
$TGO_CLI platform list
$TGO_CLI staff list
Visitor-side (tgo-widget-cli)
WIDGET_CLI="node repos/tgo-widget-cli/dist/index.js"
# Platform & channel
$WIDGET_CLI platform info
$WIDGET_CLI channel info
# Chat e2e (visitor sends, AI responds via SSE)
$WIDGET_CLI chat send --message "say ok" --no-stream
# History
$WIDGET_CLI chat history --limit 3
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
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
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.
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?