# AGENTS - workflow-orchestrator

## 目录骨架
```
workflow-orchestrator/
├── SKILL.md               # 技能入口，状态机与 hook 约定
├── references/
│   └── index.md           # 参考索引与待补充子文档
```

## 职责与依赖
- 职责：用文件事件 hook + 轻量状态机编排 `workflow_steps/step1~step5`，支持失败回跳、归档与闭环。
- 上游：`workflow_steps/step1_需求输入.jsonl` ... `step5_总控与循环.jsonl`（提示词定义）。
- 下游：`workflow_engine/*`（建议的执行脚本/状态文件目录），`artifacts/` 与 `state/` 产物。

## 使用要点
- 状态文件：`workflow_steps/state/current_step.json` 为唯一调度入口；每次更新即触发对应 Runner。
- 总控逻辑：Step5 依据 `verify.status` 回跳 step2 或标记完成；防止无限循环需在 Runner 中实现熔断计数。
- 产物：建议按 `artifacts/<run_id>/<step>.{json,md}` 落盘，便于审计与归档。