BugX

Version 0.9.16

BugX 是一个给 AI 编程宿主使用的 Bug 审计 Agent。它负责规划测试、检查证据、确认问题并生成报告；真正的代码阅读和命令执行仍由 AI 宿主完成。

使用

准备好 bugx 命令后，进入要审计的项目目录，发现可用的 AI 宿主并启用 BugX：

bugx agent discover --root . --json
bugx install --root .

也可以指定宿主：

bugx install --root . \
  --agent opencode --agent codex --agent claude --agent cline \
  --agent zcode --agent pi --non-interactive

安装后，在对应宿主中选择 BugX，然后让它审计当前项目。例如：

• OpenCode：输入 @bugx
• Claude Code：选择 bugx Agent
• Codex：选择 bugx Skill
• Pi：使用 .pi/skills/bugx/SKILL.md

常用命令

# 检查安装
bugx doctor --root . --installation-only

# 启动本地 MCP Supervisor（宿主需要时使用）
bugx mcp serve --root . --role host

# 查看帮助和版本
bugx --help
bugx --version

审计结果和运行状态默认保存在项目的 .bugx/ 目录中。不要把其中可能包含项目代码片段的文件提交到公开仓库。

卸载

只移除当前项目中的 BugX：

bugx uninstall --root .

执行前可先用 --dry-run 查看将要删除的内容。

开发

每次提交代码都必须同步更新受影响文档并递增补丁版本；需要跨补丁版本变更时，显式使用 --confirm-version-transition。

python3 -m unittest -q tests.test_jenkinsfile tests.test_consistency
python3 scripts/bump_version.py --check