用 Kiro 先写规格,再把任务做成地牢游戏
作者将里程碑、任务和截止日期转化为地牢游戏机制,并使用 Kiro 按规格驱动开发。仓库的 /.kiro 目录保留需求、设计与任务文档,文章还记录了开发环境故障后的迁移经历。
AI 深度解读
把里程碑做成房间,把任务做成怪物,再用专注时间攻击截止日期,Deadline Dungeon 把项目管理变成了一款地牢游戏。但作者这次最有参考价值的实践,是用 Kiro 把需求、设计、任务和工程规则留在仓库里,让 AI 编程有据可依。
这套做法既抓到过实际的积分错误,也帮助项目在本地工具链故障后迁往悉尼服务器继续开发。它展示了规格驱动开发的两个用途:约束业务逻辑,以及保存换环境后仍能接续的工作上下文。不过,这仍是一个黑客松项目的经验,不能直接当成效率提升的证明。
游戏数值为什么适合先写规格
Deadline Dungeon 参加了 Kiroween 2026 黑客松的 Costume Contest。它的玩法很直观:项目计划生成地牢,里程碑对应房间,任务对应怪物,截止日期对应 Boss。专注计时器就是武器,每专注 1 分钟造成 1 点伤害。

这种设计看起来轻巧,数值之间却有明确的依赖关系。任务预计耗时要变成怪物生命值,攻击要同时影响生命值和经验值,剩余工作量还要反映到 Boss 身上。任何一处各算各的,都可能出现界面显示与实际进度不一致。
作者因此给游戏层定了规则:实现必须来自规格。Kiro 为每个功能维护 requirements.md、design.md 和 tasks.md,分别记录需求、设计和实施任务。项目共拆成四组:
dungeon-creation:根据项目名、截止日期、里程碑和任务创建地牢。focus-combat:处理计时、伤害、XP、等级和连续专注记录。boss-settlement:处理 Boss 血条、胜负和延期。report-card:生成可分享的 1200×630 成绩卡,并展示徽章架。
实现按任务列表逐项推进。它的直接价值是让下一次开发能找到停点,也让功能边界有地方可查。作者没有给出编写这些文档的耗时,所以还不能判断这笔投入在不同规模项目里多久能收回。
规则进仓库,才有办法检查代码是否跑偏
功能规格之外,作者还用了两份 steering 文档。可以把它们理解为每次会话都会加载的项目规则,用来承接那些不能只靠聊天记住的约束。
tech-rules.md 规定:游戏逻辑放在 src/game/,写成纯函数;持久化只用 localStorage;不设后端;组件保持小巧。纯函数让计算结果主要取决于输入,测试时不用先启动整套界面。
product-rules.md 则锁定游戏数学:
- 怪物 HP 以专注分钟保存,计算方式是预计小时数 × 60。
- 每专注 1 分钟,造成 1 点伤害。
- 等级对应的累计 XP 为
50 × n × (n−1) / 2。 - Boss HP 始终等于所有怪物的剩余 HP 之和,不单独存储。
能从已有状态算出来的关键数值,尽量不要再维护第二份。
这里最值得借鉴的是 Boss HP。它只是剩余任务量的另一种展示,单独保存就多了一处需要同步的状态。直接求和,能从数据结构上减少失配机会。
文档也确实抓到过错误。打磨阶段的检查发现,战斗代码只在击杀怪物时发放 XP,而产品规则要求 XP 等于实际造成的伤害,超出剩余 HP 的部分不计入。作者修复了实现,并补上 4 个测试。
但文档不会自己变成裁判。真正起作用的是把代码拿来与规则核对,再把发现的偏差固定成测试。原文还规定,平衡数值的修改需要 balance agent 提议并由人批准;它没有进一步解释这个 agent 的具体工作方式。
自动验证守住计算,视觉探索留给对话
作者在 /.kiro/hooks 放了两个 agent hooks,游戏文件保存后重新运行逻辑测试和类型检查。目的很具体:让规则被破坏时尽早报错。
测试使用了 fast-check 做属性测试(property-based testing)。普通用例列出几个输入和预期结果;属性测试先声明始终成立的关系,再用随机数据和操作序列寻找反例。项目检查了四条:
- 伤害不会让 HP 变成负数。
- XP 恰好等于实际伤害,不包含溢出伤害。
- 随机攻击序列之后,Boss HP 仍等于全部怪物的剩余 HP 总和。
- 同一枚徽章不会重复发放。
最终测试套件有 29 个测试,全部通过。这个结果说明已有检查通过了,并不能据此推断所有交互、计时行为和持久化边界都已经覆盖;原文没有交代完整覆盖范围。

这些仓库文件还在迁移时派上了用场。黑客松中途,本地 Kiro CLI 能读取文件,但写操作不断遇到连接重置。当时 Stage 1 和 Stage 2 逻辑层已经提交,作者于是将仓库克隆到悉尼的一台小型 ARM 云实例,安装 Kiro CLI 并登录。
后续 Stage 2 UI、Stage 3 专注战斗、Stage 4 Boss 结算及两轮打磨,都在那里完成。每批改动拉回本机后,作者重新执行类型检查、测试和生产构建,通过后才推送。新环境能继续工作,关键是规格与 steering 文档已经随仓库保存,不必重新拼接聊天记录。
作者也没有把所有工作塞进规格流程。主题 CSS、布局草图,以及南瓜和幽灵构成的可爱惊悚风格,仍通过对话探索。需要严格计算的部分有规则和测试,视觉表达则保留调整空间。
演示地牢直接采用真实提交计划,房间包括 Idea & Setup、Build 和 Ship,怪物对应核心功能、打磨、演示准备和提交。作者称项目于 11 月 21 日提交 Kiroween 2026,比截止日期提前 12 天。

我的判断
我赞成优先把业务规则写进仓库,尤其是那些一句话说得清、实现却容易偏离的关系。XP 等于实际伤害、Boss HP 等于剩余任务总量,都能直接变成可执行的检查,比泛泛要求 AI「保证正确」更有用。
但规格优先是否更快,作者没有提供对照数据。提前 12 天提交,也不能单独归因于 Kiro 或文档流程。迁移成功是一次实际经历,却还不足以证明任意项目都能只靠 /.kiro 恢复:这个项目没有后端,数据只落在 localStorage,环境依赖相对集中。
对一般团队,我更倾向于先保存关键约束,再按复杂度补充设计和任务文档。简单改动未必需要完整的三件套;涉及多个状态共同变化的功能,则很适合先写清不变量。与只在聊天里反复提醒相比,仓库规则更容易复用和审查,但它仍需要人维护,测试也只能验证已经表达出来的要求。
能拿来做什么
- 在日常 AI 编程项目中,把目录约束、数据来源和不可变业务关系写成仓库文件,并明确如何让工具在会话中读取;不要默认文件存在就会自动生效。
- 开发前端进度、积分或任务界面时,先检查哪些展示值能由已有数据推导,减少重复存储,并把核心计算从组件中提取出来。
- 对伤害扣减、积分累计、去重发放这类纯计算规则,先写少量具体用例,再考虑用
fast-check检查随机操作序列中的不变量。 - 切换开发机器或远程环境前,提交规格、任务进度和规则文件;接回改动后重新执行类型检查、测试与生产构建,让上下文迁移和结果验证一起完成。