coding-standards

问题

AI 生成的代码通常能在本地运行，却不符合团队特定的审查要求：

Corbat 会在实现前向 Agent 提供团队标准，并提供验证工具，供审查或交接前使用。

快速开始

1. 添加到 MCP 配置中：

{
  "mcpServers": {
    "corbat": {
      "command": "npx",
      "args": ["-y", "@corbat-tech/coding-standards-mcp"]
    }
  }
}

2. 配置文件位置：

常见兼容 MCP 的工具请参阅完整设置指南

3. 完成。 Corbat 可以自动检测你的技术栈并返回相应标准。

零开销。 Corbat 在本地运行，检测技术栈耗时约 50 ms。之后，它只会为 AI 提供上下文。

完全可自定义。 不喜欢某条规则？可在 .corbat.json 中覆盖。跳转到自定义 →

实际效果

You: "Create a user registration service"

不使用 Corbat，你会得到：

class UserService {
  private users: Map<string, User> = new Map();

  register(name: string, email: string, password: string) {
    if (!name || !email || !password) throw new Error('Invalid input');
    const user = { id: crypto.randomUUID(), name, email, password };
    this.users.set(user.id, user);
    return user;
  }
}
// ✗ Hardcoded storage  ✗ Password in plain text  ✗ Generic error  ✗ No tests

使用 Corbat，你会得到：

// Domain
interface UserRepository {
  save(user: User): Promise<void>;
  findByEmail(email: string): Promise<User | null>;
}

class EmailAlreadyExistsError extends Error {
  constructor(email: string) {
    super(`Email already registered: ${email}`);
  }
}

// Application
class RegisterUserUseCase {
  constructor(
    private readonly repository: UserRepository,
    private readonly hasher: PasswordHasher
  ) {}

  async execute(input: RegisterUserInput): Promise<User> {
    const existing = await this.repository.findByEmail(input.email);
    if (existing) throw new EmailAlreadyExistsError(input.email);

    const user = User.create({
      ...input,
      password: await this.hasher.hash(input.password)
    });
    await this.repository.save(user);
    return user;
  }
}
// ✓ Repository interface  ✓ Password hashing  ✓ Custom error  ✓ Testable

// Test included
describe('RegisterUserUseCase', () => {
  const repository = { save: vi.fn(), findByEmail: vi.fn() };
  const hasher = { hash: vi.fn() };
  const useCase = new RegisterUserUseCase(repository, hasher);

  beforeEach(() => vi.clearAllMocks());

  it('should hash password before saving', async () => {
    repository.findByEmail.mockResolvedValue(null);
    hasher.hash.mockResolvedValue('hashed_password');

    await useCase.execute({ name: 'John', email: '[email protected]', password: 'secret' });

    expect(hasher.hash).toHaveBeenCalledWith('secret');
    expect(repository.save).toHaveBeenCalledWith(
      expect.objectContaining({ password: 'hashed_password' })
    );
  });

  it('should reject duplicate emails', async () => {
    repository.findByEmail.mockResolvedValue({ id: '1', email: '[email protected]' });

    await expect(
      useCase.execute({ name: 'John', email: '[email protected]', password: 'secret' })
    ).rejects.toThrow(EmailAlreadyExistsError);
  });
});

这就是 Corbat 要求 Agent 在交接前考虑的结构。

Corbat 提供的功能

Corbat 会在生成前提供这些护栏，并在迭代过程中执行验证检查：

代码质量

架构

错误处理

面向安全的检查

基准测试结果 v3.0

我们在 6 种语言的 15 个场景中评估了 Corbat。主要基准测试报告的结果不一，应如实看待：按原始汇总分数，Corbat 在 15 个场景中赢得了 1 个；而另一种价值分析则发现，代码精简度和可维护性方面表现更佳。

数据支持的结论

最明显的观察结果是，使用 Corbat 指导生成的输出通常更精简、更聚焦：

这不足以证明质量普遍提升，但表明在某些工作流中，标准上下文可以减少过度生成。

价值指标

价值报告对同一数据集进行了重新加权，更侧重效率和可维护性：

📊 详细价值分析

安全：未发现基准测试模式问题

我们使用受 OWASP Top 10 类别启发的模式检查分析了每个场景。这不能替代 SAST、DAST、依赖项扫描、人工审查或威胁建模。

• 未检测到 SQL／NoSQL 注入模式
• 未检测到 XSS 模式
• 未检测到硬编码凭据
• 边界处存在输入验证模式
• 基准测试样例中的错误消息未暴露堆栈跟踪

测试的语言与模式

📖 完整基准测试方法 · 价值分析

内置配置文件

Corbat 会自动检测你的技术栈，并应用相应的规范：

自动检测： Corbat 会读取 pom.xml、package.json、go.mod、Cargo.toml 等文件。

何时使用 Corbat

何时可能不需要 Corbat

• 不在意质量的快速原型
• 写完就会丢弃的一次性脚本
• 希望通过犯错来学习的项目

自定义

选项 1：交互式设置

npx corbat-init

检测你的技术栈，并使用合理的默认值生成 .corbat.json。

选项 2：手动配置

在项目根目录中创建 .corbat.json：

{
  "profile": "java-spring-backend",
  "architecture": {
    "pattern": "hexagonal",
    "layers": ["domain", "application", "infrastructure", "api"]
  },
  "quality": {
    "maxMethodLines": 20,
    "maxClassLines": 200,
    "minCoverage": 80
  },
  "rules": {
    "always": [
      "Use records for DTOs",
      "Prefer Optional over null"
    ],
    "never": [
      "Use field injection",
      "Catch generic Exception"
    ]
  }
}

选项 3：使用模板

浏览 14 个可直接使用的模板，涵盖 Java、Python、Node.js、React、Go、Rust 等。

工作原理

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Your Prompt │────▶│ Corbat MCP  │────▶│ AI + Rules  │
└─────────────┘     └──────┬──────┘     └─────────────┘
                          │
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
    ┌────────────┐ ┌────────────┐ ┌────────────┐
    │ 1. Detect  │ │ 2. Load    │ │ 3. Inject  │
    │   Stack    │ │  Profile   │ │ Guardrails │
    └────────────┘ └────────────┘ └────────────┘
     pom.xml        hexagonal      max 20 lines
     package.json   + DDD          + interfaces
     go.mod         + SOLID        + custom errors

Corbat 不会修改 AI 的输出。它提供上下文、规范、配置文件和验证反馈，帮助 Agent 符合你的审查预期。

重要提示： 实际代码质量取决于模型、宿主工具、提示词、仓库上下文、测试和人工审查。请将 Corbat 视为策略与验证层，而非生产就绪的保证。

文档

{ "mcpServers": { "corbat": { "command": "npx", "args": ["-y", "@corbat-tech/coding-standards-mcp"] }}}