02-提示词工程之Chat拆解方法论

参考资料：

• TRAE IDE 社区：https://forum.trae.cn/c/9-category/9

以 前端 项目新需求全流程Chat拆解为例（适配TRAE SOLO + 全局SKILL为前提）。

一、Chat 拆解核心底层原则

1. SKILL优先铁则：每一轮Chat的首条指令，必须强制绑定项目全局SKILL，所有AI输出必须100%符合SKILL规范，禁止任何脱离规范的内容
2. 渐进式拆解原则：从宏观需求→业务边界→技术方案→原子任务→代码开发→联体验收逐层拆解，上一环校验不通过，绝对不进入下一环
3. 原子化可控原则：每个Chat任务颗粒度最小化，单个Chat只解决一个独立、可校验、无强依赖的子任务，避免一次性生成全量代码导致的不可控
4. 项目上下文绑定原则：每一轮Chat必须明确要求AI基于当前打开的前端项目代码、现有架构、依赖版本、全局SKILL输出内容，禁止脱离项目实际的通用化方案
5. 闭环校验原则：每一步拆解都有明确的验收标准，AI输出后必须先做合规校验，不达标立即修正，绝不带问题进入下一阶段

二、Chat 拆解 6 个阶段覆盖全流程

1 阶段：需求澄清与业务对齐

（核心：把模糊需求变成可落地的结构化契约）

目标：彻底消除需求歧义，明确业务边界、验收标准，避免后续开发反复返工，所有Chat输出必须可和产品/业务方确认对齐。

第1轮Chat：需求结构化拆解

Prompt模板（直接复制使用）

严格基于我当前打开的前端项目技术栈、已加载的全局开发规范SKILL，对我输入的原始需求进行结构化拆解，输出标准化的需求说明书，禁止脱离需求本身做扩展。

原始需求：【这里粘贴你拿到的完整原始需求】

输出要求：
1.  核心业务目标：明确这个需求要解决什么问题、给谁用、要达到什么业务效果
2.  核心功能清单：拆分成可独立验收的功能点，每个功能点明确`用户操作→系统响应`的完整逻辑
3.  边界与约束条件：明确需求的生效范围、不做的内容、业务规则限制、权限要求
4.  交互与UI约束：明确页面布局、交互动作、异常场景处理、UI还原要求
5.  前后端对接约束：明确需要对接的后端接口、入参出参要求、数据格式规范
6.  非功能需求：明确性能要求、兼容性要求、埋点要求、上线时间节点
7.  验收标准：每个核心功能点对应的可量化、可验证的验收条件

输出校验标准：

• 没有模糊的、模棱两可的描述，所有功能点都有明确的验收标准
• 明确了做什么/不做什么，边界清晰，没有遗漏业务规则
• 完全贴合你项目的技术栈，没有超出项目能力范围的需求

第2轮Chat：需求歧义点与风险点排查

Prompt模板

基于上一轮输出的结构化需求说明书，结合我当前项目的现有架构、技术栈、全局SKILL规范，完成以下输出：
1.  需求歧义点清单：列出所有表述模糊、存在多种理解、需要和产品方确认的问题，每个问题必须给出`确认选项/建议结论`
2.  技术风险点清单：列出这个需求可能存在的技术风险，包括但不限于：和现有功能冲突、现有架构不支持、依赖第三方能力、性能风险、兼容性风险
3.  需求遗漏点清单：基于前端开发的完整流程，列出原始需求中遗漏的、必须明确的细节（比如异常场景、空状态、权限控制、埋点等）

输出校验标准：

• 所有歧义点都有明确的确认方向，不需要二次解读
• 风险点都给出了对应的影响范围和初步解决方案
• 遗漏点覆盖了前端开发的全场景，没有关键信息缺失

第3轮Chat：需求终版契约锁定

Prompt模板

基于我补充确认后的需求信息，更新并输出最终版的`需求开发契约说明书`，要求：
1.  所有歧义点、遗漏点都已补充完整，无任何模糊表述
2.  所有功能点、验收标准都已对齐确认，可直接作为开发依据
3.  明确标注了需求的优先级、开发排期、依赖项
4.  结尾补充`需求变更规则`：明确任何需求变更必须重新走拆解流程，禁止开发过程中随意变更需求

阶段闭环标志：这份需求契约说明书，你和产品/业务方都无异议，可作为后续所有开发的唯一依据。

2 阶段：影响范围与技术方案

（核心：对齐项目架构，锁定实现路径，避免返工）

目标：基于锁定的需求契约，明确需求对现有项目的影响范围，设计完全符合项目架构、全局SKILL的技术方案，提前规避架构冲突、代码冗余、规范不符的问题。

第1轮Chat：项目影响范围评估

Prompt模板

严格基于我当前打开的前端项目完整代码、目录结构、全局SKILL规范，以及最终版需求开发契约，完成以下输出：
1.  影响模块清单：明确这个需求需要新增/修改的所有文件、目录、组件、hooks、状态管理、路由配置、接口定义
2.  现有复用能力清单：列出项目中已有的、可直接复用的公共组件、hooks、工具函数、接口封装，禁止重复开发
3.  冲突风险清单：列出需求开发可能和现有代码、逻辑、规范产生的冲突，以及对应的规避方案
4.  依赖变更评估：明确是否需要新增/修改项目依赖，若需要，必须给出依赖名称、版本、兼容性校验结果，以及是否符合项目SKILL规范

输出校验标准：

• 影响范围100%覆盖需求，没有遗漏需要修改的模块
• 明确了可复用的现有能力，避免重复造轮子
• 所有潜在冲突都有对应的解决方案，没有架构风险

第2轮Chat：技术方案设计与SKILL合规校验

Prompt模板

基于需求开发契约、项目影响范围评估结果，严格遵循项目全局SKILL规范，输出完整可落地的技术实现方案，要求：
1.  整体架构设计：明确需求的实现分层、模块划分、数据流走向，完全对齐项目现有架构
2.  页面/组件拆分方案：明确需要新增的页面、公共组件、业务组件，每个组件的职责边界、props/emit定义、复用规则
3.  状态管理方案：明确是否需要新增全局/局部状态，状态模块划分、数据结构定义，对齐项目现有状态管理规范
4.  接口对接方案：明确需要对接的后端接口、请求封装、入参出参类型定义，对齐项目现有接口请求规范
5.  路由与权限方案：明确新增路由配置、权限控制规则，对齐项目现有路由与权限规范
6.  异常与兜底方案：明确网络异常、接口报错、空数据、权限不足等场景的处理方案，对齐项目现有规范
7.  性能与兼容性方案：明确大列表渲染、包体积优化、浏览器兼容性处理方案
8.  SKILL合规校验：针对方案中的每一项，明确标注是否符合项目全局SKILL规范，若有不符合的内容，必须给出修正方案

输出校验标准：

• 方案完全贴合项目现有架构，没有引入新的架构模式
• 每一项实现都严格对齐全局SKILL规范，无违规内容
• 方案颗粒度足够细，可直接拆分为开发任务，没有模糊的实现逻辑

第3轮Chat：技术方案终版锁定

Prompt模板

基于我确认后的方案调整意见，更新并输出最终版的`技术实现方案`，要求：
1.  所有调整意见都已落地，方案无架构风险、无规范冲突
2.  明确了每个模块的开发优先级、依赖关系、交付标准
3.  补充了方案的自测标准、联调标准、上线checklist

阶段闭环标志：技术方案无架构风险、100%符合全局SKILL规范、可直接拆分为开发任务。

3 阶段：原子化开发任务

（核心：把大需求拆成AI可稳定执行的最小单元）

目标：把完整的技术方案，拆分成一个个无强依赖、可独立开发、可独立校验、可独立回滚的原子开发任务，彻底避免一次性让AI生成全量代码导致的混乱、不可控、规范不符的问题。

第1轮Chat：原子化任务拆解

Prompt模板

基于最终版的技术实现方案、项目全局SKILL规范，把需求拆分为原子化的开发任务清单，要求：
1.  单个任务只对应一个独立的开发单元，颗粒度控制在`单个文件/单个组件/单个hooks/单个工具函数`，禁止一个任务包含多个不相关的开发内容
2.  明确每个任务的：任务ID、任务名称、开发内容、输入依赖、输出交付物、验收标准、优先级、前置依赖任务
3.  任务顺序必须符合开发逻辑：先基础层（类型定义、接口封装、工具函数）→ 组件层（公共组件、业务组件）→ 页面层（页面整合、路由配置）→ 联调层（数据流、交互逻辑）
4.  每个任务的验收标准必须可量化、可校验，明确要求必须符合项目全局SKILL规范

输出校验标准：

• 所有任务100%覆盖技术方案，没有遗漏开发内容
• 任务颗粒度合适，单个任务开发内容不超过200行代码，AI可稳定生成
• 任务依赖关系清晰，没有循环依赖，可按顺序执行
• 每个任务都有明确的验收标准，可直接校验是否达标

第2轮Chat：任务优先级与排期锁定

Prompt模板

基于拆解的原子任务清单，结合需求的上线时间节点，输出任务开发排期表，明确：
1.  每个任务的开发顺序、预计工时、责任人
2.  并行开发的任务分组、串行依赖的任务节点
3.  关键里程碑节点：基础层完成、组件层完成、页面层完成、联调完成、提测完成

阶段闭环标志：原子任务清单无遗漏、依赖清晰、可直接按顺序执行开发。

4 阶段：分任务代码开发与合规校验

（核心：单任务单Chat，强制SKILL对齐，每环闭环）

目标：针对每个原子任务，通过标准化的Chat流程，确保生成的代码100%符合需求、100%对齐全局SKILL、无语法错误、无逻辑问题。单个任务标准化Chat流程（每个任务单独执行，禁止多任务混在一个Chat）。

第1步：任务开发Chat - 生成代码

Prompt模板（每个任务替换对应内容）

# 强制前置要求
1.  严格遵循本项目已生效的【全局开发规范SKILL】，所有输出必须100%对齐SKILL中的命名规范、代码风格、组件写法、TypeScript类型规范、工程化要求，禁止生成任何违反SKILL的内容
2.  严格基于我当前打开的前端项目的现有代码、依赖版本、目录结构、技术栈生成内容，禁止脱离项目实际的通用化代码
3.  仅输出当前任务对应的代码，禁止输出无关内容、禁止扩展需求外的功能

# 任务信息
任务ID：【替换为任务ID】
任务名称：【替换为任务名称】
开发内容：【替换为任务的详细开发内容】
输入依赖：【替换为任务的前置依赖，比如已有的类型定义、接口、组件】
验收标准：【替换为任务的验收标准】

# 输出要求
1.  先明确标注代码对应的文件完整路径，确保和项目目录结构完全对齐
2.  输出完整可运行的代码，包含完整的类型定义、注释、异常处理，完全符合项目SKILL规范
3.  代码结尾补充`代码说明`：明确代码的核心逻辑、与现有项目的兼容情况、SKILL规范对齐情况

第2步：代码合规校验Chat - 必做&禁止跳过

Prompt模板

针对上一轮输出的代码，严格按照以下要求完成全量校验，输出校验报告：
1.  SKILL规范校验：逐行校验代码是否完全符合项目全局SKILL规范，列出所有不符合的内容，以及对应的修正方案
2.  需求匹配校验：校验代码是否完全满足当前任务的开发内容、验收标准，列出所有不符合的内容，以及对应的修正方案
3.  语法与类型校验：校验代码是否有TypeScript语法错误、类型错误、导入缺失、依赖未定义的问题
4.  兼容性校验：校验代码是否和项目现有代码、依赖版本兼容，是否会影响现有功能
5.  安全与性能校验：校验代码是否有XSS风险、敏感信息泄露、性能问题，以及对应的优化方案
6.  最终校验结论：明确代码是否通过校验，若未通过，给出完整的修正后代码

第3步：人工校验+修正闭环

• 基于AI的校验报告，人工确认代码是否符合要求，若有问题，继续通过Chat修正，直到代码完全通过校验
• 校验通过后，将代码合并到项目中，完成当前任务，再进入下一个任务的开发

阶段闭环标志：所有原子任务全部开发完成，代码全部通过SKILL合规校验、需求匹配校验，可正常运行。

5 阶段：集成联调与测试

（核心：全链路验证，确保功能闭环）

目标：把所有开发完成的模块集成起来，验证全链路功能、数据流、交互逻辑是否符合需求，生成对应的测试用例，确保功能稳定。

第1轮Chat：全链路集成校验

Prompt模板

基于本次需求开发的所有代码、项目现有完整代码、全局SKILL规范、需求开发契约，完成以下输出：
1.  全链路数据流校验：验证从用户操作→接口请求→状态更新→页面渲染的完整数据流是否正确，列出所有逻辑断点、数据不一致的问题，以及修正方案
2.  组件联动校验：验证页面内组件之间、父子组件之间、兄弟组件之间的联动是否符合需求，列出所有交互异常的问题
3.  路由与权限校验：验证新增路由是否正确、权限控制是否生效、页面跳转是否符合预期
4.  异常场景全量校验：验证网络异常、接口报错、空数据、权限不足、非法入参等所有异常场景的处理是否符合项目规范
5.  与现有功能兼容性校验：验证本次开发的内容是否会影响现有功能的正常运行，列出所有潜在的兼容风险

第2轮Chat：测试用例生成与执行

Prompt模板

基于需求开发契约、全链路校验结果，严格遵循项目现有测试规范，输出完整的测试用例清单，要求：
1.  覆盖所有核心功能点、正常场景、异常场景、边界场景、兼容性场景
2.  每个测试用例包含：用例ID、测试场景、前置条件、操作步骤、预期结果、实际结果、是否通过
3.  针对前端自动化测试，输出对应的单元测试代码、E2E测试代码，完全符合项目现有测试框架与规范

第3轮Chat：bug修复与回归校验

针对测试中发现的bug，按照单个bug单轮Chat的方式，重复阶段4的标准化开发流程，修复完成后必须做回归校验，确保bug彻底修复，不引入新的问题。

阶段闭环标志：所有测试用例100%通过，全链路功能正常，无bug，无兼容问题。

6 阶段：需求验收与回归Chat拆解

（核心：需求闭环，确保上线无风险）

目标：完成需求最终验收，确保开发内容100%符合需求契约，上线前完成全量回归，输出上线checklist。

第1轮Chat：需求覆盖度验收

Prompt模板

基于最终版需求开发契约、本次开发的所有代码、测试结果，输出需求覆盖度验收报告：
1.  需求覆盖度统计：明确哪些功能点已完全实现、哪些有偏差、哪些未实现，偏差项必须给出修正方案
2.  业务目标达成情况：验证开发内容是否满足需求的核心业务目标
3.  规范合规情况：验证所有代码是否100%符合项目全局SKILL规范，列出所有不合规项与修正方案
4.  上线风险评估：列出上线可能存在的风险，以及对应的规避方案、回滚方案

第2轮Chat：上线checklist与交付物输出

Prompt模板

基于本次需求的全流程开发内容，输出：
1.  上线前checklist：包含代码合并、构建校验、环境配置、回归测试、权限配置、埋点配置、回滚方案等所有上线前必须确认的事项
2.  需求交付物清单：包含需求开发契约、技术方案、原子任务清单、代码仓库地址、测试用例、验收报告、用户操作手册（若需要）
3.  后续维护说明：明确本次开发内容的维护要点、后续迭代注意事项、已知问题与规划

阶段闭环标志：需求通过产品/业务方最终验收，上线checklist全部确认完成，可安全上线。

三、TRAE SOLO专属Chat交互技巧

1. SKILL强制加载技巧：每一轮Chat的开头，都加上"严格遵循本项目已生效的全局开发规范SKILL"这句话，TRAE SOLO会自动加载你已配置的全局SKILL，确保所有输出都符合规范
2. 上下文管理技巧：
   1. 单个原子任务单独开一个Chat回合，避免多任务上下文污染
   2. 长对话中，每 3 轮就重新明确一次核心要求与SKILL规范，避免AI上下文丢失跑偏
   3. 涉及项目全量代码的校验，明确要求TRAE基于当前打开的项目完整代码执行，激活TRAE的项目代码读取能力
3. 错误修正技巧：若AI生成的内容不符合要求，不要直接让AI重写，要明确指出"不符合SKILL的哪一条规范、不符合需求的哪一个点、需要修正的具体内容"，让AI精准修正，避免二次跑偏
4. 增量开发技巧：针对现有代码的修改，必须把现有代码片段 + 修改要求完整输入到Chat中，让AI只做增量修改，避免重写整个文件导致的规范丢失、逻辑错误

四、需求变更时的重拆解流程

若开发过程中出现需求变更，必须严格按照以下流程执行，禁止直接修改代码：

1. 输出需求变更说明书，明确变更内容、变更原因、影响范围、验收标准
2. 重新走阶段 2→3→4→5→6的全流程拆解，针对变更内容更新技术方案、原子任务、开发代码
3. 变更内容开发完成后，必须做全量回归测试，确保不影响原有功能
4. 更新需求开发契约、技术方案、验收报告等所有交付物

五、绝对不能碰的避坑红线

1. 禁止跳过需求澄清、方案设计，直接让AI生成全量代码，90%的返工都来自于此
2. 禁止一个Chat回合包含多个开发任务，颗粒度越大，AI生成的内容越不可控、越容易偏离规范
3. 禁止跳过代码合规校验环节，哪怕是很小的修改，也必须先校验是否符合SKILL规范
4. 禁止开发过程中随意变更需求，所有变更必须重新走拆解流程，避免越改越乱
5. 禁止让AI脱离项目现有代码生成通用化内容，所有输出必须绑定当前项目的上下文与SKILL规范