# 设计第一个自动化工作流：从输入到结果，不漏掉失败分支

原文：https://itjc.com/tutorials/workflow-design/
主题：自动化工作流；级别：实战；更新时间：2026-11-15。

> 以教程链接巡检为例，先做只读流程，再加入重试、去重和通知条件。

## 选一个可衡量的小任务
用“检查本站引用的官方文档链接”作为练习。输入是链接列表，输出是每个链接的检查时间、响应结果与错误说明。先只在本地生成报告，暂不自动修改文章或发送消息。

## 先定义成功与失败
成功不只是脚本退出。需要确认每个输入都有结果，超时被记录，重定向后的地址被保留。某些站点会对自动请求限流或返回访问挑战，因此一次请求失败不应直接判定页面永久失效。

```text
读取链接列表
→ 逐项请求（设超时与并发上限）
→ 记录状态、最终地址、错误
→ 与上次结果比较
→ 生成变化报告
→ 满足通知条件时才通知
```

## 再决定哪里需要 AI
发 HTTP 请求与比较状态可以用确定性脚本完成。AI 可以辅助判断页面迁移说明或整理报告，但不需要替代所有固定步骤。先把输入和输出定义好，后续更容易换实现。

## 写出失败分支
网络超时可以有限重试；认证问题应停止并报告；格式错误应指出具体输入。不要无限重试，也不要把失败吞掉后生成“全部正常”。为每次运行保留时间和唯一标识，便于追溯。

## 控制重复执行的影响
本次练习只读，重复请求的主要影响是流量和限流。以后加入发信、写数据库时，要先定义去重键和已处理记录。相同结果不应每次都触发一条通知。

## 本地测试清单
- 一个正常链接能产生成功记录。
- 一个不存在的地址能产生失败记录。
- 超时有上限，不会挂住整个流程。
- 相同输入重复执行，报告结构保持一致。

完成这些检查后，再把任务交给定时器。先能解释手动执行的结果，才能判断自动运行是否可靠。

## 官方资料与参考

- [GitHub Actions 工作流语法](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax)
