PactKit

什么是 PactKit?

PactKit 是一个治理框架,在人类与 AI 智能体之间执行 P.A.C.T. 治理契约。它将开发工作流、角色定义和行为规则编译为可执行的宪章剧本,适用于 Claude CodeOpenCodeCodex CLI 等主流 AI 编程工具。

名称由来: Pact(契约)+ Kit — 治理契约工具包。

核心理念: CODE 即法则。Data 即真相。Prompt 只是指令。AI 只做创造。

原则边界
P — Prompt只是指令告诉 AI 怎么做 — 定义流程,不定义状态
A — AI只做创造格式化、摘要、语言 — 不做确定性逻辑
C — Code即法则确定性操作的唯一执行者 — 不可绕过
T — TruthData 即真相所有判断的事实基础 — 不靠记忆,不靠推测

一览

25 个 CLI 子命令确定性操作以代码执行,而非 prompt 委派
9 个 Agent具有受限工具的专业化角色
11 个 Command以 PDCA 为核心的工作流入口
10 个 SkillVisualize、Board、Scaffold、Trace、Draw、Analyze 等
8 条 Rule模块化宪章规则(2 条核心 + 6 条按需加载)

支持的 AI 工具

工具格式命令安装包
Claude CodeClassicpactkit initpactkit(已包含所有适配器)
Claude Code PluginPluginMarketplace 安装
OpenCodeOpenCodepactkit initpactkit(已包含所有适配器)
Codex CLICodexpactkit initpactkit(已包含所有适配器)
GitHub CopilotCopilotpactkit init --format copilotpactkit + pactkit-copilot(独立包,项目级
Trae即将支持

GitHub Copilot 与其他 IDE 不同:它部署到项目的 .github/ 目录(而非用户级 ~/ 路径),因此每个项目都需要单独执行 pactkit init --format copilot。详见 GitHub Copilot

v2.9.0 起,pip install pactkit 已包含 Claude Code、OpenCode 和 Codex CLI 适配器。执行 pactkit init 默认部署这三个 IDE 配置。如需仅部署单个 IDE,可使用 --format 参数。

快速开始

pip install pactkit
pactkit init

需要 Python 3.10+。默认部署全部 IDE 配置:Claude Code(~/.claude/)、OpenCode(~/.config/opencode/)、Codex CLI(~/.codex/)。

如需仅部署单个 IDE:

pactkit init --format opencode  # 仅 OpenCode
pactkit init --format codex     # 仅 Codex CLI
pip install pactkit pactkit-copilot
cd your-project
pactkit init --format copilot

需要独立安装 pactkit-copilot。部署到项目 .github/每个项目都需要执行。然后在 IDE 中使用 /project-init。详见 GitHub Copilot

# 在 Claude Code 中:
/plugin marketplace add pactkit/claude-code-plugin
/plugin install pactkit

无需 Python。重启 Claude Code 即可使用。

Trae 适配正在开发中,敬请期待。

然后开始使用命令:

/project-plan "添加用户认证"
/project-act STORY-001
/project-check
/project-done

下一步

目录