Week 05 · Agent-Ready Codebases

让代码库适合 Agent

可靠性来自可读的结构与可执行的反馈。

本周带走什么

仓库体检表与修复前后的对照数据。

09约 3–4 小时

为代码库做一次可用性体检

对应原课表:10/20 · Agent-ready 仓库结构

这课要学会

  • 检查 README、目录边界、依赖、测试和示例数据。
  • 区分代码不易理解与环境无法运行这两类阻塞。

学习资料 按顺序阅读,视频可分段看

官方文档AGENTS.md · 示例观察怎样让仓库入口可被代理找到。2025 官方作业官方 Week 2 起始项目选它作为仓库体检对象,避免拿陌生生产项目做第一次实验。

动手做

自学改编:从干净副本开始,记录首次启动、找到业务入口、运行测试、添加小功能的耗时。按“文档/结构/测试/检查/依赖”各 0–2 分自评。

2025 官方作业 · Week 2

交付物

10 分制自评表、3 个阻塞点、一个有证据的修复优先级列表。

完成标准:分数对应具体文件或命令;自评不是 Stanford 官方评分标准。

10约 3–4 小时

把检查接进持续集成

对应原课表:10/22 · Eno Reyes 嘉宾课 → 主题替代练习

这课要学会

  • 为关键路径补一个能捕获真实错误的测试。
  • 理解 CI、可复现环境与贡献指南如何帮助代理协作。

学习资料 按顺序阅读,视频可分段看

官方文档GitHub Actions 文档学习最小 workflow、触发条件与日志。2025 官方作业Week 5 全栈起始仓库已有测试和命令入口,可在自己的副本中增加 CI。

动手做

自学改编:在个人副本里接入测试与 lint。先提交一个会失败的测试,再提交修复;补一页 CONTRIBUTING 说明。

2025 官方作业 · Week 5

交付物

一次失败和一次成功的 CI 记录、修复 diff、更新后的仓库体检表。

完成标准:新贡献者仅按文档能完成检查;CI 用测试事实判断结果。

每课建议:60–90 分钟资料学习 + 90–120 分钟实作 + 30 分钟复盘。所有任务说明与验收细则为独立自学设计;嘉宾课使用主题替代练习。

独立自学导航,非 Stanford 官方课程网站。课表依据:2026 官网;讲义与官方作业来源:2025 课表。资料版权归原作者,核查日期为 2026 年 9 月 5 日。

全部作业与学习安排 →