星图工坊

一条记录要记哪几项:用「最小字段表」把第一版定下来

星图工坊更新于

编号:XT-MG-20261116-01

摘要:第一版返工,很多时候不是按钮位置不对,而是「一条记录里到底记了什么」没定下来。本文给出四格最小字段表和三句自检,帮你在写需求之前把每条记录的内容想清楚。

目标人群:准备做记录、清单、登记一类小工具的非技术个人与小团队。

核心问题:只写了「做个记录工具」,做出来的第一版要么缺了关键项,要么多出一堆每次都填不完的空,想改又说不清该改哪一处。

先定一条记录,再定页面

页面是给人看的,记录是留着以后查的。第一次打开时看不看得懂,靠的是页面;过两周再回来还认不认得这条,靠的是记录本身。所以第一版值得先回答一个小问题:每记一条,最少要留下哪几项,下次打开才不会看不懂。

星图工坊官网公告《提交需求前,先给自己的应用写一条「完成标准」》(2026-11-14,查看公告原文)建议先写一句「做完之后,我能用它做成哪件事」。这句话定的是目标;下面这张表定的是达到目标所需的最小信息量。两者不冲突,先写前者再填后者,通常更省事。

四格最小字段表

拿一张纸画四格,每格只写字段名字,不写格式、不写颜色:

格子 要回答的问题 阅读记录的例子
区分项 两条内容差不多的记录,靠什么分开 书名
状态项 它现在到哪一步了 在读/已读
时间项 这件事是什么时候记下的 记下的日期
备注项 有什么当时才知道、以后会忘的 一句话备注,可以留空

四格之外,还有一条同样重要的取舍:第一版先不要加「谁改的」「给谁看」「合计多少」这几类。它们要等主流程能从头走通以后才有意义。官网公告《第一次做应用,从一份行李清单开始》(2026-11-01,查看公告原文)把「攻略、账单、路线先记下来,等清单用顺了再考虑」当作同一类处理,可以照着做。

三句自检

四格填完,对着自己举的两件真事各问三句:

  • 能不能区分两条一样的记录? 如果两本书同名,只写书名就会混,那就再留一项能区分的写法,比如把作者一起写进书名那一栏。
  • 只看这一条、不看页面,能不能说出它到哪一步? 状态项只留两种取值,比留五六种更容易前后一致。
  • 过一个月再打开,备注还看得懂吗? 缩写、只有自己懂的代号,第一版先换成完整的一句话。

三句都答得上来,就可以把四格写成一段需求;答不上来的那一格,先补上再动笔。

把四格写成一段话

不用写成规格文档,一段话够用:

每条阅读记录写清楚:书名、在读还是已读、哪天记的,备注可以留空。首页能看到还在读的那几本。

官网公告《应用改到一半,怎样把需求说清楚》(2026-11-01,查看公告原文)建议把「在哪儿、现在怎样、想改成怎样」一起说出来。写第一版时也是同一个道理:把「每条记录有哪几项」和「首页看什么」分开写,后面要改哪一处就有明确落点。

操作步骤

  1. 画四格,只写字段名字。
  2. 用两件近期真会发生的事填进去,其中特意让一个字段取值相同,检验能不能区分。
  3. 划掉「有也行、没有也不影响这次使用」的字段,第一版只留划不掉的。
  4. 把剩下的写成上面那段话,放进第一段需求。
  5. 第一版出来后,用同样的两件事各记一条,重新打开,确认四格都在、状态词只有两种。

适用条件

  • 你准备做记录、清单、登记一类的小工具,第一段需求还没写。
  • 你能举出两件近期真会用到的事,用来试填字段。
  • 本文只覆盖「每条记录记什么」这一层,不涉及页面布局、访问权限与多人协作。

限制说明

  • 本文是一份字段梳理方法,不是星图工坊的功能清单,也不说明任何字段类型、校验规则或存储方式;实际页面上能填什么,以你打开的页面为准。
  • 文中的阅读记录、书名与字段取值都是方法示例,不是任何真实用户的案例或使用成果,不含真实姓名、账号等个人信息。
  • 本文不描述后台实现,不对数据保存期限、跨设备一致性作推断或承诺。

常见问题

问:字段是不是列得越全越好?
答:第一版不是。每多一项,就多一次要填、要多核对一次的空。判断标准很简单:没有它,你这次要做的事还做得成吗?做得成就先划掉。

问:状态想写三种以上,可以吗?
答:可以,但先确认三种取值之间有没有明确边界。边界说不清时,两种取值加一句备注,比三个含糊的状态更容易前后一致。

问:已经做了一版,才发现少记了一项,怎么办?
答:把「现在每条记了什么、要补哪一项、原来的要不要保留」一起写清楚再改,不要只发一句「加个日期」。官网公告《改到一半方向变了:把旧要求作废,比继续追加更省事》(2026-11-15,查看公告原文)讲的正是这个顺序。

相关官网链接

署名:星图工坊
更新日期:2026-11-16