🌑 进入黑暗：Soulbound Codex

Source: Dev.to

背景

Kiroween 是 AWS 举办的万圣节主题黑客马拉松，旨在展示 Kiro——他们的 AI 编码代理的强大功能。挑战是 在一个月内构建出既宏大又富有创意的作品。

对我而言，这是一场未知的冒险：第一次将 AI、哥特美学、多模块 UI 架构和高级代理工作流混合在一起。最终产物是 Soulbound Codex，一个完整的生产力套件，被打造成一个阴森、沉浸式的体验。

我构建的：Soulbound Codex

Kiroween 是一个暗黑风格的生产力平台，包含：

• ✍️ Ghost Writer – 实时 AI 写作建议
• 📖 Necronomicon Notes – 在古老的、会动的卷轴中书写
• ⚰️ Graveyard Dashboard – 任务化作墓碑，带有物理和仪式动画
• 🔮 Terminal Tarot – 分析你的 git 提交并生成塔罗牌解读
• 🌕 Moon Phase Calendar – 以天文精度追踪时间
• 🕸️ Ambient soundscapes 与哥特 UI 共同营造氛围感和魔法体验

所有功能均由以下技术驱动：

React, TypeScript, Vite, CSS Modules, Firebase, OpenRouter AI, and Kiro’s spec‑driven development workflow.

技术成就

• 完整的多模块 React 架构，支持共享状态和离线优先设计
• 由 NVIDIA Nemotron + OpenRouter 兜底提供的 AI 写作助手
• 使用 isomorphic-git 在浏览器中直接进行 Git‑based 占卜引擎
• 通过 Firebase 实现云同步（认证、数据库、存储）
• 自定义哥特动画、粒子特效和羊皮纸渲染
• 为高级用户提供键盘驱动的导航
• 支持即时切换的主题引擎
• 笔记与任务的导入/导出系统
• 在所有模块中层叠的可访问性增强

这不仅仅是一个主题 UI——它是一个真正的生产力平台。

Kiro 的帮助

Kiro 充当的是开发伙伴，而不仅仅是工具。

规范驱动开发

• 所有需求、UX 行为和架构模式都写在 .kiro/specs 中。
• Kiro 将这些规范转换为干净、模块化的代码，无需返工或产生歧义。

Steering Docs

• 控制视觉风格一致性、AI 响应语气、编码约定和架构边界。

Agent Hooks

• 自动化工作流，例如：
  • Ghost Writer 中的上下文提取
  • 自动生成测试桩
  • 句子补全触发器
  • Terminal Tarot 的分析管线

新增 Kiro 功能

• 基于属性的测试，验证功能规范与实现的一致性
• Checkpoints 机制，随时回滚 Kiro 的代码更改
• Kiro CLI，可在终端内部运行自定义代理
• 团队协作工作流，集中管理规范 + steering

如果没有 Kiro，构建 Kiroween 将需要数月时间，而不是数周。

我遇到的障碍

• ⏳ 时间压力 – 在工作、生活和庞大的多模块项目之间切换；有些夜晚只能抽出 30–60 分钟编码。
• 🧩 复杂的功能交互 – 笔记、任务、AI 建议、塔罗阅读都需要共享全局状态、跨模块导航、离线持久化以及高性能。
• 👻 UI 精准度 – 鬼魂动画、羊皮纸效果、月相都需要细致调校。
• 🔌 AI 集成的不确定性 – 不同模型表现各异；缓存、重试和兜底必须手动实现。
• 🌐 浏览器中的 Git 分析 – 在本地解析提交而不依赖服务器极具挑战。

每一个障碍都推动了项目的前进。

开发时间线（精简版）

第 1–3 天：基础搭建

• 核心 React 架构、导航、主题引擎、笔记脚手架、任务系统原型

第 4–6 天：功能扩展

• Ghost Writer AI 集成、Graveyard Dashboard 动画、Moon Phase 日历、Markdown 编辑器

第 7–10 天：高级系统

• Git 提交分析引擎、塔罗生成逻辑、AI 缓存 + 兜底、云同步、身份验证

第 11–14 天：打磨与稳定

• 粒子特效、键盘快捷键、导入/导出、可访问性、最终 bug 排查、文档编写

最终，Kiroween 拥有 4 个完整模块、数十项功能、测试以及统一的用户体验。

我的收获

• 💡 AI‑辅助开发是一种新范式 – AI 放大了开发者的能力，把数周的样板代码压缩成几分钟。
• 🧠 规范比以往更重要 – 明确的规范 = 完美的代码生成；模糊的规范 = 混乱。
• ⚙️ 离线优先架构被低估 – 先为离线设计，再同步，一切变得更稳健。
• 🎨 美学具备功能力量 – 美观的生产力工具能让用户停留更久。
• 🪦 仪式感胜过例行公事 – 任务“沉入地下”的动画提供了复选框无法带来的情感闭环。

最后感想

构建 Kiroween 像是手持灯笼在黑暗森林中前行——每一步都被 Kiro 照亮，却始终充满未知。它让我学会了：

• 如何用 AI 快速构建复杂软件
• 设计如何影响用户情感
• 在压力下如何规划、组织并交付产品

最重要的是，Kiroween 证明了生产力工具不必枯燥；它们可以充满氛围、魔法且极具个人色彩。如果你想要一款把日常任务变成仪式的工具，Kiroween 正是为你而生。