一位不懂代码的居品司理，用175天孤独搭建起覆盖Web端、运营后台、数据收集、自动写稿、短视频与支付会员的完好系统。他复盘了从失败到告成的需求开辟模式，提倡Spec三份文档（需求、盘算、任务）不可偏废，并强调强制力必须落在机器上。本文深度拆解AI期间需求可判定性的中枢瓶颈与Agent器具链的实战阅历。

一个不懂代码的居品司理，用 175 天作念出一套覆盖 Web 端、运营后台、后端接口、数据收集、自动写稿、自动制作短视频与支付会员的系统。并在此过程中探索出新期间的需求开辟模式：Spec，摸索出一套完好的agent器具链。

论断有四：瓶颈在需求的可判定性，不在代码产能；需求、盘算、任务三份文档各修起一个不可替代的问题，缺一即失效；AI 读代码读不出东说念主其时的盘算意图，一套文档系统是它不走偏的前提；强制力必须落在机器上，落在文档里的法则等于莫得法则。

一、六个月，我作念出了什么1.1 系统组成

后三行不依赖算法，仅仅业务法则加经过编排——AI 最擅长的部分。短视频系统还留着伏笔：每期框架固定，只换一个设立文献；剧本按「时长、画面、口播、屏上笔墨」四列写成表格，阐发后才制作。四列剧本等于一份可验收的需求，其时我还不这样叫它。

1.2 三组数字

二、面向 AI 写需求：一条失败旅途的复盘2.1 发轫仅仅一个点子

每个交昔时收盘后，我要手工翻十几个页面，把涨停梯队、板块强弱、资金流向抄进条记，约两小时。我念念压到终点钟。

初版只科罚这一件事，两条料理。功能料理：只作念一屏看完今天的大盘，不作念选股、回测、交往，功能一多势必半制品，而半制品莫得用户，包括你我方。骨架留口子：前端不是页面，是面板注册表加布局引擎；后端不是几个接口，是一张表对应一个数据源、一个口径对应一处界说。

合起来是一句话：功能料理在用户看得见的阿谁点，彭胀性放在你看得见的骨架上。

4 月 28 日至 5 月 4 日，34 次提交，七次标题是面板增删或改版，零份需求文档。初版是聊出来的。这莫得错，初版需要的是速率；错的是把这个民俗带进了第二个月。

2.2 本事选型：让 AI 交左证，而不是给建议

最常见的问法是「我念念作念一个股票看板，用什么本事栈」。这个问法势必失败：模子不知说念你的料理与资本上限，也不知说念我方哪一条查不到，只可复返一份不知哪一年的最好实践清单。

有用的问法有三段：

这是我要作念的五件事；

这是我能接纳的部署与珍贵资本；

请逐个查这些候选的真实限制，给我一张对照表，并明确告诉我哪一条你查不到。

第三句是重要——把「我不知说念」酿成一个正当输出。

发问之后是实测：给每个候选写只读探针，在真及时段跑一段窗口，纪录字段、单元、限流与特别形态，再与文档逐条对照。一个源文档三处不符，另一个首轮六处、累计八处。

由此定例：论断必须标类型，实测过标「已实测」，只读文档标「文档」，后者不稳妥事实用。它其后升格为需求规范的硬性要求：口径、公式、数目级必须用分娩数据或实测核实，来源与日历写在傍边。

能被考证的选型才着实。「激烈推选」却拿不出实测左证的，按揣测处理。

2.3 传统需求经过与它的五份产物

传统软件的职责流是一条串行链：

需求文档 → 盘算稿 → 需求评审 → 本事评审 → 本事排期 → 开辟 → 测试 → 上线。

它千里淀出五份产物，每份都有明确的读者：

链条开辟有一个隐含前提：每一环的读者都是东说念主。东说念主能补全空缺，能在不祥情时启齿问，能用知识拒却无理的已毕。

交给 AI，前提坐窝失效。五种形态，全部来自真实纪录。

范围未覆盖：只写普通情况，没写数据为空、停牌、跨日、开关关闭。已毕只处理普通旅途，特别要么报错，要么静默复返空。功能点遗漏：一段话塞五件事，录用三件半。莫得编号，无法逐条比对，致使无法判定它错。验收缺失：作念完我说嗅觉不对，它改一版，我仍以为不对。轮回四轮，发现两边对「对」的界说不同。口径未核实：「涨幅按前复权计较」——哪一种，谁定的，查过吗。更严重的一次：一个后台面板上线后数据恒为 0，需求默许「这张表有东说念主写入」，而事实上莫得分娩者。表存在，不等于少见据。特别无顶住：接口失败时静默照旧报错，没东说念主写，于是静默失败了三个月。

吞并个根因：这种体裁不提供判据。散文能抒发意图，修起不了「作念到莫得」，也修起不了「谁说了算」。

需求文档不是写给东说念主看的诠释，是写给履行者的合同。合同莫得负约判定，就等于莫得合同。

2.4 精简到三份，一份都不成再少

五份里，代码与测试用例不是文档，是恶果。要盘算的是另外三份的位置。

需求文档，修起要什么、若何行为念到。读者同期是东说念主（评审）与 AI（已毕），两者都必须能判定。盘算文档，修起若何作念。含交互盘算（用户看到什么、操作后发生什么）与本事盘算（数据从哪来、存在哪、接口什么局势）。合并成一份，因为二者常是吞并个决定：一个面板能有什么交互，取决于它的数据从哪来。开辟任务文档，修起按什么礼貌作念、每步作念完若何验。它把盘算切成可孤独验收的单元，带编号与依赖。

还能再砍吗？一一试。

去需求文档，只剩盘算与任务：「为什么作念、作念到什么程度算完成」无处可查。AI 会按盘行为念出一个能跑的东西，但无东说念主能判定它是否自尊初志。盘算修起若何作念，不修起作念什么。去盘算文档，只剩需求与任务：任务只可按需求条目机械切分，切出的单元之间莫得分享决策，各自选一套决议，终末拼不起来。返工代价高于写一份盘算。去任务文档，只剩需求与盘算：这是最常见的省法，也最贵。AI 会一次已毕整份盘算，你只可举座接纳或举座打回，无法逐段验收；「哪些作念完毕」也失去载体。

三份各修起一个不可替代的问题：要什么、若何作念、作念到哪算完。需求给判据，盘算给决议，任务给进程。缺一份，闭环上就有一个要领莫得产物，只可靠东说念主的缅念念兜住——而东说念主的缅念念，恰是这套经过要替换掉的东西。

Kiro 的 Spec 等于这三份：requirements、design、tasks。它莫得发明新结构，仅仅把这条已被考证的产物链作念成了有阶段、有回首的工程经过。

2.5 发现 Spec

发现过程是一次针对失败清单的检索。先问为什么 AI 写出来总差小数，获取规格驱动开辟（Spec-Driven Development）；再问主流决议各自立制了什么，获取一份对于 Kiro Spec 职责流的完好诠释，从三份文档的职责到启动相貌到履行模式，于今留在名堂文档里；终末拿这些决议逐条比对失败清单——不看器具多强，看它能治哪个病。

比对之后，Spec 的最小结构是：

意图 + 判据 + 范围。

意图是一句话说清此次要改什么。判据是每条验收惟有一个通过与否的判定，能给数值就给数值，必须写乌有旅途。范围是至少一条「不作念什么」，以及会出事的那几个景况。

按这个界说，好多产物不算 Spec：

「先写需求，不许先写盘算」反直观，却是地基：一朝先念念决议，需求就被决议裹带——你会只写这个决议能自尊的需求，把决议作念不到的部分偷偷删掉。这条其后写进了规范第一段。

2.6 各家模式：一个坐标系

比名次更有用的，是两个轴。强制力：有莫得东说念主或机器在管，写了不履行会若何。考证：有莫得东西考验「代码简直已毕了 Spec」。

主流决议放进去，绝大多申斥在左下角：既无强制，也无考证。它们的推行是更好的模板。

（扫尾 2026 年 10 月的公开信息，星数与订价会变。）

另有一条阶梯在 2026 年头烧毁抓久 Spec，改把代码商定反向索取成方法注入高下文。这不是舒适，是另一个赌注：要是模子弥漫强，也许不需要抓久文档，只需要抓久方法。

我从 Trae 迁到 Kiro：Trae 的 Spec 要我方珍贵，器具岂论评审与履行；Kiro 把 Spec 作念成经过的一等公民，有阶段、有面板、有回首，且自带结构料理逼我按礼貌走。对不写代码的东说念主，「被经过推着走」比「给我充判辨放」有用——解放是包袱，因为我枯竭判断解放是否被豪侈的智商。第三层次由在 2.7 伸开。

2.7 Kiro 的产出形态

一份 Kiro Spec 恰是 2.4 推出的三份：需求、盘算、任务。需求用 EARS 句式写，盘算写决议，任务带依赖与编号，且每条回指需求编号。

一份真实的需求文档，开端轮番是简介（一句话说清作念什么，并诠释已毕分四层）、术语表（逐条界说系统、面板外壳组件、默许布局常量）、然后是编号需求。术语表在写需求之前先把词固定下来，背面所有这个词条目都援用它。歧义靠界说铲除，不靠反复解释。

EARS 的价值不在整皆，在它免强你说出触发条件：

<系统>应……

当<事件>时，<系统>应……

在<景况>时期，<系统>应……

要是<条件>，那么<系统>应……

第一滑是智商，第二行是闹翻事件，第三行是抓续景况，第四行是乌有旅途。不写触发条件的「验收」，等于没写。

三个平直收益：需求可判定，不再争论「对不对」，只查验某一条过没过；需求可回首，漏掉哪个功能点，任务清单与需求编号对一遍就知说念；履行有节律，任务切成最小单元后模子一次只干一件，不错一件一件验收。

Kiro 确切教授我的不是「写三份文档」，是把一件事拆成能被逐个判定的最小单元。这个智商与器具无关。

2.8 但我照旧离开了：四类过错分类不够用：惟有功能与过错两种 Spec。「改一个统计口径」「加一条 CI 查验」「重写一份法则文献」算什么？全塞进「功能」，档位虚高，写稿者运转恶浊。庆典资本过高：改五十行也要走三份文档。当经过资本高于收益，东说念主不会不服，东说念主会绕过——平直在对话框里改，Spec 目次安稳酿成摆设。完成景况不着实：面板上点「完成」很顺眼，但代码到底作念没作念，惟有提交历史知说念。面板上的勾不是景况的真相。方式靠自愿，漂移无东说念主拦：一个自动校验 Spec 方式的钩子，连气儿四次静默失效：匹配法则被过度转义，要求旅途含字面反斜杠，从未匹配；内联剧本被 shell 吃掉，反斜杠被吞、反引号被当作大喊替换；取旅途用错字段名，每次报错退出，而宿主把非零退出码当作静默失败；判据是手写的再行已毕，从未与巨擘已毕差分——一次对照就查出十几份「巨擘判错、剧本判过」。

四次失效，一次都莫得报警。护栏存在，不等于护栏收效。

另有三颗小钉子：Spec 锁在器具目次，换器具即断；按额度计费，写得越多越贵；写入大文献会被流畅重置掐断。

这不是 Kiro 作念得差，而是通用器具与具体名堂之间势必存在的缝。缝只可由名堂我方补。2026 年 9 月，我把整套东西搬到 Claude，把踩过的每一个坑写成一条一条的法则。

三、我重建的这套模式

2026 年 9 月 23 日，新体系上线。尔后一个月，27 套新方式 spec、206 张施工单跑在这套法则上。法则自身 312 行，纯 markdown，任何 agent 与东说念主都按吞并份写。

3.1 六条原则

重建这套模式为三件事：让 AI 少漏功能；让需求不必都付三份文档的资本；让每一次代码变调都先读 spec 再脱手——不了解当初的决定，改出来的东西一定走偏。

Kiro 的问题不在要求三份文档，而在要求所有这个词事情都付这份资本；也不在方式自身，而在方式以外莫得东西保证需求写全了，更莫得东西保证其后的东说念主会去读它。六条原则围绕这三点。

分类先于经过：不同性质的事归口不同，需求才不会被塞进分歧身的模板里丢掉细节。分类错了，背面所有这个词档位都是错的。资本随风险走：五十行的变调不该付三份文档的代价。经过资本高于收益时，东说念主不会不服，东说念主会绕过——绕过之后，连那三份文档也莫得了。先读后改：动任何一处代码前，先读它当初的 spec 与守卫测试。代码只诠释当今是什么，spec 诠释为什么是这样。跳过这一步，改出来的东西就算能跑，也巧合是当初要的。验收先于已毕：每条验收惟有一个通过与否的判定，编号可追，能给数值就给数值，必须写乌有旅途。AI 最典型的失效不是作念错，是少作念，而少作念只可靠逐条比对发现。景况惟有一个真源：功能点有莫得作念完，看复选框与提交历史，不看面板。面板上的勾是自述，提交是事实。强制力落在机器上：写在文档里的法则是愿望，写进 pre-commit 的法则才是法则。东说念主能忘，剧本不会。

3.2 第一步：四类分流

判据轮番问三句：改的是研发体系吗？原来的举止是错的吗？用户能看到的举止要变吗？

类型还决定考证递次：过错先复现，更正先诠释注解旧举止，新功能验新举止与相邻举止，工程任务验门槛简直拦得住。

这一条平直解掉 Kiro 的第一个过错——「改一个统计口径」不再被塞进「功能」，它有了我方的归口。

3.3 第二步：先调研，再定档

定档前必须调研，深度到能写出四行：根因（或指标）、影响面（调用方与破钞方清单，以及若何列出来的）、同类（吞并写法还有哪些位置，若何胪列的）、改法（能一句话说清就写一句，说不清就写卡在哪）。

调研只读：不改代码，不改仓库文献，复现剧本放临时目次。先读关联的旧 spec、守卫测试与既有已毕，再看调用方与破钞方。论断触及「若干行、什么值、有莫得这种数据」的，查分娩库。

四行只写一处：A 档写进 commit message，B 档写进 spec 第一节，C 档进需求与盘算。

为什么必须有这一步：定档若靠拍脑袋，档位就退化成态状词。而调研自身是最低廉的一步——它花的是一小时，省的是返工。

3.4 第三步：三档

「一句话说清」的方法不是行数，是一个提交作念得完、一次考证验得完。要分几步作念、每步各自考证的，算说不清，走 B。

变调量不参与定档。判的是要不要分步，不是大小。

A 档是整套盘算里最重要的零件：它把经过资本压到零。莫得 A 档，所有这个词小变调都会被动走 B，然后所有这个词东说念主学会绕过 B——这恰是 Kiro 第二个过错的成因。给经过留一个至意的出口，比强行要求所有这个词东说念主守规矩有用。

C 档另有一条硬规矩：批准字段必须是单唯一个提交，之后才调鼓动任务。改一滑代码，不可能顺遂把批准也改了。

3.5 第四步：风险孤独加码

风险不定档，在已定的档位上重复。风险大的一票收效，不会被「变调小」「限制小」冲淡。

这条把「资本随风险走」落成了可履行的判据。亦然我踩过坑的所在：改一个统计口径，代码惟有三行，但卑鄙三个面板的口径全变——这种变调的风险是中，档位不错是 A，但 A 也必须先报。

3.6 第五步：景况真源移进提交历史

一个任务一个提交，复选框从 改成 [x] 与代码在吞并个提交里。考证的大喊与推行输出摘录写进 commit message，不写进文档。要看某个任务若何验的，跑 git log –grep。

景况行随着任务提交走：第一个鼓动任务的提交改成「履行中」，终末一个任务的提交改成「已完成」，不留到之后另补。

于是景况的真源酿成了「复选框 + git log」两样东西，都不错被机器读，都不错被第三方复核。面板不再参与判断。

代价是失去一张顺眼的进程图。收益是两句话都开辟：任何一句「作念完毕」都能被一条提交反驳或证实；漏掉哪个功能点，把任务与需求编号对一遍就披露来。

3.7 第六步：机器门槛只查结构

spec-lint.py 挂在 pre-commit 上，只查六样：任务行方式、景况惟有三种、有任务节、每个顶层任务写了考证、批准后才调鼓动任务、需求与任务的回首是否闭合。

其余一概不查。原理写在规范里：方式对不等于内容对。能自动判的惟有结构，内容判据只可靠东说念主。

这条克制来自反面阅历。阿谁连气儿四次静默失效的钩子，申饬不仅仅「护栏要考证」，还有第二层：修完之后跑存量，无数 spec 欠亨过，其时抽查两类欢快就了案为「都是历史方式，非剧本误判」——阿谁论断自身是误判。逐个复现后，57 个红里有 24 个是剧本我方的过错。这教练出了「lint 红了无须管」的民俗，比不装护栏更糟。

是以当今的判据里有一条自我料理：给任何兜底记功之前，先构造一个它应该拦住的输入，看它拦不拦。拦不住的查验，不如不装。

3.8 第七步：完工冻结，与活文档分离

一份 spec 完工后，正文冻结。之后发现的问题在纪录节追加，不回头改正文；要转业为，开新 spec。

同期立一条规矩：「当今系统是什么样」去看代码和活文档，不看 spec。spec 是变更快照，它纪录的是「那一刻决定了什么」，不是「今天是什么样」。

存档按景况分两层：待完成/ 与 已完成/，主题目次下放若干套 spec。代码细心、migration、提交诠释援用 spec 时一律不带景况层旅途——这样搬家不会打断任何援用。

这几条合起来科罚一个诡秘的问题：要是 spec 既当历史又当近况，它势必在半年后运转撒谎，而读它的东说念主（东说念主或模子）无法差别哪一句过时了。分开之后，撒谎的契机从结构上灭绝了。

3.9 与 Kiro 的对照

3.10 代价

不讲代价的方法论是告白。

C 档的写稿资本可能跳跃写代码。一份完好 spec 要写需求、盘算、任务三份，再加左证登记与决策登记。变调越复杂，这个比例越丢脸。它换来的是不漏功能与可回首，但不是每件事都值得。

法则自身要珍贵。312 行会漂。规范里一经出现了「已知误报」「已知漏口」这样的章节——这不是严谨，是不得不承认的欠债。

法则越多，越可能只被读一半。我给的解法是分层：§1–§6 必作念，§7 是清单，§8 是参考。但分层只镌汰误读概率，不铲除它。

A 档依赖至意。不写文献意味着没东说念主查对你是否简直作念了调研。commit message 有方式，但拦不住恶浊。这是这套盘算里最脆的一环，我莫得更好的解法。

它是为「一个东说念主 + 多个 agent」盘算的。换成五个东说念主互助，景况真源、批准经过、存档法则都要重写。别平直搬。

四、小结

AI 读代码，读不出东说念主其时的盘算意图。代码纪录恶果，不纪录原因。一个 if 为什么在那儿，可能是三年前的合规要求；一个字段为什么允许为空，可能是上游某次事故的补丁。这些都进不了函数名。东说念主不错靠缅念念和共事补全，缅念念会过时，东说念主会走；AI 连缅念念都莫得，手里惟有代码。只让它读代码，它只可按「看起来合理」的相貌改——而合理与当初的意图无关。

是以珍贵一套文档系统，是 AI 写代码不走偏的前提，不是额外包袱。需求、盘算、任务三份各修起一个不可替代的问题：要什么、若何作念、作念到哪算完。缺一份，AI 就有一半的输入靠猜。而写进文档还不够——不读，等于莫得。这亦然为什么「先读旧 spec 再脱手」被写成了调研的第一步。

强制力必须落在机器上。这是六个月里最贵的一课。法则写进文档，靠自愿履行；法则写进 pre-commit，才靠机器履行。而机器也会骗你——是以每装一皆护栏，都要先构造一个它应该拦住的输入。

这一代的开辟相貌，底座是 Spec：不是文档洁癖，是把东说念主类的盘算意图外置成 AI 可读、可查、可追的东西。器具会换，这份外置的意图不成莫得。

下一篇写居品自身：从零到一若何选型、若何定名堂规范、若何让文档活起来而不是烂掉。

专栏作者

臻龙，东说念主东说念主都是居品专栏作者，全面发展型居品司理，心爱表露激情学与神经科学，罕见钟爱商榷空洞算法问题，接待撕逼同样。

本文为作者独家发布于东说念主东说念主都是居品司理。未经本站许可，谢绝转载。谢谢合作。

题图来自unsplash体育游戏app平台，基于CC0契约