1.背景
我最近使用了TRAE SOLO、Cline、Codex、Claude Code等客户端进行AI Coding,从最开始与AI的歇斯底里的沟通,到现在熟练构造Prompt,让AI能为我所用,那么为什么Prompt构造详细能够提升AI的准确率?为什么有时候AI像神,有时候又像傻子呢?
我认为本质原因在于:
你写的Prompt不够清晰、不够详细,不够AI进行精准的计算预测。
只有提高Prompt的质量,才能让我们在使用TRAE SOLO的时候如虎添翼,犹如神助。
2.AI是怎么理解自然语言的?
AI指代:ChatGPT、Claude、Grok、QWen、DeepSeek,它们能够理解自然语言、生成自然语言、推理、写作、分析、规划等任务。
自然语言就是人类可阅读的语言,例如英语、汉语。而AI无法理解这种“字符串”,需要像编程语言一样要进行翻译成AI能懂的语言,大牛们就进行了一个操作,将词语Token化,变成一个个浮点数含义,通过距离就能得到Token的相近程度,进而预测出下一个Token。
3.为什么你的Prompt会让AI预测不准?
上文提到,AI的本质不是在“理解”,而是在“预测下一个Token”,导致一部分人会误解AI是一个搜索引擎。事实上,AI所做的是:根据上下文,从 embedding 向量空间中找出最可能的下一个 token。
当你的Prompt很模糊时,AI会做什么:
- 模型无法推断你的真实意图;
- 只能在模糊的语义范围内做“最可能的猜测”;
- 输出自然就模糊、偏题、不稳定;
这就是为什么你经常会觉得:AI 不理解我想说什么。”事实上,它不是不理解,而是你的输入太不精确。
4.如何提高Prompt的精准度?
越详细越好,类似于AIM的架构,能能够提高AI的精准率,AIM框架:
- A:Actor(角色);
- I:Input(上下文和数据);
- M:mission(任务);
举例:
非AIM:你帮我写一份简历;
AIM:
A:你是一个语言简洁、有力、像掌控局势的专家。
I:
- 我正在做量化交易系统,包括 MarketDataBatch、StrategyFlowExecutor、AI 策略等
- 使用 Python / FastAPI / PG / React / LLM
M:根据我的背景,生成一份简历内容。要求:
- 用强势动词:owned、designed、architected、drove、executed
- 不出现“尝试、参与、协助”这类弱词
- 用结果导向描述成就
- 语言精炼但犀利,带支配感与掌控感
- 内容比普通简历更有进攻性
为什么用AIM组织Prompt会比非AIM组织更精准?
这是因为Transformer + Embedding向量空间的原理:
- Prompt越详细;
- 语义越聚焦;
- embedding 匹配空间越小;
- AI 越容易选出你真正想要的 token;
反之,提示越模糊:
- 模型必须在巨大的语义空间里随机猜测
- 最终输出自然偏差越大
这不是“模型不够聪明”,而是:你没有给它足够的信息去锁定你真正的意图。
那有人就会问,既然你提到了上下文,我所有的聊天/任务都在一个上下文/聊天窗口回复,这样AI就越来越懂我了?其实不是,上下文超过一定长度会进行上下文压缩,反而上下文越长,AI 有时反而表现更差。因为底层的 Transformer 的上下文窗口(context window)是有限的。当对话越来越长:
- 旧的信息会被压缩;
- 语义会被弱化;
- 指令会被稀释;
- 注意力会分散;
最终模型只能在“被压缩过的信息”上继续预测 token,准确度自然下降。
所以再强的 AI,没有清晰上下文,也无法理解你的诉求。
5.AIM + OpenSpec:高级 Prompt SOP
如果使用的是Claude,通过以下安装:
npm install -g @anthropic-ai/claude-code
npm install -g @fission-ai/openspec@latest
如果使用的是Trae,通过安装mcp或通过Plan模式:github.com/leon30083/t…
真正的工作方式与 AIM 框架的价值,OpenSpec 的好处:
- 可以像写 API 一样写 Prompt;
- 有 Schema、Rules、Constraints;
- 输出结构高度一致;
- 不会因为长对话而失真;
6.TRAE SOLO实践手册
-
Trae SOLO的Plan模式:进行方案设计
-
漫长的等待,终于生成了方案,不过这是初稿,你要进行“调教”它,进行方案的审核,不对的地方需要及时告诉它:
## 目标
- 样式系统从「分散的 Less」迁移为「设计令牌 + Tailwind 为主,Ant Design 主题为辅」的现代化方案。
- 统一视觉语言,达到 Notion 级别的精致与一致性(排版、间距、阴影、色彩、交互反馈)。
- 恢复并增强斜杠命令体验(更丰富的命令、稳定的触发、统一的样式)。
- 首次启动欢迎页完善与引导优化。
## 现状概览
- 构建:CRA + react-app-rewired + customize-cra,桌面端 Electron(package.json:1–174)。
- UI:Ant Design v5(主题通过 `ConfigProvider`,src/index.jsx:174;同时仍保留 Less 变量覆盖,config-overrides.js:11–18)。
- 样式:Tailwind 已接入(tailwind.config.js:1–158;入口 `./styles/tailwind.css`,src/index.jsx:6),但仍有 6 个 `.less` 文件分散(markdown/timeline/journalEntry/codeBlockComponent/CwEditor/index/global index)。
- 路由:以内部 `activeKey` 切页而非 react-router(src/index.jsx:120–124/185–199)。
- 编辑器:TipTap/ProseMirror 栈齐全;斜杠命令扩展已实现并接入(src/common/extensions/index.js:20/66;slashCommand.js:9–33;SlashMenuComponent.jsx:11–171;markdown.less:805–816 为旧样式容器)。
- 欢迎页:已存在并按首次启动显示(src/index.jsx:50–64/156–163;src/pages/welcome/Welcome.jsx 全文)。
## 样式系统现代化
1. 设计令牌与主题统一
- 以 Tailwind `theme.extend` 中的 notion/notion-dark 作为主令牌源(tailwind.config.js:10–61),补齐重点语义:文本层级、边框强度、交互态、内容宽度、阴影等(tailwind.config.js:62–155)。
- 以 AntD v5 `ConfigProvider` 的 `theme.token` 做组件生态补充,令牌映射到 Tailwind 语义(src/index.jsx:174–176)。
- 逐步淡化 Less 的 `modifyVars`(仅保留必要覆盖),让主色等转由 `theme.token` 管理(config-overrides.js:11–18)。
1. 基线样式抽取
- 在 `styles/tailwind.css` 中使用 `@layer base` 定义 ProseMirror/Editor 基线(标题、列表、blockquote、code/pre、占位符等),消除在多个 `.less` 的重复(现重复来源:markdown.less 与 journalEntry.less 的 `.ProseMirror`、标题/列表规范)。
- 建议新增 `@layer components` 里定义通用组件类(如菜单面板、气泡工具栏、卡片、滚动条),对应 Notion 的边框与阴影规范,使局部界面复用一致视觉。
1. 分阶段迁移 `.less` → Tailwind
- 阶段 A(基础与编辑器):
- `src/pages/file/markdown.less` → 迁移到 Tailwind 类与 `@layer base/components`;保留少量特殊布局。
- `src/common/extensions/codeBlockComponent.less` → 合并到 CodeBlock 的 Tailwind 类(强调滚动与可读性)。
- 阶段 B(视图页):
- `timeline.less`、`journalEntry.less` → 统一排版与间距;卡片/列表采用通用面板类;移除重复的 code/blockquote 处理。
- 阶段 C(旧编辑器):
- `src/common/CwEditor/index.less` → 若继续保留 ProseMirror 原生视图,则套用同一基线与组件层;否则标记为遗留并弱化使用。
- 阶段 D(全局):
- `src/index.less` 只保留必要 Reset 与极少量全局覆盖;AntD 样式切换为 `import 'antd/dist/reset.css'`(v5 推荐)以减少冲突。
1. 暗色模式与系统跟随
- 继续用 `document.documentElement.classList` 切换 `dark`(src/index.jsx:130–145)。
- 所有视觉类用 `dark:*` 变体确保等价覆盖;避免在 `.less` 里重复维护深浅主题规则。
## 视觉精致化(Notion 风格)
- 排版:统一字号与行高(tailwind.config.js:104–113),正文最大宽度 `max-w-editor`(tailwind.config.js:149–151),标题层级的上下间距规范化。
- 间距系统:以 `spacing` 扩展(tailwind.config.js:62–80)为唯一来源,移除散落的像素常量。
- 表面与边框:统一用 `notion.border` 与 `boxShadow.notion-menu/notion-menu-dark`,让面板/菜单/气泡一致。
- 交互反馈:hover/selected 使用在主题中定义的半透明色;速度统一 `transitionDuration.fast`(tailwind.config.js:135–139)。
- 滚动条与可读性:细滚动条类复用;代码块采用更高对比与可滚动容器。
## 斜杠命令启用与增强
- 现状:扩展已启用(`SlashCommand` 已纳入 extensions,src/common/extensions/index.js:66),触发字符 `/`(slashCommand.js:15)。菜单由自绘组件渲染(slashCommandConfig.js:11–66;SlashMenuComponent.jsx:11–171)。
- 计划:
- 样式迁移:移除旧 `.slash-menu` 的 Less(markdown.less:805–816),改为 Tailwind 组件类(SlashMenuComponent.jsx:213–285 已有 Tailwind 结构,补齐主题色与阴影)。
- 命令丰富:增加图片/附件、内部链接、代码语言快速切换、引用转段落等;分组展示与键盘导航完善(SlashMenuComponent.jsx:185–207 导航钩子已就绪)。
- 稳定性:校验在所有 TipTap 实例均加载 `plugins`(markdown.jsx:71–88),避免个别视图未启用;为 Suggestion 提供冲突唯一 `PluginKey`(slashCommand.js:7)。
## 欢迎页完善
- 现状:已实现两步引导与工作空间选择(src/pages/welcome/Welcome.jsx);首次启动检测与显示逻辑完备(src/index.jsx:50–64/156–163)。
- 计划:
- 视觉统一:复用通用面板类与阴影,确保与主应用一致。
- 快速开始:补充更多快捷键与功能提示;支持返回重新选择工作空间。
- 稳健性:增加失败态与重试提示;路径校验与可写权限检测。
## 具体改造清单(按文件)
- `src/pages/file/markdown.less` → 删除/缩减,转移到 `@layer base/components` 与 JSX 类(参考 markdown.jsx:92–111)。
- `src/pages/file/timeline.less`、`src/pages/journal/journalEntry.less` → 结构类 + 通用面板类;移除重复排版。
- `src/common/extensions/codeBlockComponent.less` → Tailwind 类内联到自定义 NodeView(src/common/extensions/codeBlockComponent.jsx)。
- `src/common/extensions/SlashMenuComponent.jsx` → 完善命令与样式,无需 Less;保留键盘导航与 tippy 浮层。
- `src/index.less` → 仅保留必要 Reset;`antd` 切换为 `import 'antd/dist/reset.css'`(src/index.jsx:3)。
- `config-overrides.js` → 保留 less-loader 仅为遗留 `.less` 服务;逐步移除 `modifyVars` 主色,改用 `ConfigProvider.theme.token`。
## 验证与质量保障
- 单页比对:每迁移一个页面先局部验证(视觉/交互/暗色一致性)。
- 电子端运行:`npm run all`,检查欢迎页、编辑器(斜杠命令、内部链接 Suggestion)、文件列表与设置页。
- 无痕回滚:保留 `.less` 文件的原始版至迁移完成前的分支;提供切换开关以快速对比。
## 风险与回滚
- 风险:Tailwind 类名迁移过程中可能出现覆盖顺序问题;AntD v5 与 Tailwind 交互样式冲突。
- 规避:使用 `@layer` 明确层级;统一 reset;通过 `ConfigProvider` 控制组件令牌,避免 Less 与 Token 双重来源。
- 回滚:保留旧 `.less` 样式与入口引用,支持快速恢复;按阶段逐步删除确保链路安全。
## 交付节奏
- 周期 3 阶段:基础/页面/旧编辑器;每阶段完成后提交对比截图与变更说明。
- 全程保持功能可用(欢迎页、斜杠命令在阶段 A 即完善)。
请确认以上方案;确认后我将按阶段实施并在每一步完成后给出可视化验证结果。
3. Plan没问题就点击执行:
- 最终效果图,TRAE SOLO优化后的效果图:
7.总结
AI进步太快了,不接纳它就会被淘汰,只能想办法快速融入它,每次面对AI就如同老板面对员工,假设天天只YY不落地,与你现在的老板有什么区别?