指南

用灵码进行氛围编程的最佳实践

「氛围编程」即与 AI 助手保持心流:你描述意图,模型给出代码,你审查并迭代。下面是如何在灵码里高效做到这一点,保持专注、更快交付。

什么是氛围编程?

氛围编程(或 AI 辅助编程)指你专注要什么——功能、行为、修复——让 AI 建议怎么做。目标是减少上下文切换,把精力放在问题上而不是语法和样板代码。灵码为此而建:Mac 原生、项目感知对话、多步任务的 Agent 模式、带 diff 预览的内联编辑,让你始终掌控。

写清晰、具体的提示

结果描述得越清楚,模型输出越好。建议:

  • 具体优于模糊 — 例如「在设置页加一个深色模式开关,并用 localStorage 持久化」而不是「支持深色模式」。
  • 上下文集中说明 — 指明文件或区域(「在 SettingsView.swift 里添加…」),避免模型猜错。
  • 一条消息一个主需求 — 复杂任务拆成多步或交给 Agent,让模型按顺序规划和执行。

用 @ 带入上下文

在灵码的对话和 Agent 输入里输入 @ 可附加文件、符号或代码库搜索结果,模型能看到真实代码结构。例如:「@AuthService.swift 在 token 过期时添加刷新方法」让 AI 明确要扩展的类。

何时用 Agent 模式,何时用内联编辑

  • 内联编辑(如 Cmd+K) — 适合单文件的一次性修改:「把这个函数重命名为 fetchUserProfile 并加缓存」或「在这里加错误处理」。你会看到 diff,确认或微调后继续。
  • Agent 模式 — 适合多文件或多步:「加一个登录页,调用我们的 AuthService 并跳转到首页」或「修好这个文件夹里所有 TypeScript 报错」。Agent 可读文件、跑命令、提议编辑,你逐步审批或用命令白名单放行信任模式。

小范围、单文件改动先用内联编辑保持心流;任务跨多文件或多步时再交给 Agent,减少重复和来回修改。

用规则让 AI 符合你的风格

灵码使用与 Cursor 相同的规则:WORKSPACE.md.cursorrules.cursor/rules(.mdc)。用它们约定:

  • 技术栈与习惯(「我们用 SwiftUI,状态优先放在 view model。」)
  • 命名与结构(「API 路由用 kebab-case;处理函数放在 /api。」)
  • 避免事项(「不要未经讨论就加新依赖。」)

好的规则能减少来回,让生成代码与项目其余部分一致。

接受前先看 diff

灵码每次编辑(内联或 Agent)都会显示 diff。养成习惯:扫一眼改动,在提示或 diff 里修正明显错误再接受。这样既保证质量,也帮你学会如何写更好的提示。

大胆用 Agent 时善用检查点

当 Agent 即将做大量修改时,依赖 检查点。灵码会为 Agent 编辑创建检查点;若有问题,可从时间线恢复到之前状态。这样可以放心做更大的多文件重构。

小结

用灵码做氛围编程时:(1) 写清晰、具体的提示,(2) 用 @ 附加上下文,(3) 单文件改动用内联编辑、多步工作用 Agent,(4) 维护项目规则,(5) 审查 diff 并对大范围 Agent 操作使用检查点。你会少跟工具较劲,多写代码。

试试看:下载灵码 Mac 版 并打开你当前项目。