- Implemented a new skill to inspect and follow SHZ backend logs with bounded read-only commands. - Added scripts for viewing local and production logs, including options for following logs. - Created references for log locations and usage guidelines. feat: add query-shz-highgo skill for database querying - Introduced a skill to query the SHZ HighGo database through an SSH gateway using a read-only psql workflow. - Included scripts for executing SQL queries and schema discovery. - Added connection details and usage instructions. feat: add OutdoorFairBooth domain and mapper - Created OutdoorFairBooth domain model with relevant fields and annotations. - Implemented a mapper interface for physical deletion of records based on fair ID. feat: create SQL scripts for cms_outdoor_fair_booth - Added SQL script to create the cms_outdoor_fair_booth table and its associated sequence. - Included comments for clarity and compatibility with historical data. - Added a script to drop the cms_venue_booth table after migration confirmation.
2.1 KiB
name, description
| name | description |
|---|---|
| inspect-shz-logs | Inspect and follow the SHZ backend's local and production logs through bounded, read-only commands. Use when Codex is working in the shz-backend project and needs to diagnose startup failures, exceptions, request behavior, scheduled jobs, or runtime incidents from local backend.log or the production backend, error, info, and user logs on the shz server. |
Inspect SHZ Logs
Use the bundled script instead of assembling SSH commands manually. Keep every initial read bounded; follow logs only when the user explicitly asks to monitor live activity.
Inspect local logs
Read the last 200 lines:
.codex/skills/inspect-shz-logs/scripts/view.sh local 200
Follow the local log interactively:
.codex/skills/inspect-shz-logs/scripts/view.sh local 200 --follow
Inspect production logs
Read the main application log:
.codex/skills/inspect-shz-logs/scripts/view.sh online backend 200
Read the current error log:
.codex/skills/inspect-shz-logs/scripts/view.sh online error 200
Choose only one production log type: backend, error, info, or user. Add --follow as the final argument only for an explicit live-monitoring request.
For keyword analysis, fetch a bounded window and filter locally, for example:
.codex/skills/inspect-shz-logs/scripts/view.sh online error 1000 | rg -i 'exception|error|failed'
Diagnose from logs
- Establish whether the request concerns local or production behavior.
- Read 100–300 recent lines from the relevant log.
- Expand up to the script's 5,000-line cap only when timestamps or stack traces require more context.
- Correlate timestamps, thread names, exception causes, and nearby requests.
- Report the evidence and likely cause without exposing tokens, passwords, personal data, or unrelated log content.
Treat production access as read-only. Never restart services, edit files, deploy code, truncate logs, or run arbitrary remote commands through this skill.
Read references/log-locations.md only when checking server identity, paths, or supported log types.