Gomboc 代码修复技能

面向任意代码库的确定性、可直接合并的代码修复方案。

Gomboc.ai 社区版会自动扫描并修复整个代码库中的问题——涵盖基础设施、应用程序、配置文件等——全部基于确定性 AI（无幻觉）。本技能将 Gomboc 的能力封装进智能体工作流、CLI 工具及 CI/CD 流水线中，是自主编码（agentic coding）的理想补充。

功能概述

• 扫描任意代码库中的问题（基础设施、应用代码、配置文件等）
• 生成确定性、可直接合并的 Pull Request 修复补丁
• 持续修复：通过 GitHub Actions 或交互式 CLI/MCP 自动执行
• 高可信度：修复采纳率超 94%，且零幻觉（基于 ORL Engine）
• 与智能体协同：确定性修复能力完美适配各类自主编码系统

支持的语言与框架

• 基础设施即代码（IaC） — Terraform、CloudFormation、Kubernetes YAML
• 配置文件 — JSON、YAML、HCL
• 安全问题检测 — 覆盖任意类型代码库（IaC、应用代码、配置文件等）
• 持续扩展 — 持续新增更多语言与框架支持

快速入门

1. 获取 Token

# 在 https://app.gomboc.ai 注册（免费，社区版）
# 在 Settings 中生成 Personal Access Token
export GOMBOC_PAT="gpt_your_token"

2. 扫描代码

python scripts/cli-wrapper.py scan --path ./src

3. 生成修复补丁

python scripts/cli-wrapper.py fix --path ./src

4. 应用修复（可选）

python scripts/cli-wrapper.py remediate --path ./src --commit

核心特性

✅ 确定性 AI — 每次运行结果一致，无幻觉 ✅ 94%+ 准确率 — 可直接合并的修复补丁，用户实际采纳率高 ✅ 永久免费 — Gomboc.ai 社区版 ✅ 生产就绪 — 经过真实场景验证的稳定实现 ✅ 安全设计优先 — 无 Token 泄露风险，具备完善的错误处理机制 ✅ 智能体友好 — 完美支持自主式代码改进闭环

CLI 命令

scan

检测代码库中的问题

gomboc scan path:./terraform
gomboc scan path:./src policy:aws-cis format:markdown

fix

生成可直接合并的修复补丁

gomboc fix path:./terraform format:pull_request
gomboc fix path:./src format:json

remediate

直接将修复补丁应用至代码

gomboc remediate path:./src commit:true
gomboc remediate path:./terraform commit:true push:true

config

管理认证配置

gomboc config --show-token

面向智能体（Agents）的使用场景

本技能专为增强自主编码能力而设计，是理想的配套修复组件：

• 确定性 — 修复行为可靠、可重复
• 高可信度 — 超 94% 的修复补丁被原样合并
• 全自主化 — 智能体可独立完成扫描、生成与应用修复，无需人工干预
• 持续化 — 天然适配长期运行的代码质量改进闭环

集成方式

1. MCP Server（面向智能体）

启动 MCP Server，实现与智能体的交互式集成：

docker-compose -f scripts/docker-compose.yml up
# Server 运行于 http://localhost:3100

详情请参阅 references/mcp-integration.md。

2. CLI 工具（面向开发者）

使用 Python CLI 在本地执行扫描与修复：

export GOMBOC_PAT="your_token"
python scripts/cli-wrapper.py scan --path ./src

详细操作说明请参阅 references/setup.md。

3. GitHub Actions（CI/CD 集成）

在 CI/CD 流水线中自动化执行持续修复：

- uses: gomboc-action@v1
  with:
    path: ./terraform
    auto-fix: true

配置方法详见 references/github-action.md。

配置方式

所有配置均通过环境变量完成：

安全与审计

本技能已完成以下安全验证：

• ✅ Token 管理已通过安全审计
• ✅ 已对接真实运行的 Gomboc API 进行验证
• ✅ 已使用真实漏洞样本完成测试
• ✅ 已确认达到生产就绪标准

完整审计详情请参阅 SECURITY.md。

支持与文档

• 安装指南： references/setup.md
• MCP 集成说明： references/mcp-integration.md
• GitHub Actions 配置： references/github-action.md
• 安全审计报告： SECURITY.md
• 更新日志： CHANGELOG.md
• GitHub Issues / 讨论区： https://github.com/Gomboc-AI/gomboc-ai-feedback/discussions

许可证

MIT License — 详见 LICENSE 文件

准备开始修复了吗？请从上方“快速入门”部分开始，再根据您的工作流选择合适的集成方式进一步探索。