5 种模式让 AI 编码助手提升 10 倍 效率

Source: Dev.to

在每天使用 AI 辅助编码 6 个月后，这才是真正有效的做法。我每天都在使用 Claude Code、Cursor 和 Copilot。起初感觉像魔法，随后是挫败感，而现在感觉像团队里有一个出乎意料地称职的初级开发者。

1. AI 并没有失忆——只是你从未给它记忆

解决方案：创建持久化上下文文件

在你的仓库中创建一个 PROJECT_CONTEXT.md：

# Project Context

架构

• 单体 Node.js 后端，React 前端
• PostgreSQL 数据库
• 用于缓存的 Redis

关键决策

• JWT 认证（非会话）– 移动应用需要无状态
• 所有日期使用 UTC – 前端转换为本地时间
• 数据库使用 snake_case，API 响应使用 camelCase

注意事项

• 永远不要修改 legacy_payments.ts – 已弃用但仍在生产环境中
• 始终使用 ApiClient 包装器，而不是直接 fetch

Start every session with:

> “Read `PROJECT_CONTEXT.md` before we begin”

💡 I automated this with [codesyncer](https://github.com/bitjaru/codesyncer), which generates and maintains the file automatically. A hand‑written markdown file works just as well.

## 2. 注释即文档
### 旧方式 vs. 新方式
**旧方式（仅人类注释）：**

```js
// Hash the password

新方式（AI + 人类注释）：

// @decision: Using bcrypt (cost=10) over argon2
// Reason: Team familiarity, argon2 not worth the migration
const hash = await bcrypt.hash(password, 10);

为什么？AI 会读取 所有 注释。通过添加机器可读的标签，你可以创建文档，使得：

• ✅ 跨会话保持
• ✅ 解释 为什么，而不仅仅是 什么
• ✅ 防止 AI 对它不理解的代码进行“改进”

💡 小技巧：我使用 codesyncer watch 实时自动同步这些带标签的注释到中央决策日志。

3. AI 提示的“报纸测试”

在发送提示之前，先问自己：

“如果有记者写了一篇关于这个提示的报道，我会感到尴尬吗？”

不佳的提示

Fix the auth

如果出现故障的标题: “Developer Tells AI to ‘Fix Auth’, Entire User Database Exposed”

好的提示

In auth/middleware.ts, the JWT verification is failing for tokens with special characters in the email claim.

Add proper URL decoding before verification.
Don't touch the token generation logic.

具体、范围明确且安全。

4. 创建 “禁区”

某些代码在未经人工审查前不应被 AI 触碰：

• 💳 支付处理
• 🔐 身份验证/授权
• 🗑️ 数据删除
• 👑 管理员操作

实现选项

Option A – 手动

在会话开始时告诉 AI：

“在未先询问的情况下，绝不要修改 /payments 或 /auth 目录下的文件。”

Option B – 自动化

使用关键字检测器：

{
  "criticalKeywords": ["stripe", "payment", "delete", "DROP", "admin"]
}

💡 我已将其集成到 codesyncer —— 当出现这些关键字时，它会暂停 AI 操作。

5. 多文件上下文是一种超能力

AI 通常一次只能看到一个文件，但真实的代码会跨越多个文件。
技巧： 创建一个 “API Map” 文件。

# API_MAP.md

用户流程

1. 前端：src/pages/Login.tsx → 调用 src/api/auth.ts
2. 后端：routes/auth.ts → 使用 services/auth.service.ts
3. 中间件：middleware/jwt.ts 验证所有 /api/* 路由

常见模式

• 所有 API 响应：{ success: boolean, data?: T, error?: string }
• 所有服务在错误时抛出异常，控制器捕获并格式化

当 AI 看到此映射时，它会理解整体流程并避免创建不匹配的端点。

💡 对于多仓库项目，我使用 CodeSyncer 的 `--link` 功能在仓库之间连接上下文。

> **Source:** ...

## 奖励：30秒会话启动仪式
1. **先提供上下文**  
   ```text
   Read .claude/SETUP_GUIDE.md and .claude/DECISIONS.md

2. 明确陈述目标

   Today we're adding email verification to signup. Don't touch payment code.

3. 先要一个计划

   Before writing code, outline your approach in 3‑5 steps.

只需 30 秒，便能避免 30 分钟的清理工作。

模式速查表

有助于实现的工具

你发现了哪些模式？在评论里留下——我一直在寻找新技巧。👇

公开构建 codesyncer。关注获取更多 AI 编码技巧。