编程开发 通用 中文 English 架构评审 [spec] 以资深软件架构师的身份审计此仓库的架构。只读:这会产出一份报告,绝不生成 diff。始终… 生成后的提示词 以资深软件架构师的身份审计此仓库的架构。 只读:这会产出一份报告,绝不生成 diff。每项论断都必须可追溯到 file:line 或经测量的数字——准确性比数量更重要。 ## 先定义范围 在阅读任何代码之前,陈述全部四项: 1. **目标** - 整个仓库,还是特定模块/目录/服务?如果仓库很大,提出价值最高的切片(核心逻辑、公共 API 表面、所有权变更最频繁的代码行)并论证该取舍。 2. **平台与技术栈** - 语言、框架、构建工具,以及这是 monorepo、服务网格、库还是应用程序。 3. **范围内的输入** - 源代码、测试、构建/配置、调度器和 CI 定义、文档/ADR。列出你纳入的内容。 4. **范围之外** - 功能缺陷排查、深入的安全和性能审计(它们有各自的提示词),以及任何代码变更。仅进行审计性阅读。 ## 产出内容 1. **评分卡** - 下方每个维度一个分数(0-10),外加一个单一的总体架构分数。锚点:9-10 生产级;7-8 扎实但存在特定薄弱点;5-6 可用但脆弱;3-4 需要返工;0-2 基础性损坏。每个分数都附带 file:line 或经测量的依据——不允许裸数字。 维度(互不重叠——任何发现都不重复计数): 1. 结构与模块化 - 组件规模、单体、上帝组件、应在何处拆分/合并/迁移。 2. 耦合与依赖方向 - 依赖方向、循环依赖、隐藏/紧密耦合、边界纪律。 3. 抽象与关注点分离 - 低劣或有泄漏的抽象、所有权清晰度、偶然复杂性。 4. 重复与死代码 - 重复或碎片化的功能;占位、过时或冗余代码。 5. 可维护性与技术债 - 变更成本高低、债务热点。 6. 测试 - 关键路径覆盖率、测试健康状况、未测试代码的风险。 7. 文档 - 架构文档、README、文档与行为之间的漂移。 8. 生产就绪度 - 错误处理、安全态势、性能风险、可扩展性、可观测性。 2. **发现报告** - 每项发现使用同一模板:严重性(Critical/Major/Minor)、证据(file:line 以及证明它的阅读内容)、影响(什么会坏以及谁承担代价)、建议修复(最小第一步,而非重写)。Major/minor 都使用同一模板——严重性不同,细节不因此不同。 3. **架构地图** - 真实边界:模块/包/服务、入口点、依赖方向以及任何循环。这是报告其余部分所依托的共享图景。 4. **主要问题** - 最多十个,按序排列,每个都可追溯到一项发现。 5. **重构路线图** - 按优先级排序:立即修复(阻碍当前工作或有事件风险)、安排处理(有真实成本,但不紧急)、接受并记录。不要大爆炸式重写;每个条目都要指明第一个增量以及如何验证。 ## 方法 1. **先绘制地图** - 在评判任何组件之前,先识别边界和依赖图。孤立阅读组件必然会被误判。 2. **先测量再下结论** - 为仓库建立基线:最大文件和函数、每个模块的 LOC、测试数量和关键路径覆盖率、构建时间。优先使用测量信号而非形容词。 3. **阅读实际代码** - 对每个候选发现,追踪进出调用;通过阅读边的两端来确认耦合论断。 4. **验证影响** - 只保留具有可观察成本的发现:触及该区域的缺陷报告、缓慢步骤、反复出现的变通方案。丢弃没有证明成本的条目。 5. **报告,绝不修复** - 只记录发现。不要重构、重命名或重新格式化。 ## 验证 - [ ] 在阅读任何代码之前已陈述范围(目标、平台、输入、范围之外)。 - [ ] 每个评分卡分数都附带 file:line 或经测量的依据。 - [ ] 每项发现都使用 Severity/Evidence/Impact/Fix,且证据指明具体的 file:line。 - [ ] 主要问题最多十个,每个都可追溯到一项发现。 - [ ] 路线图按风险排序;每个条目都从增量开始,而非重写。 - [ ] 已扫描并确认无问题的内容也要报告,而不只是报告问题。 - [ ] 未修改任何代码、配置或文档——报告是唯一输出。 ## 规则 - 绝不要修改、移动或删除代码——此任务只产出一份报告。 - 绝不要报告没有 file:line 或测量痕迹的发现;无法证明的怀疑放入单独的“需要确认”列表。 - 绝不要将一个问题计入多个维度;每项发现只映射到恰好一个维度。 - 绝不要凑数——五项已验证的发现胜过四十项推测性的发现。 - 绝不要提议重写;修复必须是增量且可验证的。 复制提示词 分享提示词 查看示例 发送到 AI 优化器 收藏模板 保存当前版本 示例 关闭 分享 卡片风格 雾面玻璃 暖白纸笺 深夜蓝图 薄荷网格 珊瑚日落 水墨笺 关闭 图片仅展示节选。