AI Coding 最佳实践（二）：Intent 意图层

Intent 层的核心作用

Intent（意图层）回答两个根本问题：

Why：为什么要做这个项目？
For Whom：为谁而做？

这是整个项目的「北极星」，所有后续决策都要回到这里检验。

Intent 文档结构

# Intent - 意图层

## 1. 为什么做这个项目？
### 背景与动机
### 期望价值

## 2. 目标用户是谁？
### 主要用户
### 次要用户

## 3. 期望结果 / 验收标准
### 必须达成（Must Have）
### 期望达成（Should Have）
### 可选达成（Nice to Have）

## 4. 明确不做什么

各部分详解

1. 背景与动机

描述项目的起源和要解决的痛点：

### 背景与动机
- 需要一个简约、大气的个人博客平台
- 博客主要用于技术分享，也会有一些生活日常内容

写作要点：

用简洁的语言描述核心诉求
避免技术术语，专注于业务价值

2. 目标用户

明确用户画像和使用场景：

### 主要用户：发布者（博客作者）
- 角色：博客内容创作者
- 核心需求：便捷地发布和管理博客内容
- 使用场景：通过编写 Markdown 文件来创作内容

### 次要用户：读者
- 角色：技术社区成员、普通访客
- 核心需求：获取有价值的技术内容
- 使用场景：通过搜索引擎或直接访问博客

写作要点：

区分主要用户和次要用户
描述具体的使用场景

3. 验收标准（MoSCoW 法则）

使用 MoSCoW 优先级划分：

### 必须达成（Must Have）
- [ ] 发布者能通过撰写 .md 文件发布内容
- [ ] 读者访问首页即可获取最新内容
- [ ] 高度 SEO 优化

### 期望达成（Should Have）
- [ ] 良好的阅读体验
- [ ] 响应式设计

### 可选达成（Nice to Have）
- [ ] 文章搜索功能
- [ ] RSS 订阅

写作要点：

用 checkbox 格式，方便追踪
Must Have 控制在 3-5 项
可量化的标准更好

4. 明确不做什么

这是最重要的部分之一！

## 4. 明确不做什么

- 不做用户登录/注册系统
- 不做评论系统（可考虑第三方集成）
- 不做后台管理界面
- 不做多语言支持

为什么重要：

防止范围蔓延
让 AI 知道边界在哪里
避免过度设计

与 AI 协作时的使用方式

在开始新对话时，可以这样告诉 AI：

请先阅读项目的 Intent 文档（docs/intent.md），
了解项目的目标和边界后再开始工作。

或者直接粘贴 Intent 文档内容作为上下文。

常见问题

Q: Intent 需要经常更新吗？

A: Intent 是相对稳定的。如果频繁修改 Intent，说明项目定位还不清晰，需要先想清楚再动手。

Q: Intent 写多长合适？

A: 控制在 1-2 页以内。Intent 是概览，不是详细说明书。

Q: 可以跳过 Intent 直接写 Spec 吗？

A: 不建议。没有 Intent，Spec 容易变成功能堆砌，失去焦点。

下一篇，我们将介绍 Spec 规范层的写法。