tractorjuice/arc-kit · 上手攻略
- 仓库：tractorjuice/arc-kit
- 链接：https://github.com/tractorjuice/arc-kit
- 分类：enterprise-architecture / ai-agent-workflow
- 作者：Tom
- 更新：2026-08-09
是什么
ArcKit（Enterprise Architecture Governance Harness）是一套面向企业架构师和 AI 编程助手用户的开源工具包，将企业架构治理从散落的文档、Word、表格、邮件中抽离出来，变成系统性、AI 辅助的工作流。
它以 Claude Code 插件形式发布，提供 75 条官方命令，覆盖战略规划、利益相关者分析、风险评估（HM Treasury Orange Book）、业务案例论证（HM Treasury Green Book SOBC）、Wardley Mapping、Mermaid 架构图生成、供应商 RFP 管理等企业架构全生命周期。目前托管在 tractorjuice/arckit-claude（新地址）和 tractorjuice/arc-kit（兼容地址）两个仓库。
解决什么问题
企业架构治理普遍存在三大痛：文档散乱（策略/设计/交付/保证各自为政）、AI 助手不懂企业语境（缺乏标准框架）、合规审计难以追溯。
ArcKit 的解法：用结构化命令把 TOGAF ADM、UK Government Digital Service、HM Treasury 框架直接嵌入 AI 助手工作流，AI 在写文档、做分析时自动带上架构原则和治理语境。
快速安装
Claude Code（主要平台，推荐体验最完整）
# 确保 Claude Code 最新版（v2.1.219+ 才支持插件系统）
claude install latest
# 添加插件市场
claude plugin marketplace add tractorjuice/arckit-claude
# 安装核心包（75 条命令，英国政府 civilian + 通用企业）
claude plugin install arckit@arckit-claude
扩展覆盖包（按需叠加）：
# 阿联酋联邦
claude plugin install arckit arckit-uae
# 广覆盖（UK + UAE + FR + CA + EU + AT + AU + US + UK-NHS + UK-GCloud）
claude plugin install arckit arckit-uae,arckit-fr,arckit-ca,arckit-eu,arckit-at,arckit-au,arckit-us,arckit-uk-nhs,arckit-uk-gcloud
# TOGAF ADM + AI Agent 架构专项
claude plugin install arckit arckit-togaf-adm arckit-agent-architecture
Gemini CLI
gemini extensions install https://github.com/tractorjuice/arckit-gemini
GitHub Copilot（VS Code）
pip install git+https://github.com/tractorjuice/arc-kit.git
arckit init my-project --ai copilot
Codex CLI
# pip
pip install git+https://github.com/tractorjuice/arc-kit.git
# 或 uv
uv tool install arckit-cli --from git+https://github.com/tractorjuice/arc-kit.git
# 或直接运行（不安装）
uvx --from git+https://github.com/tractorjuice/arc-kit.git arckit init my-project
Mistral Vibe CLI
git clone https://github.com/tractorjuice/arckit-vibe.git
cd arckit-vibe
mkdir -p ~/.vibe/extensions/
ln -s $(pwd) ~/.vibe/extensions/arckit
核心用法
架构全生命周期七阶段
ArcKit 命令覆盖架构生命周期的主要阶段（参考 TOGAF ADM）：
| 阶段 | 代表命令 | 功能 |
|---|---|---|
| 战略规划 | /arckit-strategy |
Wardley Mapping、价值流分析 |
| 架构原则 | /arckit-principles |
架构原则制定与执行 |
| 利益相关者分析 | /arckit-stakeholders |
驱动因素 → 目标 → 成果映射 |
| 风险评估 | /arckit-risk |
HM Treasury Orange Book 框架 |
| 业务案例 | /arckit-business-case |
HM Treasury Green Book SOBC |
| 技术研究 | /arckit-tech-research |
Build vs Buy 分析，网页搜索 |
| 设计评审 | /arckit-design-review |
HLD/DLD 格式评审 |
典型使用示例
# 建立架构原则
claude: /arckit-principles "建立云迁移的架构原则"
/# 利益相关者分析
claude: /arckit-stakeholders "分析某省级政务云项目的利益相关者"
/# 风险评估（HM Treasury Orange Book）
claude: /arckit-risk "对某数据平台项目进行风险登记"
/# 生成 Mermaid 架构图
claude: /arckit-architecture-diagram "绘制微服务架构图，包含 API Gateway、Auth Service、Order Service"
/# Wardley Mapping
claude: /arckit-wardley-map "某金融科技公司的战略地图"
/# 供应商 RFP 评估
claude: /arckit-vendor-selection "为 ERP 系统选型提供 RFP 评估框架"
/# Azure 特定研究（MCP 工具，Microsoft Learn 权威文档）
claude: /arckit-azure-research "Azure Kubernetes Service 生产环境最佳实践"
内置 MCP 服务器
Claude Code 完整版还带以下捆绑 MCP，无需额外安装： - AWS Knowledge（官方 MCP） - Microsoft Learn（官方 MCP） - Google Developer Knowledge（官方 MCP） - govreposcrape（UK 政府仓库搜索） - uk-tenders（UK 招标信息）
典型适用场景
- 大型组织架构治理标准化：TOGAF ADM 流程自动化，把架构评审从会议移到 AI 辅助文档生成
- 英国/阿联酋联邦政府数字化项目：预置 UK G-Cloud、UAE 联邦合规框架，开箱即用
- 企业架构文档自动化：自动生成架构原则文档、风险登记册、业务案例、HLD/LLD
- 供应商选型与 RFP 管理：结构化 RFP 评估流程，生成买方清单
- AI Agent 系统架构设计：用
arckit-agent-architecture覆盖 AI Agent 治理的专项需求 - Wardley Mapping 战略规划：对技术战略做可视化地图分析
坑与注意
⚠️ Claude Code v2.1.219+ 硬门槛：这是当前唯一完整支持 ArcKit 的客户端平台；旧版 Claude Code 或其他编辑器无法使用插件命令体验。
⚠️ OFFICIAL-SENSITIVE 场景需额外配置：Claude Code v2.1.172+ 才修复了 WebFetch(domain:*.gov.uk) 子域名权限规则，OFFICIAL-SENSITIVE 级英国政府数据需要确认 Claude Code 版本。
⚠️ 插件依赖链：社区覆盖包（arckit-au-energy 等）有依赖链，安装顺序有要求——参考 README 确认先装哪个。
⚠️ arckit-uk-gcloud 许可证特殊：虽然是公开安装的，但采用 proprietary 许可证（非 MIT），不允许分发到非 Claude 扩展格式。
⚠️ 国内企业适配有限：预置框架以 UK Government + UAE 为主，国内企业使用需要理解框架语境后适当调整。
⚠️ 社区插件质量不一：13 个社区插件由社区维护，与核心包的质量标准可能存在差距。
⚠️ 版本可溯源性未公开：README 未标注具体版本号或 changelog，升级前建议先在测试环境验证。
与同类对比
| 工具 | 框架覆盖 | AI 集成深度 | 开源 | 目标用户 |
|---|---|---|---|---|
| ArcKit | TOGAF ADM + UK Gov + UAE + HM Treasury | ✅ 深度（75 条命令 + Agent） | ✅ MIT（核心包） | 企业架构师 + AI 开发者 |
| LeanIX | FABIAN + ARBIZ | ❌ 无 | ❌ 商业闭源 | 企业 EA 团队 |
| Ardoq | TOGAF ADM | ❌ 无 | ❌ 商业闭源 | 企业 EA 团队 |
| C4 Model | C4 模型 | ⚠️ 部分（PlantUML） | ✅ 开源 | 软件架构师 |
| Structurizr | C4 + 代码优先 | ⚠️ 部分 | ⚠️ 部分开源 | 软件架构师 |
ArcKit 的核心差异：唯一将企业架构治理框架与 AI 编程助手深度集成的开源方案，其他工具都是传统 EA 软件而非 AI 工作流插件。
一句话推荐结论
在用 Claude Code 做企业级项目？ArcKit 把架构治理框架直接焊进 AI 工作流，省去大量文档格式化劳动；UK Government + TOGAF 双框架开箱即用。
来源：GitHub README (https://github.com/tractorjuice/arc-kit) · SkillsLLM 目录 · YouTube 评测视频 · GitHub 搜索片段