AI Coding 基础体验

目标不是让 AI 一次生成完整项目，而是走通“说清需求、检查改动、运行验证、保留退路”的完整入门闭环。开始前先完成 Hello World，并确保手里有一份能正常打开的 hello.html。

先把任务缩小

不要只说“帮我把网页做得更好”。一个适合第一次练习的需求应该能在几分钟内验证，例如：

修改 hello.html：增加一个按钮，点击后把页面文字从“Hello World”改成“你好，大学”。只使用原生 HTML、CSS 和 JavaScript，不加载外部库。修改后解释改了哪些位置，以及我应该如何验证。

这个要求说明了文件、行为、技术限制和验收方式。需求越具体，你越容易判断结果是不是正确。

接受修改前先看差异

无论使用哪种 AI 编程工具，都先确认：

• 它准备修改哪些文件，有没有碰到需求之外的内容。
• 是否增加了陌生依赖、远程脚本或外部资源。
• 是否删除了原有代码，删除的原因是什么。
• 是否要求运行管理员命令、关闭安全功能或上传整个目录。
• 代码里有没有密码、密钥、学号、真实姓名或私人路径。

看不懂一大段改动时，不要直接接受。让工具把任务拆小，或要求它只给出一个最小补丁并逐段解释。

如果目录已经用 Git 管理，可在终端运行 git status 查看哪些文件发生变化，用 git diff -- hello.html 查看尚未提交的逐行差异。以 - 开头的是删除行，以 + 开头的是新增行。只读检查不会修改文件；不要在不理解时运行会丢弃改动的重置命令。

做一次最小验证

1. 先复制一份原始文件，命名为 hello-before-ai.html。
2. 让 AI 只修改 hello.html，不要改其他文件。
3. 对照需求检查 HTML、CSS 和 JavaScript 的变化。
4. 用浏览器打开页面，点击按钮两次，确认没有报错。
5. 刷新页面，确认初始文字和交互仍符合预期。
6. 如果结果不对，描述“实际结果”和“预期结果”，让 AI 只修复这个差异。

还可以打开浏览器开发者工具的 Console：Windows/Linux 通常按 F12，macOS 常用 Command + Option + I。点击按钮后若出现红色报错，复制完整报错和触发步骤，而不是只说“按钮坏了”。

验证不是“页面能打开”就结束。按钮是否可点击、文字是否正确、刷新后是否正常、原有内容是否保留，都属于验收。

不要交给 AI 的内容

• API Key、密码、验证码、Cookie 和登录令牌。
• 身份证、成绩单、未公开作业和包含他人信息的资料。
• 自己无法解释但要求管理员权限的终端命令。
• 没有备份的重要项目目录。
• 课程或比赛明确禁止使用 AI 完成的部分。

如果工具要求上传整个项目，先检查 .env、配置文件、下载资料和个人信息是否在其中。敏感内容应移除或替换为假的示例值。

出错时如何恢复

• 没有使用 Git：关闭错误文件，把 hello-before-ai.html 复制为新的 hello.html。
• 已经使用 Git 且改动尚未提交：先看 git diff，只恢复确认不需要的文件。初学阶段可直接保留备份文件并请老师或可信同学协助，不必冒险运行陌生命令。
• 已经提交：保留错误提交也能帮助复盘。先创建修复提交，不要急着改写公共历史。

一份可复用的 AI Coding 提示词

可直接下载纯文本提示词模板，先根据自己的文件和验收标准修改，再交给工具。

任务：只修改 hello.html，为页面增加一个按钮。
当前行为：页面显示“Hello World”，没有交互。
目标行为：点击按钮后文字变为“你好，大学”。
限制：不新增依赖，不访问网络，不修改其他文件。
验收：页面可打开；按钮可用；刷新后恢复初始文字；Console 无报错。
工作方式：先说明计划和将修改的文件，给出最小改动；完成后列出验证步骤。

完成标准

完成后，把需求、差异截图、验证结果和恢复方法写进 README。你应该能回答：需求是什么、AI 改了哪些文件、每处改动为什么存在、你如何验证、出错时如何恢复。能完整回答这五项，才算完成。