用标准叫法写一张需求卡

第 6 课 · 共 6 课 约 7 分钟

数据、动作、Loop、应用、权限、完成的样子:六格写清,开发者和智能体都能照着做。

本课目标

读完这一课,你将能够

  • 用标准叫法写出一张六格需求卡
  • 把需求卡交给开发者或智能体来做,并照它验收
  • 说出学完这门课之后的下一步

好的需求,先把名词说对

业务部门提需求,最常见的是一句话:「做个生产看板,能看进度,有问题能及时处理,最好能自动提醒。」看哪些数、处理是改什么、谁能改、什么时候提醒,这句话都没说清,做的人只能猜。

用标准叫法重写,就是把一句话拆成几格,每一格回答一个问题:

随口一问

做个生产看板,能看进度,有问题能及时处理,最好能自动提醒。

好的交代

数据:工单(计划数、合格数、缺料数)与产线。动作:登记异常(原因、严重程度),班组长以上可以做。Loop:缺料数一变大就提醒采购,同一张工单 12 小时内只提醒一次。应用:班组长看本线工单并登记异常,厂长只读。

需求卡的六格

  1. 数据

    读哪些对象、哪几个属性,它们从哪个数据源来。

  2. 动作

    要改什么:参数、改哪些属性、哪些角色能做。

  3. Loop

    有没有要自己反复发生的事:什么触发、做什么、交付给谁。

  4. 应用

    谁来看、看哪些数,页面上放哪几个按钮。

  5. 权限

    谁能打开应用,要不要分享给公司外的人,要不要只读的公开链接。

  6. 完成的样子

    怎样算做好了,例如「班组长不用再去 ERP 登记异常」。

六格不用一次写满。先写数据和完成的样子,其余几格可以和开发者一起补;但交出去之前,每一格都要有答案,哪怕答案是「无」。

交给谁来做

需求卡写好,可以交给两种人。一种是开发者:在 Developer 里建应用、接语义层、写动作和工作流,测好再发布。另一种是智能体:把 Developer 的上手说明交给它,它会装好命令行、登录,再照需求卡做出第一个版本。

https://ai-dc.ai/developer/agent-ready.md

交回来的第一个版本,对照需求卡逐格看:读的数据对不对,动作的角色对不对,Loop 是不是数据变化优先,按钮是不是只有该有的那几个。

不管谁来做,都先在 test 通道预览,用最后一格「完成的样子」来验收,通过了再发布到 Nexus。发布之后,用的人在应用里提的意见会被记下来,成为下一个版本的依据。

下一步

到这里,你已经有了一套说得清楚的词:数据、智能体、应用,以及 API、CLI、程序与界面。接下来,按你要做的事选:

  • 想动手做应用:学「用 AIDC Developer 做应用」,从装好 aidc 到发布第一个应用。
  • 想把部门的事连起来:学「从场景到价值链」,把 Loop 和应用挂到同一条链上。
  • 想查某个词:打开概念词典,每个词都有一句话定义。

要点

  • 好的需求先把名词说对:数据、动作、Loop、应用、权限、完成的样子。
  • 「谁能改」写在动作里,「谁能打开」写在权限里。
  • 需求卡交给开发者或智能体都能照着做,也能照着验收。
  • 先在 test 通道预览,用「完成的样子」验收,通过了再发布到 Nexus。

练一练

写你的第一张需求卡

从上一课找到的那份报告开始。

从看完还要手工处理的报告里挑一份,最好是每周都会遇到的。

小测

选一个答案,马上看解析。

Q1需求里写着「班组长以上可以登记异常」,应该放在哪一格?

Q2把「最好能自动提醒」写成 Loop,至少要说清什么?

Q3智能体照需求卡做出第一个版本之后,怎么验收?

延伸阅读