OSOP 会话记录器

你刚刚完成了一项任务。现在生成一份结构化的会话日志。

需要创建的内容

1. 1. sessions/YYYY-MM-DD-<简短描述>.osop — 工作流定义
2. sessions/YYYY-MM-DD-<简短描述>.osoplog.yaml — 执行记录

如果 sessions/ 目录不存在，请创建它。

任务描述

$ARGUMENTS

.osop 格式

yaml
osop_version: 1.0
id: session-<简短描述>
name: <你完成的工作>
description: <1-2句话摘要>
version: 1.0.0
tags: [claude-code, <相关标签>]

nodes:
- id: <步骤ID>
type: <节点类型> # human, agent, mcp, cli, api, cicd, git, db, docker, infra, system, event, gateway, data, company, department
subtype: <子类型> # 可选: llm, explore, plan, worker, tool, test, commit, rest, 等
name: <步骤名称>
description: <该步骤的功能>
security:
risk_level:

edges:
- from: <步骤A>
to: <步骤B>
mode: sequential # sequential, parallel, conditional, fallback, error, spawn, 等

.osoplog.yaml 格式

yaml
osoplog_version: 1.0
run_id: <生成UUID>
workflow_id: <匹配.osop中的id>
mode: live
status: COMPLETED

trigger:
type: manual
actor: user
timestamp:

started_at:
ended_at:
duration_ms: <总毫秒数>

runtime:
agent: claude-code
model: <当前模型>

node_records:
- node_id: <步骤ID>
node_type: <类型>
attempt: 1
status: COMPLETED
started_at:
ended_at:
duration_ms: <毫秒数>
outputs:
<你产出的内容>
tools_used:
- { tool: <工具名称>, calls: <调用次数> }
reasoning:
question: <决策内容>
selected: <选择的方法>
confidence: <0.0-1.0>

result_summary: <1-2句话摘要>

节点类型映射

操作	type	subtype
读取/浏览文件	mcp	tool
编辑/写入文件

mcp | tool | | Shell命令 | cli | script | | 运行测试 | cicd | test | | Git操作 | git | commit / branch / pr | | 分析/推理 | agent | llm | | 搜索代码库 | mcp | tool | | 询问用户 | human | input | | 用户审查 | human | review | | 生成子代理 | agent | explore / plan / worker | | API调用 | api | rest |

子代理追踪

如果你生成了子代理，请在子节点上使用 parent 字段，并使用 spawn 边：

yaml
nodes:
- id: coordinator
type: agent
subtype: coordinator
- id: explore_1
type: agent
subtype: explore
parent: coordinator
edges:
- from: coordinator
to: explore_1
mode: spawn

重要提示

• - 准确记录使用了哪些工具以及调用次数
• 对非显而易见的决策包含推理过程
• 根据工具调用时间估算持续时间
• 如果任务失败，将状态设置为 FAILED 并包含错误详情
• 查看日志请访问 https://osop-editor.vercel.app