用途:面向已存在的参考实现,逆向梳理其架构、数据流、隐私态势、耦合关系、质量特性,产出可复用的设计文档或规格。适用场景包括:需要理解参考实现以获得设计灵感;为同一问题域撰写 PRD 或设计文档;输出须为净室成果(不从参考代码库复制任何源码);在本地优先、隐私优先、自托管等不同架构约束下重新设计;从代码证据中提取隐式契约(存储层操作),设计正式的 provider 抽象;评估架构健康度、耦合、模块化、数据归属或边界变更准备度。
主要能力与流程:一、用浅克隆获取仓库,映射顶层目录结构与语言/框架归属;二、按行数排序找出核心文件,优先阅读入口、数据模型、核心服务、UI、配置及涉及用户数据的隐私敏感文件;三、梳理各核心服务的采集、处理、存储位置与外部依赖、隐私画像,并用 Mermaid(```mermaid)绘制云/本地边界图;三b、需要提取 DAO/provider 契约时,先读 PHILOSOPHY/DESIGN/README,编目全部存储操作(节点/边 CRUD、向量 KNN、图遍历、维护、事务),识别双写、降级链等边界泄漏信号,据此设计抽象接口,并用双 provider 验证;四、盘点面向用户的功能面;五、撰写净室规格,用自然语言描述组件交互,不得包含任何参考源码片段;六、在新约束下重构设计,为云端依赖给出本地替代与开放标准;七、交付后做链接、图渲染、代码污染与交叉引用 QA。
关键用法与命令:安装与运行方式资料未提供,未给出安装命令。必要命令保持原样,例如:git clone --depth=1 https://github.com/owner/repo /tmp/target-repo;ls -la /tmp/target-repo/;find /tmp/target-repo -type f -name ".swift" | sort;wc -l /tmp/target-repo/**/.swift 2>/dev/null | sort -n。所有图必须用 ```mermaid 代码块,禁止 ASCII 框线图与图片文件。
限制:不适用于全新或前瞻性架构设计(应转 software-architecture)、直接代码评审、缺陷排查或安全审计;API/接口语义转 api-design-and-evolution,数据平台策略转 data-architect,部署底座转 platform-engineering,跨系统迁移执行转 migration-engineering。每条主张须标注为已观察、推断、报告或未知并附证据,不得把缺失观察直接当作缺陷。未获额外授权前,应止于产出架构制品,不提出实现或迁移执行。资料未提供具体收费、价格、平台与效果信息。