{"skill":{"slug":"trace-debuger","displayName":"Trace Debuger","summary":"End-to-end trace debugging from trace_id. Fetch Jaeger trace and Elasticsearch logs, analyze possible bugs (optionally with local repository context), and ge...","description":"---\nname: trace-debuger\ndescription: End-to-end trace debugging from trace_id. Fetch Jaeger trace and Elasticsearch logs, analyze possible bugs (optionally with local repository context), and generate a fixed-structure Markdown report for CI or tickets.\n---\n\n# Trace Debuger\n\nUse this skill to generate a self-contained Markdown trace debug report.\n\n## Inputs\n\n- `trace_id` (required)\n- `jaeger_url` (optional, default `http://127.0.0.1:16686`)\n- `es_url` (optional, default `http://127.0.0.1:9200`)\n- `repo_path` (optional, absolute path, default `/Users/noodles/Desktop/code/go-components/examples/tracer`)\n- `output_path` (optional, default `./trace_debug_report_{trace_id}.md`)\n- `es_index` (optional, default `filebeat-tracer-*`)\n- `es_size` (optional, default `2000`)\n\n## Run\n\n```bash\npython3 skills/trace_debuger/scripts/trace_debuger.py \\\n  --trace-id <TRACE_ID> \\\n  [--jaeger-url http://127.0.0.1:16686] \\\n  [--es-url http://127.0.0.1:9200] \\\n  [--repo-path /Users/noodles/Desktop/code/go-components/examples/tracer] \\\n  [--output-path ./trace_debug_report_<TRACE_ID>.md]\n```\n\n## Output\n\n- Writes Markdown report to `output_path`\n- **MUST send the generated Markdown report to the user as a file attachment via the chat window in the same session before finishing the task**\n- **MUST send the report as ONE chat message only: attach the Markdown file and put the strict summary block in the same message caption/body.**\n- **`【markdown报告文件】` is a placeholder and MUST be replaced with the real uploaded Markdown filename (example: `trace_debug_report_<trace_id>.md`).**\n- **Use exactly this format in caption/body:**\n\n```text\n<真实markdown报告文件名>\ntrace_id: xxxx\nstatus: xxx\njaeger_url: xxx\nes_url: xxx\n代码仓库路径：仓库路径\n关键结论摘要：xxxx\n```\n\n- Prints fixed summary lines to stdout:\n\n```text\ntrace_id: <trace_id>\nstatus: SUCCESS/FAIL\njaeger_url: <jaeger_url>\nes_url: <es_url>\n代码仓库路径：<repo_path|N/A>\n关键结论摘要：<summary>\n```\n\n## Notes\n\n- Keep logs sorted by timestamp ascending.\n- After fetching ES logs, run Codex in repository root (automated via `codex exec` equivalent to TUI paste workflow) with this prompt:\n  - `这是我的日志，请根据日志结合代码帮我排查分析bug，输出bug原因及解决方案,必须保持固定的格式。`\n- If repository is provided, include code-context hints and file matches for suspected bug areas.\n- If repository is not provided, base bug hypotheses on logs + spans only.\n- After analysis in chat workflow: send the generated Markdown report **as a file attachment** to the user through the chat window, with the strict summary block in the **same message** caption/body (single message only).\n- The first line must be the real Markdown filename (not placeholder text).\n- Finally, delete the local Markdown file.\n","topics":["Debugging","Repository"],"tags":{"latest":"0.2.1"},"stats":{"comments":0,"downloads":857,"installsAllTime":32,"installsCurrent":0,"stars":1,"versions":3},"createdAt":1772618567119,"updatedAt":1778995160590},"latestVersion":{"version":"0.2.1","createdAt":1772710947603,"changelog":"Enforce single-message delivery: markdown report as file attachment + strict summary format with real filename.","license":null},"metadata":null,"owner":{"handle":"gakkiismywife","userId":"s173h25mbz062j85kh5f6cs13n83gapx","displayName":"gakkiismywife","image":"https://avatars.githubusercontent.com/u/40749544?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089762774}}