ECC实战指南№｜实战演练，用ECC从零搭建一个真实项目

上一篇介绍了Context Window优化。今天进入实战环节——用ECC从零搭建一个真实项目，体验完整的工作流。

实战目标：搭建一个待办清单API

我们要用ECC搭建一个完整的待办清单后端API，包含以下功能：

• 用户注册和登录（JWT认证）
• 待办事项的增删改查
• 任务优先级和截止日期
• 数据持久化（SQLite）

第1步：初始化项目

# 在终端执行
ecc init todo-api
cd todo-api

# ECC自动生成的项目结构：
todo-api/
├── .ecc/
│   ├── config.json      # ECC配置
│   ├── instincts/       # Instinct规则
│   └── memory/          # 项目Memory
├── src/
│   ├── index.ts         # 入口文件
│   ├── auth/            # 认证模块
│   ├── todos/           # 待办模块
│   └── db/              # 数据库
├── package.json
├── tsconfig.json
└── SKILL.md             # 项目技能说明

第2步：编写Instinct规则

在编码开始前，先告诉ECC项目的"本能"：

# .ecc/instincts/project.md

## 技术栈
- 运行时：Node.js + TypeScript
- 框架：Express.js
- 数据库：SQLite (better-sqlite3)
- 认证：JWT (jsonwebtoken)
- 密码：bcrypt

## 编码规范
- 所有API返回JSON格式：{ code: number, data: any, message: string }
- 错误码：200成功，400参数错误，401未认证，404不存在
- 所有路由必须有auth中间件（除register和login）
- SQL查询使用参数化（防注入）
- 密码存储必须bcrypt加密，禁止明文

这些规则在每次对话中都会被ECC自动加载，不需要每次重复说明。

第3步：用自然语言启动开发

# 对ECC说：
"帮我搭建完整的用户注册登录系统，包括注册、登录、获取当前用户信息的API"

ECC会根据Instinct规则，自动：

1. 安装必要的npm包（express, jsonwebtoken, bcrypt, better-sqlite3）
2. 创建数据库初始化脚本
3. 编写auth路由和中间件
4. 遵循错误码规范和密码加密规范

生成的代码结构：

src/
├── index.ts           # Express应用入口
├── db/
│   └── init.ts        # SQLite初始化+表创建
├── auth/
│   ├── router.ts      # /api/auth/register, /api/auth/login
│   ├── middleware.ts   # JWT验证中间件
│   └── types.ts       # TypeScript类型定义
└── utils/
    └── response.ts    # 统一响应格式 { code, data, message }

第4步：继续开发待办功能

# 对ECC说：
"添加待办事项模块，支持增删改查，每个待办有标题、内容、优先级(high/medium/low)和截止日期"

ECC会自动：

• 创建todos表结构
• 编写CRUD路由（需认证中间件保护）
• 添加输入验证
• 保持与auth模块的一致性（同样的错误码格式）

第5步：利用Memory保持一致性

当ECC工作一段时间后，它会在Memory中自动记录：

# .ecc/memory/project.md（ECC自动生成）

## 数据模型
- users表：id, username, email, password_hash, created_at
- todos表：id, user_id, title, content, priority, due_date, completed, created_at, updated_at

## API路由
- POST /api/auth/register
- POST /api/auth/login
- GET /api/auth/me
- GET /api/todos
- POST /api/todos
- PUT /api/todos/:id
- DELETE /api/todos/:id

## 已做决策
- 优先级用枚举字符串而非数字
- 截止日期为可选字段
- completed默认false

这样即使对话很长或重新开始，ECC也能快速恢复上下文，保持项目一致性。

实战效果对比

关键要点

• 先写Instinct，再写代码：规则越清晰，生成代码质量越高
• 分步推进，每次一个功能：不要一次性让ECC做所有事
• 审查Memory记录：定期检查ECC记录的决策是否准确
• 利用@引用：在复杂修改中明确指定文件，减少Token浪费

下一篇是ECC实战指南最后一篇，我们将总结完整系列，并分享ECC的高级技巧和最佳实践。