从苏州小学去年布置的 AI 做日历的作业到 AI 编程新境界： Kiro IDE 的 Spec Coding 实战记
缘起：一个看似简单的要求
去年，我的干女儿突然找到我，说：”爸爸，我需要用 AI 制作一个 2025 年的日历，每一页都要有花。”听起来很简单对吧？但作为一个程序员，我立刻意识到这是一个绝佳的机会来探索 AI 编程的新玩法。
既然要做，就做得彻底一点。我决定不仅仅是完成她的作业，而是要创造一个真正有价值的多语言学习日历网站，同时验证一下 Kiro IDE 的 Spec Coding 功能到底有多强大。
什么是 Spec Coding ？超越传统的 Vibe Coding
大多数人用 AI 编程都是”vibe coding”——想到什么就让 AI 写什么，没有系统性的规划。但 Kiro IDE 提供了一种全新的方法：Spec Coding。
Spec Coding 的三个阶段：
- 需求分析（ Requirements ）：用 EARS 模式写出严格的需求文档
- 设计文档（ Design ）：详细的架构设计和正确性属性定义
- 任务分解（ Tasks ）：可执行的编程任务清单
这种方法让 AI 不再是随意发挥，而是按照工程化的流程来开发软件。
项目演进：从简单日历到多语言学习平台
最初的想法
- 2026 年日历（改成 2026 年，因为 2025 年已经过去了）
- 每个月配一朵花
- 简单好看就行
最终的成果
- 🌸 多语言支持：葡萄牙语花名 + 英语 + 中文
- 🎯 语言学习功能：每日英语名言、中文文化知识
- 🏮 中国节日：2026 年完整的中国传统节日信息
- 📱 响应式设计：手机、平板、电脑完美适配
- ♿ 无障碍支持：键盘导航、屏幕阅读器支持
- 🧪 30+测试用例：确保代码质量
Kiro IDE 的 Spec Coding 实战
第一步：需求文档（ Requirements.md ）
Kiro 帮我用 EARS 模式写出了严格的需求：
### Requirement 1: Calendar Display
**User Story:** As a user, I want to view a complete 2026 calendar, so that I can see dates and plan my activities.
#### Acceptance Criteria
1. THE Calendar_System SHALL display all 12 months of 2026
2. WHEN a user navigates between months, THE Calendar_System SHALL show the correct dates for each month
3. THE Calendar_System SHALL highlight the current date when viewing the current month
每一条需求都有明确的验收标准，这样 AI 就知道要实现什么功能。
第二步：设计文档（ Design.md ）
Kiro 不仅设计了架构，还定义了正确性属性：
**Property 1: Calendar Month Generation**
*For any* month in 2026, the calendar system should generate a valid month grid with the correct number of days and proper date sequencing
**Validates: Requirements 1.1, 1.2**
**Property 5: Unique Monthly Flowers**
*For any* two different months, they should display different Portuguese flowers, ensuring all 12 months have unique flower assignments
**Validates: Requirements 2.1**
这些属性后来变成了自动化测试，确保代码的正确性。
第三步：任务分解（ Tasks.md ）
Kiro 把整个项目分解成了可执行的小任务：
- [ ] 1. Set up project structure and core calendar engine
- [ ] 1.1 Write property test for calendar month generation
- [ ] 2. Implement date display and highlighting features
- [ ] 2.1 Write property test for current date highlighting
每个任务都有明确的验收标准和测试要求。
技术亮点：不只是写代码，更是工程化思维
1. 属性驱动测试（ Property-Based Testing ）
传统的单元测试只测试几个例子，但 Kiro 帮我实现了属性驱动测试：
// 测试所有月份都有唯一的花
Property: Unique Monthly Flowers
*For any* two different months, they should display different Portuguese flowers
这种测试会生成大量随机输入来验证属性，比传统测试更可靠。
2. 多语言花卉数据
每个月的花都有三种语言的名称：
| 月份 | 葡萄牙语 | 英语 | 中文 |
|---|---|---|---|
| 1 月 | Camélia | Camellia | 山茶花 |
| 2 月 | Flor de Amendoeira | Almond Blossom | 杏花 |
| 6 月 | Alfazema | Lavender | 薰衣草 |
3. 中国文化元素
不仅有花，还加入了 2026 年的中国节日：
- 春节：2 月 17-25 日（火马年）
- 清明节：4 月 5-6 日
- 端午节：6 月 19 日
- 中秋节：9 月 25 日
- 国庆节：10 月 1-7 日
开发过程：AI 协作的新体验
传统 AI 编程 vs Spec Coding
传统方式：
- “帮我写个日历”
- AI 随便写一个
- 发现问题再修改
- 反复调试
Spec Coding 方式：
- 先写需求文档
- 再写设计文档
- 分解成小任务
- 逐个实现和测试
- 每一步都有验收标准
实际效果对比
使用 Spec Coding 后：
- ✅ 代码质量更高：有完整的测试覆盖
- ✅ 功能更完整：不会遗漏重要功能
- ✅ 维护性更好：有清晰的文档和架构
- ✅ 可扩展性强：模块化设计便于添加新功能
成果展示：超出预期的学习平台
在线体验
🌐 网站地址： https://mrfeixiang.github.io/2026/
核心功能
- 📅 完整 2026 年日历：精确的日期计算和导航
- 🌸 12 朵葡萄牙花卉：每月一朵，三语对照
- 📚 英语学习：每日名言、词汇解释、语法提示
- 🈳 中文学习：汉字显示、拼音标注、文化知识
- 🏮 节日信息：中国传统节日和文化解释
技术指标
- ⚡ 性能优化：日历生成<50ms
- 📱 响应式设计：支持所有设备
- ♿ 无障碍支持：WCAG 2.1 AA 标准
- 🧪 测试覆盖：30+自动化测试
反思：AI 编程的未来方向
Spec Coding 的优势
- 系统性思维：不再是想到哪写到哪，而是有完整的规划
- 质量保证：每个功能都有对应的测试
- 文档驱动：代码和文档同步，便于维护
- 可复现性：其他人可以按照 spec 继续开发
对 AI 编程的启示
传统的”vibe coding”适合快速原型，但要做出高质量的软件，还是需要工程化的方法。Kiro IDE 的 Spec Coding 提供了一个很好的框架：
- 需求先行：明确要做什么
- 设计驱动：规划怎么做
- 测试保证：确保做对了
结语：从作业到作品的升华
原本只是帮干女儿完成一个简单的作业，最终却创造了一个功能完整的多语言学习平台。这个过程让我深刻体会到了 Spec Coding 的威力。
Kiro IDE 不仅仅是一个 AI 编程工具，更是一个思维方式的转变。它教会我们用工程化的方法来思考问题，用系统性的方式来解决问题。
如果你也想尝试这种新的 AI 编程方式，我强烈推荐试试 Kiro IDE 的 Spec 功能。相信你会和我一样，发现 AI 编程的新境界。
项目链接：
- 🌐 在线体验： https://mrfeixiang.github.io/2026/
- 💻 源代码： https://github.com/mrfeixiang/2026
- 📋 完整测试报告： https://mrfeixiang.github.io/2026/final-test-report.html
技术栈：HTML5 + CSS3 + Vanilla JavaScript + Kiro IDE Spec Coding
用 AI 编程，但不止于 AI 编程。用工程思维，创造真正的价值。