使用fitten code写技术设计文档需首句明确输入输出与约束,用---分隔业务目标与限制,按ddd或表格驱动分段生成,伪代码须用`pseudo标记并抽象化,接口定义后须基于yaml生成小驼峰go结构体。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Fitten Code写技术设计文档时,需要让AI理解模块边界、数据流向和约束条件,否则生成内容容易堆砌术语、遗漏关键接口定义或忽略错误处理路径。
明确输入输出与核心约束
在Fitten Code的对话框里第一句就写清:【必须包含:输入参数类型、输出结构JSON Schema、失败时HTTP状态码与错误字段】。这一步漏掉,后续所有生成都可能偏离工程落地要求。
接着用三行分隔符(---)切出上下文区块,上面写业务目标(例如“用户下单后3秒内返回库存校验结果”),下面写已知限制(例如“不调用订单服务,仅查缓存+本地DB”)。
分段生成模块描述
方法一:按DDD限界上下文切分
先让AI生成“库存上下文”段落→再生成“价格计算上下文”段落→最后生成“跨上下文事件契约”段落。每段开头必须带标题层级(## 库存上下文),结尾空一行。
方法二:用表格驱动结构
在提示词中直接给出Markdown表格框架:
| 模块 | 职责 | 依赖服务 | 幂等性保障 |
|------|------|----------|------------|
然后要求AI只填充内容行,不改表头、不加额外说明。
插入可执行的伪代码片段
对关键路径,用```pseudo包裹伪代码,并在提示词中指定格式:“用动宾短语开头,如‘校验SKU是否存在’‘转换价格单位为分’‘抛出InventoryNotAvailableError’”。
这一步不能省略语言标记,必须写```pseudo,否则Fitten Code可能默认渲染成Python或JSON,导致缩进错乱、关键字高亮失效。
生成后立刻检查伪代码里是否出现真实函数名(如getRedisClient())——如有,手动替换成抽象动作(如“从缓存读取”),避免绑定具体实现。
生成接口定义章节
第一步:输入指令“生成OpenAPI 3.0格式的/v1/order/validate接口定义,请求体含sku_id、quantity,响应体含available、locked、reason”。
第二步:复制生成的YAML,在Fitten Code中新建文件,命名为openapi-validate.yaml,粘贴后保存。
第三步:回到原对话,输入“基于openapi-validate.yaml,生成对应的Go结构体定义,使用json tag,字段名用小驼峰”。【注意:必须强调‘小驼峰’,否则AI默认输出大驼峰,导致反序列化失败】











