用 S3 Object Lambda 实现实时代码审查，无需 CI 流水线

这个方案适用于团队想在提交代码前就获取 AI 审查建议，但不希望依赖传统 CI/CD 流程的场景。它利用 S3 Object Lambda 在读取文件时自动触发 Lambda 函数，将审查结果直接嵌入返回的对象中。前提是：代码存储在 S3 桶中，团队使用 AWS Bedrock 访问 Claude 模型，且允许在元数据中存储 JSON 格式的审查结果。

核心流程
当开发者通过特定的 Object Lambda 访问点（Access Point）读取代码文件时，请求会先经过一个 Lambda 函数。这个函数负责：

1. 从源 S3 桶中获取原始代码文件
2. 将文件内容发送给 Claude 模型（anthropic.claude-3-sonnet-20240229-v1:0），要求返回逐行审查建议（格式为 JSON 数组）
3. 将审查结果作为自定义元数据（x-amz-meta-claude-review）附加到原始文件内容中，再通过 write_get_object_response 接口返回给客户端

关键限制

• 单个 Access Point 的并发限制为 1000 请求，超过后需申请配额或创建多个访问点
• 文件大小超过 5 MB 时，建议仅审查变更部分，否则可能触发 Claude 的 Token 限制（模型最大输入长度受 max_tokens: 2000 控制）

实施步骤

1. 创建 Object Lambda 访问点
访问点需绑定到已有的 S3 桶访问点（source-bucket-ap），并启用 CloudWatch 指标监控。示例代码中使用了 CreateAccessPointCommand，其中 SupportingAccessPoint 参数指定了原始数据来源：

const cmd = new CreateAccessPointCommand({
  AccountId: "123456789012",
  Name: "code-review-ap",
  ObjectLambdaConfiguration: {
    SupportingAccessPoint: "arn:aws:s3:us-east-1:123456789012:accesspoint/source-bucket-ap",
    CloudWatchMetricsEnabled: true,
  },
});

注意：Access Point 不继承源桶的策略，必须单独授予 Lambda 调用权限（s3-object-lambda:InvokeFunction）和读取源文件权限（s3:GetObject）。

2. 开发 Lambda 函数
函数入口通过 event["getObjectContext"] 获取请求上下文，包括 outputRoute 和 outputToken（用于写回响应）。核心逻辑包括：

• 解析请求 URL 获取文件路径（event["userRequest"]["url"].split("/")[-1]）
• 调用 Claude 模型时，输入格式固定为 Markdown 代码块，输出要求严格为 JSON 数组
• 使用 write_get_object_response 写回文件内容，必须将审查结果放入元数据中，否则客户端无法提取

3. 配置 IAM 权限
Lambda 执行角色需包含三个策略：

• 调用自身权限（s3-object-lambda:InvokeFunction）
• 读取源桶对象（s3:GetObject，资源为 arn:aws:s3:::source-bucket/*）
• 调用 Bedrock 模型（bedrock:InvokeModel，资源为 arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-3-sonnet-20240229-v1:0）

4. 客户端调用
通过 aws s3api get-object 命令读取文件时，需指定 Access Point 的 ARN。审查结果可通过 head-object 命令提取：

aws s3api head-object \
  --bucket arn:aws:s3:us-east-1:123456789012:accesspoint/code-review-ap \
  --key src/main.py \
  --query 'Metadata.x-amz-meta-claude-review'

IDE 集成建议
开发者可在 IDE 中添加插件，监听文件元数据变化。例如，当悬停在代码行上时，插件自动解析 x-amz-meta-claude-review 中对应行的建议（如 {"line": 12, "severity": "warning", "message": "..."}），实现类似 Copilot 的即时反馈。

并发与性能优化

• 并发限制：Object Lambda 的默认并发配额为 1000，如需提升，可在 AWS 支持中心提交请求或创建多个访问点（每个访问点独立计数）。
• 文件大小：对于超过 5 MB 的文件，建议在 Lambda 中实现增量审查逻辑（如仅审查 git diff 的变更部分），避免 Claude 输入 Token 超限。可通过检查文件修改时间或版本标记来判断是否为新增/修改文件。

Lambda 超时设置
函数执行超时时间必须设置为 30 秒以上，否则可能在长文件审查或网络延迟时提前终止。建议设置为 60 秒，以覆盖大部分场景。

不适用场景

• 代码不存储在 S3 中（如 GitHub/GitLab 仓库）
• 团队无法使用 AWS Bedrock 或 Claude 模型
• 需要审查二进制文件（Object Lambda 仅支持文本内容）