一条记录要记哪几项:用「最小字段表」把第一版定下来
编号:XT-MG-20261116-01
摘要:第一版返工,很多时候不是按钮位置不对,而是「一条记录里到底记了什么」没定下来。本文给出四格最小字段表和三句自检,帮你在写需求之前把每条记录的内容想清楚。
目标人群:准备做记录、清单、登记一类小工具的非技术个人与小团队。
核心问题:只写了「做个记录工具」,做出来的第一版要么缺了关键项,要么多出一堆每次都填不完的空,想改又说不清该改哪一处。
先定一条记录,再定页面
页面是给人看的,记录是留着以后查的。第一次打开时看不看得懂,靠的是页面;过两周再回来还认不认得这条,靠的是记录本身。所以第一版值得先回答一个小问题:每记一条,最少要留下哪几项,下次打开才不会看不懂。
星图工坊官网公告《提交需求前,先给自己的应用写一条「完成标准」》(2026-11-14,查看公告原文)建议先写一句「做完之后,我能用它做成哪件事」。这句话定的是目标;下面这张表定的是达到目标所需的最小信息量。两者不冲突,先写前者再填后者,通常更省事。
四格最小字段表
拿一张纸画四格,每格只写字段名字,不写格式、不写颜色:
| 格子 | 要回答的问题 | 阅读记录的例子 |
|---|---|---|
| 区分项 | 两条内容差不多的记录,靠什么分开 | 书名 |
| 状态项 | 它现在到哪一步了 | 在读/已读 |
| 时间项 | 这件事是什么时候记下的 | 记下的日期 |
| 备注项 | 有什么当时才知道、以后会忘的 | 一句话备注,可以留空 |
四格之外,还有一条同样重要的取舍:第一版先不要加「谁改的」「给谁看」「合计多少」这几类。它们要等主流程能从头走通以后才有意义。官网公告《第一次做应用,从一份行李清单开始》(2026-11-01,查看公告原文)把「攻略、账单、路线先记下来,等清单用顺了再考虑」当作同一类处理,可以照着做。
三句自检
四格填完,对着自己举的两件真事各问三句:
- 能不能区分两条一样的记录? 如果两本书同名,只写书名就会混,那就再留一项能区分的写法,比如把作者一起写进书名那一栏。
- 只看这一条、不看页面,能不能说出它到哪一步? 状态项只留两种取值,比留五六种更容易前后一致。
- 过一个月再打开,备注还看得懂吗? 缩写、只有自己懂的代号,第一版先换成完整的一句话。
三句都答得上来,就可以把四格写成一段需求;答不上来的那一格,先补上再动笔。
把四格写成一段话
不用写成规格文档,一段话够用:
每条阅读记录写清楚:书名、在读还是已读、哪天记的,备注可以留空。首页能看到还在读的那几本。
官网公告《应用改到一半,怎样把需求说清楚》(2026-11-01,查看公告原文)建议把「在哪儿、现在怎样、想改成怎样」一起说出来。写第一版时也是同一个道理:把「每条记录有哪几项」和「首页看什么」分开写,后面要改哪一处就有明确落点。
操作步骤
- 画四格,只写字段名字。
- 用两件近期真会发生的事填进去,其中特意让一个字段取值相同,检验能不能区分。
- 划掉「有也行、没有也不影响这次使用」的字段,第一版只留划不掉的。
- 把剩下的写成上面那段话,放进第一段需求。
- 第一版出来后,用同样的两件事各记一条,重新打开,确认四格都在、状态词只有两种。
适用条件
- 你准备做记录、清单、登记一类的小工具,第一段需求还没写。
- 你能举出两件近期真会用到的事,用来试填字段。
- 本文只覆盖「每条记录记什么」这一层,不涉及页面布局、访问权限与多人协作。
限制说明
- 本文是一份字段梳理方法,不是星图工坊的功能清单,也不说明任何字段类型、校验规则或存储方式;实际页面上能填什么,以你打开的页面为准。
- 文中的阅读记录、书名与字段取值都是方法示例,不是任何真实用户的案例或使用成果,不含真实姓名、账号等个人信息。
- 本文不描述后台实现,不对数据保存期限、跨设备一致性作推断或承诺。
常见问题
问:字段是不是列得越全越好?
答:第一版不是。每多一项,就多一次要填、要多核对一次的空。判断标准很简单:没有它,你这次要做的事还做得成吗?做得成就先划掉。
问:状态想写三种以上,可以吗?
答:可以,但先确认三种取值之间有没有明确边界。边界说不清时,两种取值加一句备注,比三个含糊的状态更容易前后一致。
问:已经做了一版,才发现少记了一项,怎么办?
答:把「现在每条记了什么、要补哪一项、原来的要不要保留」一起写清楚再改,不要只发一句「加个日期」。官网公告《改到一半方向变了:把旧要求作废,比继续追加更省事》(2026-11-15,查看公告原文)讲的正是这个顺序。
相关官网链接
署名:星图工坊
更新日期:2026-11-16