第 5 章 · 问题 2:方案已经清楚,但还不是能用的工具
怎样让一个完全不会写代码的人,也能把项目简报做成双击可打开、手机上也能读的进度看板?
你负责说清用途、内容和验收;Codex 负责创建文件、写页面、检查和修改。不要先学 HTML,先学怎样把一个本地工具交付出来。
01先确认 Codex 复述的计划没有跑偏
四项不全,就直接补一句纠正,不要抱着“先让它做完再说”的心态。越早纠偏,返工越小。
为什么让它读 Work 成品,而不是你把内容口述一遍?
因为文件是这项工作唯一的事实源。口述有三个洞:会漏——你不可能把简报里每个数字背出来;会走样——转述一遍,“预约 1,842”变成“预约一千八左右”这种事防不住;会断——下周开新线程,口述的内容全部清零,文件还原样在项目里。第 1 章你逐条核验过项目简报,那次验收的价值现在兑现:Codex 读的是被你查过的底稿,不是你记忆里的版本。
这也是整门课把每样东西都落成文件的原因:简报是文件,交接单是文件,待会儿的规矩和检查记录也是文件。谁来接手——新线程、另一个模式、甚至换一台电脑——读到的都是同一份事实。你说过的话会散,写进项目的文件不会。
02整份复制建造任务,让 Codex 一次拿到完整工单
现在开始制作本地发布进度看板。
请在 02_Codex成品/发布进度看板/ 创建 index.html 和 README.md。页面只使用一个 HTML 文件,CSS 和 JavaScript 都写在文件内部,不使用外部框架、字体、图片或网络资源,双击 index.html 就能使用。
页面必须显示:项目名称、目标发布日期、下一次检查会、关键数据、负责人和任务、时间线、三项待确认风险、未来 7 天动作。事实只来自已经复核的 Work 成品;待确认事项必须有明显标记。
交互要求:可以按“全部 / 进行中 / 待确认”筛选事项;每个任务有本地勾选状态,刷新后保留。视觉要求:桌面清楚、390px 手机宽度不横向溢出、正文不使用大段巨型黑标题。
README.md 要写清:怎样打开、数据来自哪里、怎样更新内容、怎样人工验收。
完成后请自行检查:文件是否存在、HTML 能否打开、控制台是否有错误、390px 宽度是否横向溢出、所有待确认事实是否仍被标出。发现问题先修正,再汇报创建和检查结果。
这份工单看着长,骨架只有三根,拆开看你就能自己写第二份:
- 模块清单:页面上要有哪几块“页面必须显示”后面那一串就是——项目名、发布日期、检查会、关键数据、负责人、时间线、待确认风险、7 天动作。一条对应看板上的一个板块,少写一条,成品就少一块。
- 数据来源:只认 01_Work成品 里的真实文件不是“网上查一下”,也不是“你看着办”。数字、名字、日期全部来自你核验过的简报和数据摘要,看板上每个数字都能回到某份文件的某一行。
- 验收方法:双击打开能看、能点、手机不破版不懂代码没关系,验收动作全是外行做得来的:双击、点筛选、勾任务、把窗口拉窄到手机宽度。
剩下的交互要求和视觉要求,是这三根骨架上的肉。以后你给 Codex 派任何“做个工具”的活,先把这三样想清楚再开口,工单就不会空。
03看它怎样从“要求”一路走到“成品”
先找项目简报、数据摘要、交接单和交付标准,不从空白猜内容。
› Read 01_Work成品/项目简报.md › Read Work到Codex交接单.md ✓ 事实底稿已载入
模拟只有五步,真实运行会更热闹,但节奏就是这三段:
- 1它先列计划
建哪些文件、按什么顺序、先做哪个板块。计划和你确认过的复述对不上,当场喊停。
- 2它动手建文件、改文件
界面里能看到它当前在动哪个文件。你不用读懂代码,但每一处改动都会进“修改前后对照”(diff),它改了什么一目了然——怎么看这份对照,下一课专门讲。
- 3它自己跑检查
按工单最后一段自查:文件在不在、打得开吗、手机宽度溢不溢出。查出问题它先修再汇报——你等来的是“检查过的成品”,不是“刚写完的初稿”。
这几分钟你的角色和 Work 线一模一样:跟进度、答问题、审批动作。它请求在 02_Codex成品 里建文件夹和文件,放行;想动 00_素材或项目外的路径,拒绝并把边界说清。判断标准没换,只是现场从“写文档”换成了“建工具”。
04打开真实文件,不需要懂开发服务器
- 在 Finder 打开 c02-launch-kit
- 进入 02_Codex成品/发布进度看板
- 双击 index.html
- 在文件资源管理器打开 c02-launch-kit
- 进入 02_Codex成品\发布进度看板
- 双击 index.html
如果系统询问用什么打开,选择 Chrome、Edge、Safari 等现代浏览器。能直接看到完整看板,说明“单文件、无外部依赖”的要求做对了。
05第一版不用完美,但必须用具体反馈继续改
Codex 只能猜颜色、布局、字体还是内容哪里不对。
说清位置、问题和想要的结果,它就能继续改同一个文件。
请继续修改刚创建的 index.html:把“待确认风险”移到首屏关键数据下面;每一项写清“为什么未确认”和“下一步找谁确认”;在 390px 宽度下所有风险卡改成单列,标题不超过两行。不要改变任何已核验数字。修改后重新检查桌面和 390px,并告诉我具体改了哪些位置。
提反馈的句式练一次就会:位置 + 问题 + 想要的结果。再给你两句能直接套的:“关键数据那一块,数字不够显眼,把它做成整个页面最大的元素”;“时间线太长了,只展开未来两周,更早的折叠起来”。指着模块说人话就行,不需要任何术语——它听得懂“太挤”“不显眼”“折叠”。
一轮别超过三条。十条意见一起倒进去,它全改完你反而检查不过来,哪条改坏了都对不上号。小步快走:提两三条、看结果、再提两三条,每一轮你都清楚是哪句话导致了哪处变化。
看板上的数字,明天素材更新了会自己变吗?
不会。现在的数字是 Codex 生成页面那一刻从 Work 成品里抄进去的,写死在文件里。明天预约数涨了、某项风险确认了,看板不会自己知道——这版看板是一张“拍下来的照片”,不是一块“连着现场的屏幕”。
这不是缺陷,第一版工具几乎都这样,而且照片也已经比没有强:至少全组看的是同一张。让它活起来是后面两章的正事:第 6 章把“素材变了 → 重新生成看板”练成一条固定接力,第 7 章的发布指挥中心再往前一步。现在只需要 README 里写清数据更新方法——工单里已经要求它写了。
0 / 5 · 看板还不能交工
下次让 Codex 做任何工具,先把这三样想清楚:页面上有哪几块、数字从哪来、你亲手怎么查。哪样说不出口,先别开工。
挑一份手头真实的清单(活动物料、项目排期、家庭采购都行),放进一个独立文件夹,照三根骨架写工单,让 Codex 做成双击可开的单文件网页。提示:验收标准照抄本课那五条,一条别删——尤其“不使用外部资源”那条,它保证你的网页在任何电脑上都打得开。
对着挑战 1 的成品,用“位置 + 问题 + 想要的结果”句式提三轮反馈,每轮不超过两条。提示:每轮改完先自己验收一遍再提下一轮,体会“小步快走”和“一次倒十条”的差别。
现在回头守住事实底座:先对 Work 简报做来源复核,避免把错误口径漂亮地放大到工具里。
下一课:回查来源,守住事实底座 →最后验收
不要只确认“AI 说做完了”,请打开真实结果检查。
02_Codex成品/发布进度看板/index.html回到当前 Work 或 Codex 任务,请它打开成品;也可以在访达 / 资源管理器里按下面的路径找到并双击。