菜单
Use when Pipeline 运行失败或结果异常，需要读取 Job 的 Trace 日志、分析错误原因并给出修复建议。触发词：browse traces、job失败、排查运行失败、trace日志、pipeline报错、job error。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when 需要了解 Ordine 系统的整体架构和快速上手指南，包括核心概念、实体关系、CLI 和 API 使用方法。触发词：ordine入门、快速开始、ordine是什么、系统架构、ordine overview。
Use when 需要通过 Ordine 浏览项目文件系统，列出目录内容或获取递归目录树。触发词：浏览文件、查看目录、文件系统浏览、目录树、browse filesystem。
Use when 需要在 Ordine 系统中创建新的 Best Practice（最佳实践），包含条件、内容、代码片段和检查清单条目。触发词：创建最佳实践、新建bestpractice、添加编码规范、添加实践规范。
Use when 需要在 Ordine 系统中创建新的 Operation（原子操作），定义执行器（skill/script）、输入输出和接受的对象类型。触发词：创建操作、新建operation、添加检查操作、添加修复操作。
Use when 需要在 Ordine 系统中创建新的 Pipeline（质量检查流水线），包括定义节点（folder/operation/output）和边（连接关系），通过 REST API 或 UI 完成。触发词：创建流水线、新建pipeline、设计工作流、构建检查流程。
Use when 需要在 Ordine 系统中创建 GitHub 项目，将代码仓库关联到 Ordine 以便运行质量检查 Pipeline。触发词：创建项目、关联仓库、create project、新建项目、github项目。
| 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。