什么是 PactKit?
PactKit 是一个治理框架,在人类与 AI 智能体之间执行 P.A.C.T. 治理契约。它将开发工作流、角色定义和行为规则编译为可执行的宪章和剧本,适用于 Claude Code、OpenCode、Codex CLI 等主流 AI 编程工具。
名称由来: Pact(契约)+ Kit — 治理契约工具包。
核心理念: CODE 即法则。Data 即真相。Prompt 只是指令。AI 只做创造。
| 原则 | 边界 | |
|---|---|---|
| P — Prompt | 只是指令 | 告诉 AI 怎么做 — 定义流程,不定义状态 |
| A — AI | 只做创造 | 格式化、摘要、语言 — 不做确定性逻辑 |
| C — Code | 即法则 | 确定性操作的唯一执行者 — 不可绕过 |
| T — Truth | Data 即真相 | 所有判断的事实基础 — 不靠记忆,不靠推测 |
一览
| 25 个 CLI 子命令 | 确定性操作以代码执行,而非 prompt 委派 |
| 9 个 Agent | 具有受限工具的专业化角色 |
| 11 个 Command | 以 PDCA 为核心的工作流入口 |
| 10 个 Skill | Visualize、Board、Scaffold、Trace、Draw、Analyze 等 |
| 8 条 Rule | 模块化宪章规则(2 条核心 + 6 条按需加载) |
支持的 AI 工具
| 工具 | 格式 | 命令 | 安装包 |
|---|---|---|---|
| Claude Code | Classic | pactkit init | pactkit(已包含所有适配器) |
| Claude Code Plugin | Plugin | Marketplace 安装 | — |
| OpenCode | OpenCode | pactkit init | pactkit(已包含所有适配器) |
| Codex CLI | Codex | pactkit init | pactkit(已包含所有适配器) |
| GitHub Copilot | Copilot | pactkit init --format copilot | pactkit + 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 CLIpip 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下一步
- P.A.C.T. 治理哲学 — 这个名字背后的治理契约
- 安装 — 部署模式和选项
- PDCA+ 工作流 — 基于规格驱动的开发生命周期
- Agent 集成 — 9 个专业化 Agent
- 命令参考 — 11 个命令 + 10 个技能
- GitHub Copilot — Copilot 项目级部署指南