每个黑客松的结尾都长得差不多:一墙没做完的任务,和一个像最终Boss一样压过来的截止日期。所以参加Kiroween 2026时,开发者干脆把自己正在经历的处境做成了游戏——Deadline Dungeon,把项目计划变成一座地牢:里程碑是房间,任务是怪物,截止日期本身就是Boss。
![]()
Boss的血量,等于你所有剩余工作量的总和。打它的方式只有一个:专注计时器。专注一分钟,造成一点伤害。游戏好不好玩是一回事,这篇记录讲的是它怎么被造出来的——全程在Kiro里规格先行,证据链提交在仓库的/.kiro目录下。其中还包括开发环境在黑客松中途倒下、整个项目被迫搬到悉尼一台服务器上的那段。
第零步:先写规格,再写代码
Kiro的规格工作流给每个功能配三份文档:requirements.md、design.md、tasks.md。这个项目立了一条规矩:游戏层的代码,没有规格就不许写。Deadline Dungeon有四个功能,仓库里就躺着四套规格三件套:
- dungeon-creation——用项目名、截止日期、里程碑和任务锻造出一座地牢
- focus-combat——计时器、伤害、经验值、等级和连击
- boss-settlement——Boss血条、胜利与失败、截止日期延期
- report-card——可分享的1200×630战绩卡和徽章墙
实现过程按任务清单逐条推进。听起来很官僚,直到你中途离开再回来,任务文件直接告诉你上次停在哪一步。黑客松期间,"我刚才做到哪了"本身就是一个Boss。
规则写进仓库,不写进聊天框
这个项目教给他最有用的一个习惯:一条规则如果重要,就写进steering文档,而不是发在聊天消息里。聊天记录会滚走,steering文档每次会话都会被加载。
两份steering文件管着整个项目。tech-rules.md定下工程契约:所有游戏逻辑写成src/game/下的纯函数,只用localStorage,不做后端,组件保持小。product-rules.md锁死游戏数值,标题栏写着一句他承认自己写得很得意的话——"游戏平衡(除非平衡代理提议且人类批准,否则锁定)"。
下面这些数字定义了整个游戏:怪物血量以专注分钟存储(预估小时数×60),专注一分钟等于一点伤害,等级曲线是50×n×(n−1)/2的累计经验值。还有一条整个设计都挂在上面的不变量:Boss血量永远是推导出来的(所有怪物血量之和),绝不单独存储。
这一行就是Boss永远不会对你撒谎的原因。没有一个会漂移失步的Boss血量变量,只有剩下的工作。
steering还真的抓到了一个bug。打磨阶段对照product-rules.md做审查时,发现战斗代码只在击杀时给经验值。而steering文档写的是:经验值等于实际造成的伤害,溢出伤害截断。代码错了,文档对了,修复连同四条钉死这条规则的新测试,在同一次会话里就上线了。规格不是事后补的文档,运气好的时候,它是裁判。
钩子与性质测试:信任,但自动验证
/.kiro/hooks下的两个代理钩子,会在游戏文件保存时重跑逻辑测试和类型检查。它们很无聊,这正是重点:一条被破坏的不变量应该在几秒内失败,而不是在演示时失败。
游戏数值用性质测试(fast-check)验证,而不只是举例测试。真正重要的性质有四条:
- 伤害永远不会让血量变成负数
- 经验值守恒:你拿到的正好是你造成的伤害,绝不含溢出部分
- 在随机的攻击序列下,Boss血量始终等于剩余怪物血量之和
- 同一个徽章不会被授予两次
测试套件最终有29个测试,全部通过。举例测试检查你想得到的用例,性质测试检查你想不到的——在一个每个数字都由其他数字推导出来的游戏里,后者的价值对得起成本。
工具链搬去悉尼的那一夜
黑客松进行到一半,他本地的Kiro CLI出了个非常具体的故障:能读,但写操作不断因连接重置而中断。第一阶段和第二阶段逻辑层已经提交,可一个每三次文件写入就丢一次的工具链,没法继续往下建。
于是项目移民了。他把仓库克隆到悉尼一台小型ARM云实例上,在那里装好Kiro CLI、登录,把剩下的所有阶段都在这台机器上跑完——第二阶段UI、第三阶段专注战斗、第四阶段Boss结算,以及两轮打磨。每次改动都拉回本地,在推送前重新验证(类型检查、测试、生产构建)。
让这件事从恐怖变成无痛的关键在于:规格和steering文档都在仓库里。新环境不需要他的聊天记录、记忆或意图,它需要的是/.kiro,而/.kiro是完整的。规格驱动开发通常被当作质量实践来推销,那一夜,它变成了灾难恢复实践。
该随性的地方就随性
并非所有东西都是规格驱动的,这是有意为之。主题CSS、布局草图,以及"恐怖可爱"的美术方向——一个套在生产力工具外面的南瓜与幽灵装扮,毕竟这是场变装比赛——都是在对话里随性写出来的。这个分工本身就是重点:游戏的规则是契约,游戏的样子是对话。Kiro两种模式都能应付,但只有其中一种配了steering文档和性质测试。
演示视频里的地牢,是用真实的提交计划锻造出来的:房间对应构思与搭建、开发、发布;怪物对应核心功能、打磨、演示准备和提交本身。打败Boss,意味着把游戏发出去。视频里那张胜利战绩卡是真的——Deadline Dungeon于11月21日提交到Kiroween 2026,比截止日期早了十二天。某个地方,有个Boss还在为这事不爽。
如果要从这次开发里带走一件事,那就是steering习惯:把规则写在代理每次会话都会读到的地方。未来的你——可能正坐在另一个大洲的服务器上——会感谢现在的你。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.