上手课

第9课|动手之前,先有方案和任务单——你签的是"改起来多贵"

上手课 · 第 9 课 · 2026-11-21

今天下午,这个网站连换了三轮皮肤:月白、金墨,然后定稿红猫系——芥末黄、朱红、钴蓝。第三轮从说出口到全站九张页面变色,一个脚本,十分钟内。

不是手快。是两个小时前写方案的时候,把"以后改起来多贵"这件事,先付过账了。

这一课讲动手前的最后两页纸:技术方案,和任务清单。它们的质量好不好,不看专业名词多不多,就看一件东西:改起来贵不贵。

本课目标

  • 看清一份能用的方案和一张能施工的任务单长什么样(都是今天真件的仓库链接)
  • 学会你签方案时该问的那一个问题
  • 明白为什么我们的"方案文档"就两个 md,而不是 OpenSpec 的一叠文件夹或 spec-kit 的四道命令

概念卡

  • 技术方案(plan):一页纸,说清做什么、不做什么、页面清单、数据怎么流、怎么验收。给未来的你看的,不是给 AI 交的作业。
  • 任务清单(tasks):把方案切成包的施工单。每包要能在一个短工时段里做完,并且带一条能当场判真假的验收。
  • 变更成本:需求变了,要动哪几个文件、多少处。它是外行人也能审懂"方案好坏"的那个物理量。
  • 规格仪式(对照用,认得即可):OpenSpec 把一个功能的方案装进一个 change 文件夹(proposal/specs/design/tasks 四件),spec-kit 把整套流程做成四道命令。它们把文档做成了仪式,重与轻都是代价。

论点一:方案的价值,要等"以后"才兑现

证据就是今天的换皮肤。

方案文件(网站设计-v1.md)里写死了两样东西:页面是"7 个模板 × 皮肤参数包"的结构;颜色只许从三个锚点引用——主色 #df5a30、辅色 #1d4e89、字标斜体规则。于是换皮=换三个值,九张页面自己跟上,favicon 和抽屉跟着变。

诚实的半面也得讲:同一天更早的时候,红猫"选定"只落了 logo——头像换了、页头换了,皮肤的颜色和字体并没进站,是我追问"怎么没有应用在网站上"才补上的。这说明什么?方案没写到"皮肤是一种可替换资产"的时候,变更成本就会在实现里补票。 后来这件事被写进 P5 任务包和验收条款(改主色=一个变量全站生效,当场演示)。你看方案的"好",从来不是写完那一刻定级的,是第一次返工给它定级的。

论点二:任务清单,能验收的才活着

今天烤完需求之后立的那张施工单(就放在课 9 项目目录 tasks.md,仓库可查),六个包长这样:

  • P1 数据路由:文章 frontmatter 加 kind 字段,build.py 按类型分发;验收=故意放个错值它要当场报错停下
  • P2 课程路径页:课表流+轻搜索+翻页链;验收=搜"后悔药"必须命中第3课、空结果必须有逃生口、计数必须等于实际文件数
  • P3 文章与图文分家:两个独立页面不许混排
  • P4 首页 Now Page:验收里加了一条今天新立的——"双周一更/首发"这类承诺词,全站 grep 必须为零
  • P5 皮肤与品牌锚点:改一个变量=全站换装,当场演示
  • P6 记忆尾巴:规矩回写 CLAUDE.md,新会话能复述

注意每一条验收都能当场判真假。写清单的时候我顺手下过一条"页头导航要和皮肤视觉统一"——落笔就发现它判不了真假,等于没写,回炉成"三锚点引用、不许散色硬编码"。一条任务没有可判真假的验收,它就是张空头支票,施工那天一定会以吵架的形式兑现。

论点三:AI 出方案,你签——问题就问那一句

今天这张方案挨过的真实追问,三次:

1. "移动端兼容吗,平板呢" → 首版没写断点设计,补 2. "移动菜单还有别的方式吗" → 方案默认底部 Tab,对比三样后改判抽屉 3. "为什么要写双周一更" → 方案里把旧规划的目标当成了事实文案,全站点清扫,并从此把"不许出现更新承诺词"写进验收

发现规律没有?审方案不用考文笔,只需预演变更。 你的那一句永远是一样的:"要是我想改 X,要动多少地方?"问得越多,方案会被改得越便宜。三个追问,换来断点条款、导航定稿、承诺词禁令——每一个都在后来省下了不止一次返工。

为什么我们的方案就两个 md,不上一套流程

第 5 课那张地图上,OpenSpec 把方案做成 change 文件夹(每个功能一套 proposal+specs+design+tasks),spec-kit 把流程做成四道命令。它们好在有历史、能协作、防口说无凭。代价是要你先皈依一套目录宗教。

盘一下家底:CLAUDE.md 已经在(那就是 spec-kit 说的 constitution),任务书是烤出来的(那就是 spec),方案正本一个 md、施工单一个 md,全进 git——四样凑齐了,只差没换皮。所以选最薄的那条路:不换流程框架,只补缺的那几页。等哪天真的多人协作、需求历史要审计了,那两家的东西随时接得住——方案文件结构本来就是按它们的零件排的。轻,不是偷工,是账算过。

跟做步骤

1. 把你烤出来的任务书(课 7 产物)甩给 AI,说:"据此写技术方案:页面清单、数据怎么流、明确不做什么,每个大决策旁边标注——想改它要动多少地方" 2. 方案回来,别点头。先问三个"如果我想改 X"(挑你真想改的:配色、入口、加一类内容),让它改到你能预算代价为止 3. 说:"把方案拆成施工包,每包两三小时内能完,每条带一句能当场判真假的验收" 4. 通读 tasks:凡是验收读成"美观/统一/良好"的,打回重写 5. plan.md 和 tasks.md 存进仓库、commit;从此铁律:先改方案文件,再改代码,顺序反了就是失忆(第 6 课的药,这里吃第二次)

及格标准

你的项目里躺着进了 git 的 plan 和 tasks,tasks 里每条验收你能当场执行出真或假;并且你能说出方案里哪一条,是被你自己的追问逼出来的。

卡住了

  • AI 交来十页长文:要求"一页纸,六十行以内"。方案本身的篇幅就是一种变更成本——没人维护的长方案等于没有方案。
  • 任务拆不开:用两小时刀法切——超过两小时再劈一半,小到一个下午能验收就停刀。
  • 方案一改就旧:把"代码与方案冲突时先改方案"写进 CLAUDE.md。方案不是石碑,是活的账本。

轮到你了

下一课起,我当着你的面执行这张 tasks.md:逐包施工、逐格勾掉、翻车就回来记账。你会看到施工清单的真实寿命——它不是写完美了就完事,它是被勾选和被修订一起养大的。

深入读

  • OpenSpec(当天验活):https://github.com/Fission-AI/OpenSpec
  • spec-kit(当天验活):https://github.com/github/spec-kit
首页课程文章图文关于
本站纯静态 · 零 Cookie 零追踪
公众号首发 · 这里永久存档