trae组件文档应剥离独有逻辑（①）与可复用内容（②前置条件、③通用说明），将②③沉淀为/templates模板、/snippets语句片段、/rules复用规则三层库，通过标签引用和自动化命令生成轻量、一致、易维护的文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为Trae开发的组件编写一份清晰、可复用的使用文档，但每次写都陷入相似句式、重复描述参数或反复解释基础概念，导致文档冗长且维护成本高。
识别并剥离“必须重写”与“可复用”内容
打开你手头三份最近写的Trae组件文档，逐段标出：① 每个组件独有的行为逻辑（如“仅在Solo模式下触发终端命令”）、② 所有组件共用的前置条件（如“需已登录Trae账号”“依赖Python 3.8+”）、③ 被不同人反复重写的通用说明（如“点击右侧对话框输入自然语言指令”）。前三类中，②和③就是可沉淀的复用块，而①才是每次必须定制的部分。
这一步不做判断，只标记。标记完你会发现：超过60%的文档篇幅其实属于②和③。
建立三层复用模块库
在团队知识库根目录新建三个文件夹：/templates（结构模板）、/snippets（语句片段）、/rules（复用规则）。
【/templates 中只放3个文件】：`component-readme.md`（含标题区、依赖声明区、快速开始区、API区占位符）、`troubleshooting.md`（统一错误码表+通用排查路径）、`changelog-template.md`（按Trae版本号自动归档的变更记录格式）。
【/snippets 中禁止出现完整句子】，只存可拼接的短语单元，例如：「支持Chat/Builder/Solo三模式调用」、「自动注入当前项目上下文」、「无需手动安装CLI依赖」。每个单元带标签，如[mode-support]、[context-aware]、[no-cli]。
把重复率最高的5个表达，全部删掉原文，替换成带标签的snippet引用。比如原句“该组件可在Chat、Builder和Solo三种模式下调用”，直接改为{{mode-support}}。
用提示词强制调用复用模块
方法一：在Trae的Builder模式中输入以下自然语言指令：
“基于/templates/component-readme.md模板，填充组件ExcelCleaner的独有逻辑；从/snippets中提取标签为[mode-support]、[context-aware]、[no-cli]的片段；跳过/rules/exclude-list.txt中列出的已废弃参数说明。”
方法二：在Solo模式下让AI执行自动化组装：
第一步：运行命令 trae docgen --template component-readme.md --snippets mode-support,context-aware,no-cli --exclude exclude-list.txt --output ExcelCleaner.md；
第二步：AI自动读取本地/rules/exclude-list.txt，过滤掉已被标记为“v1.2起弃用”的参数字段；
第三步：AI将/snippets中对应标签的内容插入模板占位符，并保持术语大小写与已有文档库完全一致。
注意：【exclude-list.txt 必须每季度手动更新一次，否则AI会复用已淘汰的参数说明】。
校验复用是否生效
生成文档后，用以下命令行快速比对重复率：
git diff --no-index /dev/null ExcelCleaner.md | grep -E '^\+' | wc -l
再运行：
grep -o '{{[^}]*}}' ExcelCleaner.md | sort | uniq -c | sort -nr
如果第二条命令输出中，最高频的snippet调用次数≤3，且第一条命令统计的新增行数＜120，说明复用机制已起效——此时文档主体由模板+片段驱动，而非人工堆砌。
