IDE 联动操作手册

这份手册描述讲师在课堂上如何把 IDE、终端、浏览器、Git、Claude Code 和 Codex 串起来。目标是让学员看到一个真实工作流，而不是只看工具演示。

推荐窗口布局

区域	工具	用途
左侧	IDE 文件树和编辑器	展示 MD 文件、代码、测试
右上	终端	运行 Claude Code、构建、测试、Git
右下	浏览器	展示本地页面和验收结果
辅助窗口	Codex App 或 IDE 插件	展示 Codex 任务流

课堂操作节奏

每个实操段都按这个节奏走：

1. 读上下文：打开相关 MD 文件，不直接让 AI 写代码。
2. 让 AI 复述目标：确认它理解需求、范围和验收。
3. 让 AI 先计划：要求列出文件、步骤、验证命令。
4. 小步实现：一次只做一个可验证功能。
5. 运行验证：本地构建、测试或浏览器验收。
6. 人工审查：查看 diff，检查是否越界。
7. 更新文档：把新风险、约定和验收补回 MD。

Claude Code 操作

终端进入项目根目录：

cd D:\work\ai-delivery-board
claude

常用课堂命令：

/init
/memory
/permissions
/agents
/mcp
/compact

课堂提示词：

请先阅读 README.md、CLAUDE.md、docs/project/requirements.md 和 docs/project/acceptance.md。
不要修改文件。先用中文复述目标、范围、验收标准和你建议的实现计划。

第二步：

按计划只实现第一步：创建最小可运行页面和任务数据结构。
完成后告诉我改了哪些文件、如何运行、还有哪些风险。

Codex 操作

在 Codex App 或 IDE 中打开项目根目录，确认根目录有 AGENTS.md。

课堂提示词：

请先核查项目结构，阅读 AGENTS.md、docs/project/requirements.md 和 docs/project/acceptance.md。
先不要改文件。请输出实现计划、受影响文件、验证命令和风险。

第二步：

开始实现第一版 AI 项目交付看板。
要求：小步修改，完成后运行本地构建或测试，并给出中文变更说明。

Git 操作

讲师每完成一个阶段都展示一次 Git：

git status --short
git diff --stat
git diff

建议课堂提交节奏：

git add README.md AGENTS.md CLAUDE.md docs/project
git commit -m "docs: 初始化 AI 协作上下文"

git add .
git commit -m "feat: 完成任务看板最小可运行版本"

浏览器验收

本地启动后，浏览器验收不只看页面是否打开，还要检查：

• 任务是否能按状态筛选。
• 空状态是否可见。
• 交互是否不刷新页面。
• 页面文字是否对应需求。
• 控制台是否无明显错误。

验收记录写回：

## 手动验收记录

- 日期：2026-05-07
- 验收人：讲师
- 结果：通过
- 备注：筛选、空状态、状态流转均符合第一版范围。

常见失控点

• AI 直接开始写代码，没有先读上下文。
• 需求没有验收标准，导致输出无法判断好坏。
• 一次性让 AI 做太多，diff 无法审查。
• 构建失败但继续讲下一步。
• PM 只写功能名，没有用户、动作、状态和边界。