用标准叫法写一张需求卡
数据、动作、Loop、应用、权限、完成的样子:六格写清,开发者和智能体都能照着做。

本课目标
读完这一课,你将能够
- 用标准叫法写出一张六格需求卡
- 把需求卡交给开发者或智能体来做,并照它验收
- 说出学完这门课之后的下一步
好的需求,先把名词说对
业务部门提需求,最常见的是一句话:「做个生产看板,能看进度,有问题能及时处理,最好能自动提醒。」看哪些数、处理是改什么、谁能改、什么时候提醒,这句话都没说清,做的人只能猜。
用标准叫法重写,就是把一句话拆成几格,每一格回答一个问题:
做个生产看板,能看进度,有问题能及时处理,最好能自动提醒。
数据:工单(计划数、合格数、缺料数)与产线。动作:登记异常(原因、严重程度),班组长以上可以做。Loop:缺料数一变大就提醒采购,同一张工单 12 小时内只提醒一次。应用:班组长看本线工单并登记异常,厂长只读。
需求卡的六格
- 数据
读哪些对象、哪几个属性,它们从哪个数据源来。
- 动作
要改什么:参数、改哪些属性、哪些角色能做。
- Loop
有没有要自己反复发生的事:什么触发、做什么、交付给谁。
- 应用
谁来看、看哪些数,页面上放哪几个按钮。
- 权限
谁能打开应用,要不要分享给公司外的人,要不要只读的公开链接。
- 完成的样子
怎样算做好了,例如「班组长不用再去 ERP 登记异常」。
六格不用一次写满。先写数据和完成的样子,其余几格可以和开发者一起补;但交出去之前,每一格都要有答案,哪怕答案是「无」。
交给谁来做
需求卡写好,可以交给两种人。一种是开发者:在 Developer 里建应用、接语义层、写动作和工作流,测好再发布。另一种是智能体:把 Developer 的上手说明交给它,它会装好命令行、登录,再照需求卡做出第一个版本。
https://ai-dc.ai/developer/agent-ready.md
交回来的第一个版本,对照需求卡逐格看:读的数据对不对,动作的角色对不对,Loop 是不是数据变化优先,按钮是不是只有该有的那几个。
不管谁来做,都先在 test 通道预览,用最后一格「完成的样子」来验收,通过了再发布到 Nexus。发布之后,用的人在应用里提的意见会被记下来,成为下一个版本的依据。
下一步
到这里,你已经有了一套说得清楚的词:数据、智能体、应用,以及 API、CLI、程序与界面。接下来,按你要做的事选:
- 想动手做应用:学「用 AIDC Developer 做应用」,从装好 aidc 到发布第一个应用。
- 想把部门的事连起来:学「从场景到价值链」,把 Loop 和应用挂到同一条链上。
- 想查某个词:打开概念词典,每个词都有一句话定义。
要点
- 好的需求先把名词说对:数据、动作、Loop、应用、权限、完成的样子。
- 「谁能改」写在动作里,「谁能打开」写在权限里。
- 需求卡交给开发者或智能体都能照着做,也能照着验收。
- 先在 test 通道预览,用「完成的样子」验收,通过了再发布到 Nexus。
练一练
写你的第一张需求卡
从上一课找到的那份报告开始。
从看完还要手工处理的报告里挑一份,最好是每周都会遇到的。
按数据、动作、Loop、应用、权限、完成的样子填完,每格不超过三行;没有 Loop 就写「无」。
把需求卡交给一位没参与的同事或一个智能体,请对方复述要做什么;复述不出来的格子,重写。
小测
选一个答案,马上看解析。
Q1需求里写着「班组长以上可以登记异常」,应该放在哪一格?
谁能执行一次修改,写在动作里;权限一格管的是谁能打开应用、要不要分享。
Q2把「最好能自动提醒」写成 Loop,至少要说清什么?
每个 Loop 都有三个部分:触发、做事、交付。模型和样式是做的人再定的细节。
Q3智能体照需求卡做出第一个版本之后,怎么验收?
测过什么才发布什么:先在 test 通道预览,用需求卡最后一格验收,不看谁自报完成。