tribunal doctor        # interactive
tribunal doctor --json # for CI

Tribunal — 使用指南

Tribunal 是一个 Claude Code 质量强制插件。安装后（pip install tribunal && tribunal init），它会挂钩到每一次文件写入、测试运行和代理交互中。

核心命令

tribunal status

显示当前配置、钩子健康状态和审计摘要。 bash tribunal status tribunal status --json

tribunal doctor

预检健康检查——所有钩子、依赖项、.claude/ 连接。 bash tribunal doctor # 交互式 tribunal doctor --json # 用于 CI

退出码 1 = 存在故障。按照 ✗ 建议进行修复。

tribunal ci — 独立质量门禁

无需 Claude Code 即可运行所有检查。用于 CI 流水线。 bash tribunal ci # 检查 git diff 的文件 tribunal ci src/payments.py # 指定文件 tribunal ci --json # 机器可读报告 tribunal ci --coverage-threshold 80 # 覆盖率低于 80% 则失败

退出码：0 = 全部通过 · 1 = 失败 · 2 = 仅警告

tribunal init — 项目设置

bash tribunal init # 交互式向导 tribunal init --non-interactive # CI/代理使用，合理默认值 tribunal init --project-dir /path # 指定目标目录

质量模式

通过 CLAUDECODEMODE 环境变量控制每个会话的强制级别：

模式	强制方式	TDD	覆盖率
code（默认）	严格——失败时阻止	阻止	80%
code--chill

建议——仅警告 | 警告 | 60% |
| 自定义 | 在 tribunal/modes/<名称>.json 中配置 | 可配置 | 可配置 |

在任何模式 JSON 中添加 tribunal 块：
json
{
tribunal: {
tddEnforcement: advisory,
secretScanning: true,
coverageThreshold: 70,
blockOnFail: false
}
}

钩子事件

Tribunal 拦截以下 Claude Code 生命周期事件：

事件	钩子	功能
PreToolUse（写入/编辑）	filechecker	密钥、语言质量、路径遍历
PostToolUse（Bash）

tddenforcer | 测试通过/失败、覆盖率阈值 |
| Stop | context_monitor | 上下文窗口即将填满时发出警告 |
| TeammateIdle | teammate_idle | 如果子代理留下损坏代码则阻止编排器 |
| TaskCompleted | task_completed | 在标记完成前审计子代理会话 |
| SessionEnd | session_end | 将会话摘要写入审计日志 |

插件包

bash
tribunal list-packs # 浏览注册表
tribunal install python-strict # 90% 覆盖率、类型提示、文档字符串
tribunal install go-tdd # go test -cover、go vet、-race 标志
tribunal install nextjs-quality # TypeScript 严格模式、组件测试、可访问性
tribunal install https://github.com/org/custom-pack # 直接 URL
tribunal install ./local-pack/ # 本地目录

MCP 集成

Tribunal 暴露了任何 Claude Code 会话均可查询的 MCP 工具：

tribunal_status — 当前钩子配置、模式、版本
tribunal_audit — 最近的审计条目（可按结果/代理筛选）
tribunalcheckfile — 对任意路径运行 file_checker
tribunalagentsummary — 特定 agent_id 的质量摘要

通过指向 Tribunal MCP 服务器的 Claude Code MCP 连接器使用。

代理团队质量门禁

在多代理工作流中，Tribunal 在代理之间设置质量门禁：

编排器 → 生成子代理 A
子代理 A 写入文件
TeammateIdle 触发 → tribunal 检查 A 的文件
✅ 通过 → 编排器继续
❌ 失败 → 编排器被阻止，直到 A 修复问题

在 tribunal/rules/multi-agent-quality.md 中配置（自动注入）。

审计日志

所有钩子事件记录到 .tribunal/audit.jsonl：
bash
cat .tribunal/audit.jsonl | jq .[] | select(.outcome==blocked)

字段：timestamp、hookname、filepath、outcome、durationms、agentid、detail

上下文监控阈值

在 tribunal/settings.json 中配置：
json
{
contextMonitor: {
warnThreshold: 80,
handoffThreshold: 90
}
}

设置 CLAUDECONTEXTWINDOW=1000000 环境变量以使用 100 万上下文窗口（阈值自动缩放）。

VS Code 扩展

安装后，在项目中打开 VS Code。Tribunal 扩展：

• - 在状态栏显示 🏛 通过 / 🏛 1 个警告 / 🏛 2 个阻止
• 钩子触发后，在每个文件旁添加边栏图标（✅/⚠️/⛔）
• 将钩子事件流式传输到 Tribunal 输出通道
• 自动读取 .tribunal/audit.jsonl

实时仪表板

bash

启动 Claude Code 会话后在浏览器中打开

open tribunal/ui/viewer.html

显示：实时钩子流、上下文仪表盘、会话统计、可筛选的审计日志。

完整文档：https://tribunal.dev · GitHub：https://github.com/thebotclub/tribunal