使用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’”。
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
这一步不能省略语言标记，必须写```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默认输出大驼峰，导致反序列化失败】
