在软件开发中我们常遇到这些问题同样的功能在不同页面重复实现修复一个 bug要在多个地方改同样的代码新人不知道有现成组件又造了一遍轮子公共组件更新后不知道有哪些地方在用很多人只把复用理解为“复制粘贴代码”或“复用封装好的构件”其实软件复用可以分为两个层次1.源码级复用复用已封装好的构件、函数、组件直接调用、开箱即用。2.设计级复用复用成熟的处理机制、通用流程、设计模式、业务规则在新场景复用“思路和框架”。一个成熟的开发过程必须同时支持源码级复用和设计级复用才能真正降本增效、提升质量。传统复用方式的痛点复用知识分散在团队成员脑子里源码级复用靠人记设计级复用靠经验没有集中、可搜索的清单构件找不到、设计思路更难沉淀代码评审时难以发现重复代码也很难检查设计是否合理复用新组件提取后、新设计沉淀后没有及时登记和传播AI的优势同时支持两层复用自动扫描项目发现可复用的源码构件和设计模式/处理机制开发前主动推荐可用组件同时推荐适用的设计思路/成熟方案评审时检查是否遗漏源码复用也检查是否忽略设计复用自动维护复用清单同时沉淀构件资产和设计资产我们做了什么一个真实案例项目背景这是一个 Python Flask 前端 JS 的全栈项目包含多个功能页面智能评审、需求生成、设置等已有多个公共组件但没有系统整理用户反馈文档预览功能在不同页面实现不一致我们的行动提取统一的文档预览组件源码级复用沉淀通用的文档预览处理机制设计级复用建立复用清单同时登记构件与设计方案改造 AI 的工作流程skill支持两层复用第一步建立复用清单同时沉淀两层资产复用清单是 AI 实现复用的基础既要登记源码构件也要沉淀设计方案。清单包含什么字段说明示例资产类型源码构件 / 设计方案源码构件DocPreview设计方案通用预览流程名称清晰命名DocPreview - 文档预览组件 / 通用文档预览处理机制功能/思路简要描述提供统一预览界面 / 支持多格式、本地/远程文件预览应用场景适用范围所有需预览文件的页面 / 各类文件预览类需求解决痛点消除的问题避免重复编码、体验不一致 / 避免重复设计、逻辑混乱位置/文档路径或说明static/js/doc-preview.js / docs/design/preview-flow.md使用示例代码或流程见下文 / 标准流程步骤首次引入时间/版本2026-06-01清单结构前端源码构件文档预览、文件上传、Toast 提示后端源码构件Excel 格式化工具、通用校验模块设计方案资产通用预览流程、统一错误处理、权限校验机制关键原则清单文件REUSABLE_ASSETS.md根目录同时收录源码构件和设计方案构件给代码示例设计给流程文档新增资产第一时间更新清单第二步改造AI的工作流程支持两层复用改造 3 个核心 skill让 AI 同时识别、推荐、校验源码复用和设计复用。2.1改造「reusing skill」复用提取原有问题只支持提取源码组件不支持登记设计方案改造方案新增双资产模式——提取源码构件、沉淀设计方案、统一登记核心工作流模式判断提取源码构件 / 沉淀设计方案 / 登记已有资产源码模式从重复代码提取公共组件设计模式从相似流程提炼通用处理机制、设计模式登记模式录入清单完成兼容性验证2.2改造「bug-fixer skill」Bug修复原有问题修复时只查源码组件忽略设计复用改造方案新增双重复用检查查复用清单优先复用现有源码构件查设计资产优先复用成熟处理机制界面/流程类Bug优先复用对应源码组件设计方案2.3改造「update-backreview skill」变更评审原有问题评审只查代码重复忽略设计重复改造方案强化双重复用校验源码复用检查是否使用现有公共组件设计复用检查是否复用成熟处理流程、设计模式新增资产检查新组件/新设计是否登记到清单第三步形成循环机制两层复用常态化开发前开发者要做文件预览功能AI查复用清单 → 推荐 DocPreview 构件 通用预览设计方案AI提供代码示例 流程说明开发中无适配资产 → 提取源码组件、沉淀设计方案完成后 → 自动登记到复用清单修复Bug修复前 → 先查源码构件、再查设计方案避免重复编码、重复设计代码评审检查是否复用源码构件检查是否复用成熟设计机制检查新增资产是否登记实践成果源码复用消除不一致之前3个页面各自实现预览代码重复、体验混乱现在统一用 DocPreview 组件代码唯一、体验一致设计复用统一处理逻辑沉淀“多格式文件预览”通用机制新页面直接套用流程避免重复设计、逻辑差异、Bug反复资产清单完整登记7个源码组件、3个通用设计方案构件有代码、设计有文档新人上手快流程闭环提取 → 沉淀 → 登记 → 推荐 → 评审两层复用全闭环文档预览组件使用示例源码复用//方式1路径预览openDocPreview({type:path,path:/path/to/document.docx,name:需求文档.docx});//方式2本地文件预览openDocPreview({type:file,file:fileObject,name:file.name});总结核心要点复用分两层源码级复用构件 设计级复用机制/模式缺一不可资产先沉淀建立统一清单同时收录源码构件和设计方案流程要嵌入复用检查融入开发、修复、评审全流程AI强执行AI负责扫描、推荐、校验人做最终决策闭环才持久提取→沉淀→登记→推荐→评审循环迭代软件复用不是简单“省代码”而是省设计、省时间、提质量、降风险。支持两层复用AI 才能真正帮团队把复用做到极致。