第10章 实践任务——从头到尾走一圈
必读 想跟着这个阶段学下去,一定要读这一章。一句话总结:把第 1~9 章的流程一口气接起来做一遍。就是计划 → 制作 → 检查 → 审查 → 发布 → 运营 → 安全检查。 最后的任务是用我自己的问题从头做起。请用检查清单自己确认。
本章是汇总前面各章内容的任务章。依据在各章的脚注里。不需要一开始就完美。 卡住了就回到那一章重新读。
任务 1——待办看板走一圈
如果你跟着前面各章的「亲手试一试」做下来,这个任务就已经完成了。如果跳过了,就按顺序做一遍。
| 顺序 | 要做的事 | 章 |
|---|---|---|
| 1 | 在 GitHub 上创建公开仓库 cafe-todo-board,并克隆到我的电脑上 | 2 |
| 2 | 接受 Claude 的采访,写出 SPEC.md | 3 |
| 3 | 用新会话和计划模式拿到计划,在分支上做出第一个界面 | 4 |
| 4 | 做一个检查 SPEC.md 标准的装置,并拿到证据 | 5 |
| 5 | 建 PR,经过与 SPEC.md 对照的审查后合并 | 6 |
| 6 | 公开之前用检查清单确认秘密值和个人信息 | 9 |
| 7 | 用 GitHub Pages 公开,并在手机上打开 | 7 |
| 8 | 把改进写成 Issue,用 fixes #Issue编号 再走一圈 | 8 |
来源:本指南的整理
想看完成后的样子,可以看实际按这个作业做出来的示例页面和仓库。你的结果和它长得不一样也没关系。
理解检查
待办看板一圈的顺序,哪项是对的?
任务 2——用我自己的问题从头做起
从你的生活或工作里挑一个小小的不便,用同样的流程做一个网页。比如这些。
- 查看我们社团这个月的日程
- 我读过的书和一句话感想的清单
- 店里的菜单和营业时间说明
第一个请求像第3章一样,从采访开始。
我想做一个解决<我的不便>的小网页。我还没有深入想过。请采访我,直到可以写出规格说明,全部完成后写进 SPEC.md。因为要上传到公开仓库,所以我不会放进个人信息。注意:像店铺说明这样,如果要用在真正的生意上,请先确认第7章里看到的 GitHub Pages 的禁止事项(经营生意、网店、商业服务)。当作练习来做,和用在真正的营业上,是不一样的。
理解检查
想把用自己的问题做出来的店铺介绍页面用于实际营业。先确认什么?
检查清单
完成任务后,请逐项确认下面的内容。全部都是"是",就说明这一圈走得很扎实。
计划
- ☐ SPEC.md 的每一行都可以用是/否来确认。
- ☐ SPEC.md 里有至少一行"不做的事"。
制作
- ☐ 用计划模式读了计划,批准之后才开始制作。
- ☐ 不是在
main上,而是在分支上制作的,一个提交只有一处改动。
检查
- ☐ 有检查装置,并且拿到了运行过的命令和输出这样的证据。
- ☐ 看到了故意弄错时检查会失败。
审查
- ☐ PR 说明里写了改了什么、为什么改。
- ☐ 在新会话里接受了与 SPEC.md 对照的审查。即使没有发现问题,也亲自浏览过。
发布与运营
- ☐ 公开地址在手机上也能打开。
- ☐ 下一步改进已经写成了 Issue。
安全
- ☐ 仓库和页面里没有秘密值、真名、联系方式。
- ☐ 有
.gitignore,并且写进了可能含有秘密值的文件。
来源:本指南的整理
用其他工具试试
这一节是选读的。如果你在第3阶段只用了 Claude Code,可以跳过。
第3阶段除了 Claude Code,还有 Codex(OpenAI 的编程工具)和 Antigravity(Google 的编程工具)的指南。这两个工具里也有对应的功能,可以走同样的流程。表里的名称,是各个工具里做这件事的命令、画面或文件。
| 要做的事 | Codex | Antigravity |
|---|---|---|
| 先做计划 | /plan | Planning mode |
| 查看改动内容 | 审查窗口 | Review 窗口 |
| 规则文件 | AGENTS.md | AGENTS.md·GEMINI.md |
来源:Codex 第4章·Antigravity 第 2、3 章
把同一份 SPEC.md 交给两个工具,比较结果,也是很好的练习。正如第3阶段看到的,即使指令相同,每个工具漏掉的东西也可能不同。
小结
- 任务 1 用待办看板,从计划到安全检查走一圈。
- 任务 2 用我自己的小小不便从头做起。用在真正的生意上之前,要确认 Pages 的禁止事项。
- 检查清单的每一格都是"是",就说明这一圈走得很扎实。
这一章读完了吗?
学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。
下一章:第4阶段 AI-SDLC 指南到此结束。这样,hello-ai 的第 1~4 阶段就全部完成了。可以在第4阶段 · AI-SDLC 目录里选想再看的章节,也可以用 AI 知识水平测试检验一下到目前为止学到的东西。