菜单
Use when Pipeline 运行失败或结果异常，需要读取 Job 的 Trace 日志、分析错误原因并给出修复建议。触发词：browse traces、job失败、排查运行失败、trace日志、pipeline报错、job error。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/forge-town/ordine --skill ordine-browse-traces命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Use when 需要了解 Ordine 系统的整体架构和快速上手指南，包括核心概念、实体关系、CLI 和 API 使用方法。触发词：ordine入门、快速开始、ordine是什么、系统架构、ordine overview。
Use when 需要通过 Ordine 浏览项目文件系统，列出目录内容或获取递归目录树。触发词：浏览文件、查看目录、文件系统浏览、目录树、browse filesystem。
Use when 需要在 Ordine 系统中创建新的 Best Practice（最佳实践），包含条件、内容、代码片段和检查清单条目。触发词：创建最佳实践、新建bestpractice、添加编码规范、添加实践规范。
正在显示 SKILL.md
基于 SOC 职业分类
| name | ordine-browse-traces |
| description | Use when Pipeline 运行失败或结果异常，需要读取 Job 的 Trace 日志、分析错误原因并给出修复建议。触发词：browse traces、job失败、排查运行失败、trace日志、pipeline报错、job error。 |
当 Pipeline 运行后 Job 状态变为 failed 或结果不符合预期时，需要通过 Trace 日志定位根因并给出修复方案。
# 查看 Job 详情
curl -s http://localhost:9433/api/jobs/<JOB_ID> | python3 -m json.tool
关注字段：
| 字段 | 说明 |
|---|---|
status | failed = 运行失败，completed = 已完成（可能有部分错误） |
error | 顶层错误信息（如果有） |
result | 运行结果摘要 |
startedAt / completedAt | 计算运行耗时，判断是否超时 |
# 获取该 Job 的所有 Trace
curl -s http://localhost:9433/api/jobs/<JOB_ID>/traces | python3 -m json.tool
Trace 数据结构：
| 字段 | 类型 | 说明 |
|---|---|---|
id | number | 自增 ID |
jobId | string | 所属 Job ID |
level | "info" | "warn" | "error" | "debug" | 日志级别 |
message | string | 日志内容 |
createdAt | timestamp | 时间戳 |
优先查看 error 级别的 Trace：
# 只看错误日志
curl -s http://localhost:9433/api/jobs/<JOB_ID>/traces | \
python3 -c "import sys,json; [print(t['message']) for t in json.load(sys.stdin) if t['level']=='error']"
再查看 warn 级别了解潜在问题：
# 只看警告日志
curl -s http://localhost:9433/api/jobs/<JOB_ID>/traces | \
python3 -c "import sys,json; [print(t['message']) for t in json.load(sys.stdin) if t['level']=='warn']"
| 模式 | Trace 特征 | 修复方向 |
|---|---|---|
| Operation 执行失败 | error 消息包含 Operation ID | 检查该 Operation 的 executor 配置（script/skill/prompt） |
| 输入路径不存在 | error 消息包含 ENOENT 或 not found | 检查运行时传入的 -i 路径是否正确 |
| Skill 调用超时 | 长时间无新 Trace，最终 failed | 检查 Skill 服务是否在线，网络是否通畅 |
| 脚本权限不足 | error 消息包含 EACCES 或 permission denied | 检查脚本文件的执行权限 |
| 节点连接断裂 | warn 消息提示某节点未收到输入 | 检查 Pipeline DAG 中节点之间的连线 |
修复问题后重新运行 Pipeline：
# 通过 CLI
ordine run <PIPELINE_ID> -i <INPUT_PATH>
# 通过 API
curl -X POST http://localhost:9433/api/pipelines/<PIPELINE_ID>/run \
-H "Content-Type: application/json" \
-d '{ "inputPath": "<INPUT_PATH>" }'
验证新 Job 状态为 completed 且无 error 级别 Trace。