编程开发 通用 中文 English 代码库审计 [spec] 以资深软件架构师的身份审计此仓库。只读:这会生成报告,绝不生成差异。每项断言都必须追溯到 fi… 生成后的提示词 以资深软件架构师的身份审计此仓库。只读:这会生成报告,绝不生成差异。每项断言都必须追溯到 file:line 或可测量的证据——准确性比数量更重要。 ## 首先定义范围 在阅读任何代码之前,说明以下四项: 1. **目标** - 是整个仓库,还是特定模块、包、服务或目录?如果仓库很大,先确定价值最高的审计边界并说明该边界。 2. **平台与技术栈** - 语言、框架、运行时、包管理器,以及仓库架构(monorepo、微服务、独立应用或库)。 3. **范围内的输入** - 源文件、测试、构建配置、依赖清单、文档和 CI 工作流。 4. **范围外** - 修改代码、格式修复、功能缺陷排查或推测性重构。只读分析。 ## 产出内容 1. **评分卡** - 对以下每个维度按 0-10 评分,并给出总体架构评分。锚点:9-10 生产级;7-8 稳健但存在具体薄弱点;5-6 可用但脆弱;3-4 需要返工;0-2 基础性损坏。每项评分都必须附带 file:line 或可测量的理由: - 整体代码质量 - 架构与系统结构 - 可维护性与技术债务 - 模块化与边界清晰度 - 内聚与耦合 - 关注点分离 - 重复与冗余 - 测试与测试健康状况 - 文档与规范一致性 - 错误处理与韧性 - 安全态势 - 性能与资源效率 - 可扩展性 - 生产就绪度 2. **结构性异味与边界** - 特别识别: - 单体与过大组件 - 系统、子系统、模块、包、服务与边界 - 依赖方向与循环依赖 - 上帝类/函数/组件 - 不良抽象与泄漏边界 - 紧耦合与隐藏依赖 - 重复或碎片化功能 - 所有权/职责不清晰 - 死代码、过时代码、占位代码或冗余代码 - 架构不一致与偶然复杂性 - 应拆分、合并、迁移或重新设计的区域 3. **发现报告** - 对每个主要问题给出严重程度(严重、主要、次要)、证据(file:line 引用与解读)、影响(什么会失效、什么会变慢,或引入了什么风险)以及建议修复(最小首个增量)。 4. **前 10 大问题** - 整个仓库前 10 大问题的排名列表,每项都可追溯到具体发现。 5. **重构路线图** - 按优先级排序:立即修复(直接风险或阻塞项)、安排处理(具有真实维护成本的技术债务)、接受并记录。每项都命名一个具体首个增量。不要修改代码。 ## 方法 1. **先映射边界** - 在评估单个文件之前,识别顶层包、模块、入口点和依赖图。 2. **先测量再下结论** - 建立文件大小、函数长度、依赖关系和测试存在性的基线。优先采用测量事实而非印象。 3. **追踪代码** - 对每个候选发现,追踪调用方与被调用方以确认耦合、泄漏或重复。 4. **验证影响** - 只保留具有可观察维护成本或运行时成本的问题。 5. **仅报告** - 记录带证据的发现。不要编辑、重构或删除代码。 ## 验证 - [ ] 在检查代码之前已说明范围(目标、技术栈、输入、范围外)。 - [ ] 已为所有维度提供 0-10 评分卡,每项都由 file:line 引用或测量支持。 - [ ] 已跨全部 11 个目标区域评估结构性异味与边界。 - [ ] 每个主要发现都使用严重程度、证据、影响和建议修复,并附有具体 file:line 证据。 - [ ] 前 10 大问题已排名并关联到已记录的发现。 - [ ] 重构路线图已按优先级排序,并包含可验证的增量。 - [ ] 未修改任何代码——审计严格只读。 ## 规则 - 绝不修改、删除或重新格式化代码——这仅生成报告。 - 绝不在没有 file:line 证据或可验证追踪的情况下报告发现或评分。 - 绝不用填充内容扩充发现——经验证的架构事实胜过推测性清单。 - 绝不提出大爆炸式重写;修复必须是增量且可验证的。 - 绝不在未满足本规范中每项交付物的情况下接受“完成”。 复制提示词 分享提示词 查看示例 发送到 AI 优化器 收藏模板 保存当前版本 示例 关闭 分享 卡片风格 雾面玻璃 暖白纸笺 深夜蓝图 薄荷网格 珊瑚日落 水墨笺 关闭 图片仅展示节选。