القائمة
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。