Gomboc 代码修复技能

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

Gomboc.ai 社区版会自动扫描并修复整个代码库中的问题——涵盖基础设施、应用程序、配置文件等各类内容，全部基于确定性 AI（无幻觉）。本技能将 Gomboc 的能力封装进智能体工作流（agent workflows）、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 讨论区： https://github.com/Gomboc-AI/gomboc-ai-feedback/discussions

许可证

MIT License — 详见 LICENSE 文件

准备开始修复？ 请从上方“快速入门”开始，随后选择最适合您工作流的集成方式进一步探索。