7.2 自动化脚本实战路径¶
自动化脚本适合作为 Vibe Coding 练习材料。输入、输出和退出码明确，可以限制 Agent 的自由发挥范围。
这个练习不追求脚本功能多。目标是让 Agent 在一个边界清楚的任务里完成“定义接口、实现、测试、报告失败”的闭环。
推荐练习¶
做一个 Markdown 链接检查脚本，先限定范围：
- 扫描指定目录。
- 找出 Markdown 文件里的链接。
- 检查本地相对链接是否存在。
- 输出损坏链接报告。
先不检查外部链接，也不处理复杂锚点跳转。范围缩小后，才容易判断 Agent 是否真的把核心逻辑做对。
为什么适合练习¶
- 任务不大。
- 输入输出明确。
- 容易写测试。
- 能练文件扫描、路径处理、错误报告。
- 不需要复杂 UI。
执行步骤¶
任务 1：定义 CLI¶
命令：
check-md-links <dir>
输出：
文件路径、行号、损坏链接。
退出码：
0 表示无损坏链接。
1 表示存在损坏链接。
任务 2：让 Agent 写计划¶
先把 Agent 限制在计划阶段：
- 不直接实现。
- 先列边界情况。
- 先列测试样例。
边界情况：
- 空目录。
- 无链接文件。
- 相对路径。
- 锚点链接。
- 外部链接跳过或只记录。
任务 3：实现和测试¶
顺序：
flowchart LR
A[解析 Markdown] --> B[提取链接]
B --> C[解析路径]
C --> D[输出报告]
D --> E[测试]任务 4：整理交付记录¶
让 Agent 在完成后输出：
Changed files:
Commands run:
Known limitations:
Examples:
Next safe improvement:
如果它只说“完成了”，说明练习还没结束。
验证标准¶
- 样例目录下能识别坏链接。
- 正常链接不误报。
- 输出包含文件和行号。
- 测试通过。
- 退出码符合约定。
- 已说明暂不支持的链接类型。
进阶¶
把这个脚本放进 skill：
当用户要求检查文档链接时，调用脚本并总结结果。
当脚本能被稳定调用、输出也稳定时，就具备了升级成 skill 的条件。
升级前先跑三次：空目录、全正常目录、含坏链目录。三次结果都稳定，再把它接进 skill 或 CI。