arc-kit

# ArcKit: 企业架构治理工具 [](https://github.com/tractorjuice/arc-kit/stargazers) [](https://github.com/tractorjuice/arc-kit/network/members) [](LICENSE) [](https://github.com/tractorjuice/arc-kit/releases) [](https://github.com/tractorjuice/arc-kit/issues) [](https://deepwiki.com/tractorjuice/arc-kit)  **通过结构化的策略、设计、交付和保障工作流，构建更好的企业架构。** ArcKit 是一个面向企业架构师的工具包，它将架构治理从分散的文档转变为系统化、人工智能辅助的工作流，适用于： - 🏛️ 建立和执行架构原则 - 👥 分析利益相关者的驱动因素、目标和结果 - 🛡️ 风险管理（英国财政部橙皮书） - 💼 业务案例证明（英国财政部绿皮书 SOBC） - 📋 创建全面的需求文档 - 🗄️ 使用 ERD、GDPR 合规性和数据治理进行数据建模 - 🔬 使用构建与购买分析（基于网络搜索）进行技术研究 - ☁️ 使用 Microsoft Learn MCP 进行特定于 Azure 的研究，以获取权威文档 - 🗺️ 使用 Wardley 映射进行战略规划 - 📊 生成可视化架构图（Mermaid） - 🤝 管理供应商 RFP 和选择过程 - ✅ 进行正式设计审查（HLD/DLD） - 🔧 ServiceNow 服务管理设计 - 🔗 维护需求可追溯性 - 📎 外部文档的引用可追溯性（内联 `[DOC-CN]` 标记和来源引用） ## 星级历史 <a href="https://www.star-history.com/?repos=tractorjuice%2Farc-kit&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=tractorjuice/arc-kit&type=date&theme=dark&legend=top-left&v=20260420" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=tractorjuice/arc-kit&type=date&legend=top-left&v=20260420" /> <img alt="星级历史图表" src="https://api.star-history.com/chart?repos=tractorjuice/arc-kit&type=date&legend=top-left&v=20260420" /> </picture> </a> --- ## 快速入门 ### 安装 **Claude Code** （高级体验）— 安装 ArcKit 插件（需要 **v2.1.172+**）： 首先，确保 Claude Code 是最新版本： ```bash claude install latest ``` 然后在 Claude Code 中： ```text /plugin marketplace add tractorjuice/arc-kit ``` 然后从发现选项卡安装。市场提供了 **13 个插件** — 仅安装您需要的司法管辖区： ```bash # 核心（75 命令 — 英国政府民用 + 通用企业） claude plugin install arckit # 英国 + 阿联酋联邦 claude plugin install arckit arckit-uae # 所有（150 命令，涵盖英国 + 阿联酋 + 法国 + 加拿大 + 欧盟 + 奥地利 + 澳大利亚 + 美国 + 英国 NHS + 英国 G-Cloud） claude plugin install arckit arckit-{uae,fr,ca,eu,at,au,us,uk-nhs,uk-gcloud} ``` 所有 13 个插件都来自同一个 `tractorjuice/arc-kit` 市场。11 个社区插件（`arckit-uae`、`arckit-fr`、`arckit-ca`、`arckit-eu`、`arckit-at`、`arckit-au`、`arckit-au-energy`、`arckit-us`、`arckit-uk-finance`、`arckit-uk-nhs`、`arckit-uk-gcloud`）需要核心 `arckit` 插件。`arckit-au-energy`（部门）还需要 `arckit-au`（司法管辖区），它组成 — 使用 `claude plugin install arckit arckit-au arckit-au-energy` 安装。`arckit-uk-gcloud` 是一个**专有**、仅限 Claude Code 的供应商侧 G-Cloud 投标授权叠加层 — 它不分发到非 Claude 扩展格式。一个**工具插件** — `arckit-fde` — 是一个精简的仅限 Claude Code 的插件，带有单个命令 `/arckit-fde:create`，它在 `docs/`（GitHub Pages 就绪）中生成一个可品牌化的（白色标签）Forward Deploy Engineering 咨询网站，带有英国公共部门和通用市场预设；无依赖项，不转换为非 Claude 格式，无治理文档类型。 > **提示：更轻的市场克隆。** 上面的命令克隆了整个 arc-kit monorepo（约 100 MB），因为它托管了其他五个 AI 助手分发、147 个供应商的 Wardley 地图和研究文档。 要仅获取插件目录，请使用 CLI 市场并添加 `--sparse`： > > ```bash > claude plugin marketplace add tractorjuice/arc-kit --sparse .claude-plugin arckit-claude > ``` > > 这使用 `git sparse-checkout` 将克隆限制在 `.claude-plugin/`（市场目录）和 `plugins/arckit-claude/`（插件本身）。 与 Claude Code 的文档市场稀疏标志一起使用。 Claude Code 是 ArcKit 的**主要开发平台**，并提供最完整的体验：所有 75 个官方命令、10 个自主研究代理、自动化钩子、捆绑的 MCP 服务器（AWS 知识、Microsoft Learn、Google Developer Knowledge、govreposcrape、uk-tenders）和通过市场的自动更新。 参见下面的[为什么选择 Claude Code？](#why-claude-code)。 > **为什么是 v2.1.172？** v2.1.172 修复了通配符域 `WebFetch` 权限规则（`WebFetch(domain:*.gov.uk)`），这些规则在早期客户端中从未匹配子域 — 这正是 ArcKit 建议的用于在 OFFICIAL-SENSITIVE 部署中限制研究代理流量的形状（请参见安全钩子指南），因此该版本使该指导实际上成立。 它还包括 **Claude Fable 5** 运行时（v2.1.170 中的 GA），ArcKit 默认使用最新的模型层。 它沿用了 v2.1.156 对 Opus 4.8 错误的修复，其中修改的思考块导致了 API 错误 — 与 `/arckit:*` 命令和依赖于扩展思考的研究代理相关，修复了采用 Opus 4.8。 v2.1.154 发布了 Opus 4.8（现在默认为高努力，拥有 `/effort xhigh`），以及插件的 `defaultEnabled: false` — ArcKit 的 10 个社区叠加层（`arckit-uae`、`arckit-fr`、`arckit-ca`、`arckit-eu`、`arckit-at`、`arckit-au`、`arckit-au-energy`、`arckit-us`、`arckit-uk-finance`、`arckit-uk-nhs`）现在设置为这样，安装市场会显示它们而不会自动启用所有十个；用户选择加入仅需要的司法管辖区或部门，而核心 `arckit` 保持默认启用。 v2.1.144 修复了一个错误，新会话从插件监视器输出而不是用户的第一个提示中命名 — ArcKit 的 `stale-artifact-scan` 监视器是规范的点击，生成名为“检测过期审查的 ArcKit 工件…”的会话，而不是用户的实际问题。 相同的版本修复了在无头模式下 Skill 工具因权限错误而失败（v2.1.141 中的回归），这影响了通过 `claude -p` / CI 的 `/arckit:*` 运行。 v2.1.143 添加了插件依赖强制执行，因此 `claude plugin disable arckit` 现在在社区叠加层（`arckit-au`、`arckit-uae` 等）依赖于它时显示一个可复制的禁用链提示，而不是静默破坏叠加层。 v2.1.139 添加了钩子 `args: string[]` 执行表单 — ArcKit 的 16 个注册钩子现在使用此表单，以便执行直接执行 `node <path>` 而不是解析 shell 引用的命令字符串。 这消除了 `${CLAUDE_PLUGIN_ROOT}`- 替换路径中引用的整个错误类别。 相同的版本还修复了子代理无法发现项目/用户/插件技能（影响 ArcKit 的 16 个代理）以及 `/mcp` 重新连接无法在没有重启的情况下获取 `.mcp.json` 编辑。 建立在 v2.1.136（修复：SessionStart 钩子中的环境变量过时 — 与 `inject-arckit-context` 模式相关；修复：.mcp.json 中的 MCP 服务器在 `/clear` 后消失），v2.1.133（子代理技能发现修复，钩子接收 `effort.level`），以及 v2.1.129（插件清单的 `monitors`/`themes` 移至顶级 `experimental` 块 — ArcKit 的 `stale-artifact-scan`后台监视器在该键下声明，当 `projects/` 工件超过其 `Next Review Date` 或卡在 `DRAFT` 中 14+ 天时发出警告，并且不会在较旧的客户端上加载；`ENABLE_PROMPT_CACHING_1H` 回归修复）。 沿用了 v2.1.121 的解锁：MCP `alwaysLoad` 急切加载 AWS 知识和 Microsoft Learn 工具在会话开始时（跳过 `/arckit:aws-research` 和 `/arckit:azure-research` 上的发现往返），以及 PostToolUse `hookSpecificOutput.updatedToolOutput`，以便证明戳记和清单钩子将它们的效果以带内方式呈现给模型；v2.1.118-119 版本的解锁：`claude plugin tag --dry-run` 验证插件/市场版本协议，会话遥测钩子在每个工具调用上记录 `duration_ms`；v2.1.117 版本的解锁：Opus 4.7 `/context` 正确调整为 1M 而不是 200K（长研究会话不再过早自动压缩）以及代理前置 `mcpServers` 加载 `--agent` 会话；v2.1.111+ 版本的解锁：Opus 4.7 `xhigh` 努力层级，自动模式无需 `--enable-auto-mode`，无需权限提示的只读 bash 通配符模式；以及 v2.1.97 版本的修复：`claude plugin update` 正确检测 git 插件的新提交（对 ArcKit 分发至关重要），MCP HTTP/SSE 内存泄漏修复（~50 MB/小时，影响 ArcKit 的 5 个捆绑服务器），适当的 429 指数退避（受益于 10 个研究代理），停止/子代理停止钩子在长会话上不再失败（影响会话学习器），以及子代理工作目录泄漏修复。 **Gemini CLI** — 安装 ArcKit 扩展： ```bash gemini extensions install https://github.com/tractorjuice/arckit-gemini ``` 零配置：所有 75 个官方命令、模板、脚本和捆绑的 MCP 服务器（AWS 知识、Microsoft Learn）。 通过 `gemini extensions update arckit` 更新。 **GitHub Copilot** （VS Code）— 安装 ArcKit CLI 并搭建提示文件： ```bash # 使用 pip 安装 pip install git+https://github.com/tractorjuice/arc-kit.git # 搭建具有 Copilot 提示文件的项目 arckit init my-project --ai copilot ``` 创建 `.github/prompts/arckit-*.prompt.md`（80 个提示文件），`.github/agents/arckit-*.agent.md`（10 个自定义代理）和 `.github/copilot-instructions.md`（存储库范围的上下文）。 在 Copilot Chat 中调用命令，如 `/arckit-requirements`、`/arckit-stakeholders` 等。 **Codex CLI** — 安装 ArcKit CLI： ```bash # 使用 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** — 链接 ArcKit 扩展： ```bash # 克隆独立扩展存储库 git clone https://github.com/tractorjuice/arckit-vibe.git cd arckit-vibe # 创建扩展目录并链接 mkdir -p ~/.vibe/extensions/ ln -s $(pwd) ~/.vibe/extensions/arckit ``` 零配置：75 个官方命令作为技能，10 个专用代理，所有模板和捆绑的 MCP 服务器（AWS 知识、Microsoft Learn、Google Developer Knowledge、GovRepoScrape）。 **最新发布**: [v5.15.0](https://github.com/tractorjuice/arc-kit/releases/tag/v5.15.0) ### OKF 互操作性 ArcKit 可以使用 Open Knowledge Format 形状的 frontmatter 层交换 Markdown 知识包： - `/arckit:export-okf` 将 ArcKit `ARC-*.md` 工件复制到具有可移植的 `type`、`title`、`resource`、`tags`、`timestamp` 和 `arckit` 元数据的 OKF 包中。 - `/arckit:import-okf` 扫描 OKF 包，编写 `.arckit/tmp/okf-import-report.json`，并默认将安全导入作为 `RSCH` 审查笔记。 - 只要您不显式启用源 frontmatter 标记，本地 ArcKit 文件将保持不变，方法是设置 `ARCKIT_OKF_FRONTMATTER=1` 或包含 `{ "okfFrontmatter": true }` 的 `.arckit/config.json`。 ### 平台支持 | 平台 | Claude Code 插件 | Gemini CLI 扩展 | GitHub Copilot | Codex / OpenCode CLI | Mistral Vibe | |----------|-------------------|---------------------|----------------|---------------------|--------------| | macOS | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | | Linux | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | | Windows (WSL2) | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | | Windows (原生) | 完整支持 | 完整支持 | 完整支持 | 部分 | 完整支持 | **Windows 用户**：Claude Code 插件、Gemini CLI 扩展、GitHub Copilot 提示文件和 Mistral Vibe 扩展均可在所有平台上原生运行。 对于原生 Windows（无需 WSL），某些包含内联 bash 片段的命令可能需要 [Git Bash](https://git-scm.com/downloads/win) 或 [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install)。 我们建议使用 WSL2 以获得最佳体验。 ### 初始化项目 **Claude Code**：无需初始化 — 插件提供一切。 **Mistral Vibe**：无需初始化 — 扩展提供一切。 **GitHub Copilot** （VS Code）： ```bash # 创建新的架构治理项目 arckit init payment-modernization --ai copilot # 或在当前目录中初始化 arckit init . --ai copilot ``` **OpenCode CLI**： ```bash # 创建新的架构治理项目 arckit init payment-modernization --ai opencode # 或在当前目录中初始化 arckit init . --ai opencode ``` **Codex CLI**： ```bash # 创建新的架构治理项目 arckit init payment-modernization --ai codex # 最小安装（跳过文档和指南） arckit init payment-modernization --ai codex --minimal # 或在当前目录中初始化 arckit init . --ai codex ``` ### 开始使用 ArcKit ```bash # GitHub Copilot (VS Code) cd payment-modernization && code . # 在 Copilot Chat 中，使用 ArcKit 命令： /arckit-principles 为金融服务公司创建原则 /arckit-requirements 构建支付处理系统... # Codex CLI cd payment-modernization codex # 在 AI 助手内部，使用 ArcKit 命令： /arckit:principles 为金融服务公司创建原则 /arckit:requirements 构建支付处理系统... /arckit:sow 生成供应商选择 RFP # Mistral Vibe CLI cd payment-modernization vibe # 使用 ArcKit 技能： /arckit-principles 为金融服务公司创建原则 /arckit-requirements 构建支付处理系统... /arckit-sow 生成供应商选择 RFP # 或使用专用代理： vibe --agent arckit-research "研究云提供商" ``` ### 升级 **Claude Code 插件**：通过市场自动更新 — 无需操作。 **Gemini CLI 扩展**：通过 `gemini extensions update arckit` 更新。 **GitHub Copilot**：重新运行 `arckit init --here --ai copilot` 以更新提示文件、代理和说明。 **Mistral Vibe**：拉取最新的独立扩展存储库：`cd ~/.vibe/extensions/arckit && git pull`. **Codex CLI**： ```bash # 步骤 1：升级 CLI 工具 pip install --upgrade git+https://github.com/tractorjuice/arc-kit.git # 或使用 uv： uv tool upgrade arckit-cli --from git+https://github.com/tractorjuice/arc-kit.git # 步骤 2：更新现有项目（就地重新初始化） cd /path/to/your-existing-project arckit init --here --ai codex ``` 这将更新命令、模板、脚本和代理，同时**保留**您的数据（`projects/`）和自定义模板（`.arckit/templates-custom/`）。 如果从 v0.x 升级，您可能还需要迁移旧文件名 — 请参阅[升级指南](docs/guides/upgrading.md)以获取完整详细信息。 ### 示例输出 公共演示仓库展示了完整的 ArcKit 成果： - **国民保健服务预约** — [arckit-test-project-v7-nhs-appointment](https://github.com/tractorjuice/arckit-test-project-v7-nhs-appointment)：数字健康平台，集成 NHS Spine 并具备 GDPR 安全措施。 - **M365 GCC-H 迁移** — [arckit-test-project-v1-m365](https://github.com/tractorjuice/arckit-test-project-v1-m365)：政府云迁移，具备合规性映射和变更管理。 - **税务局税务助理** — [arckit-test-project-v2-hmrc-chatbot](https://github.com/tractorjuice/arckit-test-project-v2-hmrc-chatbot)：对话式 AI 服务，涵盖 PII 保护和双语支持。 - **Windows 11 部署** — [arckit-test-project-v3-windows11](https://github.com/tractorjuice/arckit-test-project-v3-windows11)：企业操作系统推广，具备政策迁移和安全基线。 - **专利申请系统** — [arckit-test-project-v6-patent-system](https://github.com/tractorjuice/arckit-test-project-v6-patent-system)：使用 GOV.UK Pay 和 Notify 的知识产权工作流自动化。 - **官方统计数据平台** — [arckit-test-project-v8-ons-data-platform](https://github.com/tractorjuice/arckit-test-project-v8-ons-data-platform)：官方统计分析环境，具备 Five Safes 治理。 - **内阁办公室 GenAI 平台** — [arckit-test-project-v9-cabinet-office-genai](https://github.com/tractorjuice/arckit-test-project-v9-cabinet-office-genai)：跨政府 GenAI 平台，具备负责任的 AI 防护措施。 - **英国政府培训市场** — [arckit-test-project-v10-training-marketplace](https://github.com/tractorjuice/arckit-test-project-v10-training-marketplace)：AI 培训采购平台，具备多边市场设计。 - **国家高速公路数据架构** — [arckit-test-project-v11-national-highways-data](https://github.com/tractorjuice/arckit-test-project-v11-national-highways-data)：战略性道路网络数据平台现代化。 - **苏格兰法院 GenAI** — [arckit-test-project-v14-scottish-courts](https://github.com/tractorjuice/arckit-test-project-v14-scottish-courts)：苏格兰法院和法庭服务 GenAI 战略，具备全面 MLOps 和 FinOps。 - **医生预约系统** — [arckit-test-project-v16-doctors-appointment](https://github.com/tractorjuice/arckit-test-project-v16-doctors-appointment)：在线预约系统，集成 NHS。 - **英国燃料价格透明度** — [arckit-test-project-v17-fuel-prices](https://github.com/tractorjuice/arckit-test-project-v17-fuel-prices)：英国政府燃料价格透明度服务，具备实时定价数据。 - **智能电表消费者应用** — [arckit-test-project-v18-smart-meter](https://github.com/tractorjuice/arckit-test-project-v18-smart-meter)：英国智能电表数据消费者移动应用，集成 DCC/SMIP。 - **英国政府 API 聚合器** — [arckit-test-project-v19-gov-api-aggregator](https://github.com/tractorjuice/arckit-test-project-v19-gov-api-aggregator)：统一访问 240+ 个英国政府 API，涵盖 34+ 个部门。 --- ## 成本（插件占用） 在 Claude Code 会话中安装 `arckit` 核心插件的 Token 成本，从 `claude plugin details arckit` 中捕获（版本 v2.1.143+）： - **始终在线每会话：~10,042 tokens** — 添加到每个会话的系统上下文中，涵盖 73 个命令技能 + 5 个实用技能（`architecture-workflow`、`arckit-build`、`mermaid-syntax`、`plantuml-syntax`、`wardley-mapping`）+ 16 个代理描述符。钩子（9 个事件）和 MCP 服务器（6 个）在运行时解析，不计入费用。 - **调用时：~250 至 ~60K tokens 每命令** — 仅在特定技能或代理触发时支付。大多数命令的 Token 消耗在 5–10K 范围内。 ### 调用时成本按命令分类 成本估算来自 Claude Code tokenizer，可能与实际使用情况有所不同。使用此表格预算研究密集型多命令会话。 | 层级 | 范围 | 命令 | |------|-------|----------| | 轻量级 | <2K | `start`、`init`、`build`、`search`、`impact`、`navigator`、`graph-report`、`framework`、`gov-landscape`、`aws-research`、`azure-research`、`gcp-research` | | 标准 | 2–7K | `customize`、`score`、`principles`、`mermaid-syntax`、`plantuml-syntax`、`architecture-workflow`、`datascout`、`tenders`、`competitors`、`evaluate`、`hld-review`、`mlops`、`devops`、`finops`、`research`、`tcop`、`wardley-mapping`、`template-builder`、`glossary`、`dld-review`、`traceability`、`stakeholders`、`presentation`、`dfd`、`operationalize`、`requirements`、`maturity-model`、`data-model`、`gov-reuse`、`strategy`、`presentation`、`atrs`、`gov-code-search`、`READER-PATTERN` | | 重量级 | 7–15K | `wardley.value-chain`、`gcloud-clarify`、`ai-playbook`、`sow`、`sobc`、`risk`、`secure`、`dpia`、`dos`、`mod-secure`、`plan`、`conformance`、`roadmap`、`health`、`wardley.doctrine`、`wardley.gameplay`、`pages`、`servicenow`、`gcloud-search`、`principles-compliance`、`story`、`wardley`、`wardley.climate`、`data-mesh-contract`、`platform-design`、`adr`、`arckit-build`、`grants` | | 研究密集型 | 15–25K | `service-assessment`、`analyze`、`backlog`、`diagram` | | 专业级 | >25K | `jsp-936`（~60K — MOD JSP 936 AI 保障，国防专用） | ### 减少占用 - 五个实用技能已经使用 `paths:` 通配符限定其始终在线成本至相关项目（`mermaid-syntax` 仅在 `*.mmd` 下加载，`wardley-mapping` 在 WARD 工件下加载等）。73 个命令技能已列出但未详细描述在始终在线上下文中 — 完整提示仅在调用时加载。 - 社区覆盖层（`arckit-uae`、`arckit-fr`、`arckit-ca`、`arckit-eu`、`arckit-at`、`arckit-au`、`arckit-au-energy`、`arckit-us`、`arckit-uk-finance`、`arckit-uk-nhs`）是独立插件 — 仅安装所需司法管辖区/部门。每个都添加其自身的始终在线基线。`arckit-uk-finance`、`arckit-uk-nhs` 和 `arckit-au-energy` 是**部门**覆盖层（`arckit-au-energy` 在 `arckit-au` 司法管辖区基线之上叠加能源部门）；其余基于司法管辖区。 - 重量级命令（`jsp-936`、`analyze`、`diagram`、`backlog`）仅在调用时计费；始终在线成本不受影响。 要衡量您自己的会话占用，运行 `/context all`（Claude Code v2.1.139+），获取针对活动模型的每个技能的 Token 估算。 --- ## 为什么选择 ArcKit？ ### 问题：架构治理已损坏 传统企业架构存在以下问题： - ❌ 工具中分散的文档（Word、Confluence、PowerPoint） - ❌ 不一致的治理执行 - ❌ 手动供应商评估带有偏见 - ❌ 需求和设计之间的可追溯性丢失 - ❌ 过时的文档与现实不符 ### 解决方案：结构化、AI 辅助的治理 ArcKit 提供： - ✅ **模板驱动的质量**：全面模板确保不会遗忘任何内容 - ✅ **系统化工作流程**：从需求到采购到设计审查的清晰流程 - ✅ **AI 辅助**：让 AI 处理文档生成，您专注于决策 - ✅ **强制追溯性**：自动间隙检测和覆盖分析 - ✅ **版本控制**：所有架构工件的 Git 基础工作流 --- ## 英国政府合规性 ArcKit 包含适用于英国公共部门交付的专用命令： - `/arckit:tcop` — 评估所有 13 个技术实践代码点，涵盖交付阶段。 - `/arckit:ai-playbook` — 生成符合英国政府 AI 游戏手册和 ATRS 的负责任 AI 评估。 - `/arckit:secure` — 生成安全设计工件，涵盖 NCSC CAF、网络安全基本要求和英国 GDPR 控制。 - `/arckit:mod-secure` — 映射 MOD 安全设计要求（JSP 440、IAMM、许可路径）。 - `/arckit:jsp-936` — 为国防 AI 系统提供 JSP 936 AI 保障包。 在演示仓库中查看端到端示例，尤其是 `arckit-test-project-v7-nhs-appointment`（民用服务）和 `arckit-test-project-v9-cabinet-office-genai`（AI 治理）。 --- ## 欧盟、法国和奥地利监管合规（社区） > ⚠️ **社区贡献**。欧盟和法国命令由 [@thomas-jardinet](https://github.com/thomas-jardinet) 维护；奥地利命令是一个种子贡献，邀请奥地利领域维护者。下面 21 个命令涵盖欧盟法规（GDPR、NIS2、AI 法案、DORA、CRA、DSA、数据法）、法国政府标准（SecNumCloud、ANSSI、EBIOS、CNIL、DINUM 等）和奥地利政府标准（DSG、NISG 2024、BVergG 2018）。它们不是官方维护的基线 — 输出应由合格的 DPO / CISO / Vergabejurist / 法律顾问审查后方可依赖，引用的来源可能会滞后于当前文本。每个命令都带有 `[COMMUNITY]` 前缀，在 `/help` 列表中显示，并在生成前显示警告横幅。 **欧盟法规**（成员国中立基线，适用于整个欧盟/EEA）： - `/arckit:eu-rgpd` — GDPR（欧盟 2016/679）合规性评估 — 法律依据、数据主体权利、转让、DPIA 筛查、违规通知 - `/arckit:eu-nis2` — NIS2 指令 — 基本/重要实体运营商、Article 21 措施、事件报告时间线 - `/arckit:eu-ai-act` — 欧盟 AI 法案（法规 2024/1689）— 风险分类（禁止/高风险/GPAI）、合规路线 - `/arckit:eu-dora` — 数字运营弹性法案（欧盟 2022/2554）— 金融部门 ICT 风险、TLPT、第三方注册 - `/arckit:eu-cra` — 网络弹性法案（法规 2024/2847）— 具有数字元素的产品、SBOM、VDP、CE 标记 - `/arckit:eu-dsa` — 数字服务法案（法规 2022/2065）— 中介、平台、VLOPs、ARCOM - `/arckit:eu-data-act` — 数据法案（法规 2023/2854）— 连接产品、B2B FRAND、云切换、Article 27 **法国政府**（在欧盟基线之上适用于法国部署）： - `/arckit:fr-secnumcloud` — SecNumCloud 3.2 资格（主权云、OIV/OSE、跨界风险） - `/arckit:fr-dinum` — DINUM 标准：RGI、RGAA、RGESN、RGS、国家云教义、FranceConnect、DSFR - `/arckit:fr-marche-public` — 法国公共采购（公共采购法典、UGAP、主权条款） - `/arckit:fr-rgpd` — CNIL 特定 GDPR 层（cookie 决策 2020-091，HDS，15 岁，DPO 注册） - `/arckit:fr-ebios` — EBIOS 风险管理器 — 5-workshop 研究（VM/ER/SR/CO/SS/SO/MS ID，MITRE ATT&CK，同源） - `/arckit:fr-anssi` — ANSSI 计算机卫生指南（42 措施）+ 云安全建议 - `/arckit:fr-anssi-carto` — ANSSI 信息系统在商业/应用/系统/网络级别的映射 - `/arckit:fr-dr` — II 901 / SGDSN / ANSSI 下的 Diffusion Restreinte 处理 - `/arckit:fr-algorithme-public` — 公共算法透明度通知（Article L311-3-1 CRPA，Loi République Numérique） - `/arckit:fr-pssi` — 信息系统安全策略（PSSI）根据 ANSSI / RGS - `/arckit:fr-code-reuse` — 公共代码重复评估（code.gouv.fr、SILL、EUPL）— build-vs-reuse 决策矩阵 **奥地利政府**（在欧盟基线之上适用于奥地利部署 — 种子贡献待领域维护者）： - `/arckit:at-dsgvo` — 奥地利 DSG 对 GDPR 的补充（§§12–13 图像处理、ELGA/GTelG 健康、§96a ArbVG 员工监控、14 岁同意、DSB 执行） - `/arckit:at-nisg` — 奥地利 NISG 2024（NIS2 转置）— 基本/重要指定、GovCERT 报告、KSÖ、AT 行业当局 - `/arckit:at-bvergg` — 2018 年联邦采购法 — Oberschwellen/Unterschwellen、ANKÖ 发布、Bestbieterprinzip、BVwG 审查 这些层清晰地叠加在现有基线之上 — `fr-rgpd` / `at-dsgvo` 扩展 `eu-rgpd`，`fr-pssi` / `at-nisg` 引用 `eu-nis2`，`fr-secnumcloud` 与 `arckit.research` 和 `arckit.evaluate` 集成用于采购工作流。奥地利命令带有额外的 `[NEEDS VERIFICATION]` 标记，反映其种子状态 — 未来领域维护者预计将加强引用。 --- ## 加拿大联邦覆盖层（12 个命令） 联邦加拿大监管基线作为 `[COMMUNITY]` 覆盖层 — 涵盖 FITAA（Bill C-70 2024）、联邦隐私和访问（Privacy Act、ATI Act）、Treasury Board Directive on Automated Decision-Making、Charter 权利设计审查、ITSG-33 + Security Categorization Standard、Security of Information Act 处理、GC Cloud 主权居住、GC Digital Standards conformance、Official Languages Act、联邦采购（PSPC + PSAB）和 First Nations OCAP® 数据主权。 | 命令 | 类型代码 | 目的 | |---|---|---| | `/arckit:ca-fitaa` | `FITAA` | 外国影响透明度和问责法合规性评估 | | `/arckit:ca-pia` | `PIA` | 根据隐私法 + TBS 指令进行隐私影响评估 | | `/arckit:ca-atip` | `ATIP` | 访问信息 / 隐私法协调和拒绝设计 | | `/arckit:ca-aia` | `AIA` | 根据 TBS 指令进行算法影响评估（I-IV 级） | | `/arckit:ca-charter` | `CHRT` | 宪章权利设计审查（s.2 / s.7 / s.8 / s.15）与 Oakes 相比例 | | `/arckit:ca-itsg-33` | `ITSG` | ITSG-33 适用性声明 + 安全分类标准 | | `/arckit:ca-soia` | `SOIA` | 安全信息法处理计划，用于 SECRET / TOP SECRET 系统 | | `/arckit:ca-cloud-residency` | `CACR` | GC 云主权居住评估与 CLOUD-Act 分析 | | `/arckit:ca-gc-digital-standards` | `DIGSTD` | 加拿大政府数字标准一致性记分卡 | | `/arckit:ca-ola` | `OLA` | 官方语言法审查（第 IV / V / VI 部分） | | `/arckit:ca-pspc` | `PROC` | 联邦采购策略（PSPC 供应手册 + PSAB 5%） | | `/arckit:ca-ocap` | `OCAP` | 原住民 OCAP® 主权评估与 FNIGC 预参与门槛 | > **需要帮助**：寻找一位加拿大联邦企业架构师共同维护此覆盖层。打开问题或 DM @tractorjuice。 ## 阿联酋联邦叠加层（社区贡献） > ⚠️ **社区贡献叠加层**。以下 12 个命令涵盖了阿联酋联邦的监管和数字政府文书，并作为 **社区贡献叠加层**（不是官方维护的 68 个基准的一部分）提供。它们基于阿联酋内阁 2026 年 4 月 23 日的法令，该法令要求到 2028 年 4 月，50% 的联邦服务必须运行在智能 AI 上，并且基于该法令所引用的联邦数据、身份、AI 治理和采购框架。目前，该叠加层由 @tractorjuice 单独维护；一名阿联酋领域的共同维护者正在被招募，以便在官方基准提升之前重新评估该叠加层。六个引用被标记为 `[需要验证]`，待执行法规和权威确认后 - 请参阅 [`docs/guides/uae-overlay-maintenance.md`](docs/guides/uae-overlay-maintenance.md)。输出应由合格的阿联酋联邦合规顾问审查后方可依赖。 在插件用户配置中设置 `governance_framework: 阿联酋联邦` 和 `classification_scheme: 阿联酋智能数据`，以将文档控制头切换为阿联酋智能数据分类渲染，适用于每个制品。 **联邦数据和安全**: - `/arckit:uae-classification` — 阿联酋智能数据分类注册表（开放/共享/机密/秘密/最高机密），附带处理规则和解密时间表 - `/arckit:uae-pdpl` — 联邦法令 - 法律 No. 45 of 2021（PDPL）合规性评估 - DPIA，合法性依据注册表，数据主体权利程序，跨境转移日志 - `/arckit:uae-ias` — 阿联酋网络安全委员会信息保障标准 v2 - 针对 188 个控制措施（60 个管理 M1-M6，128 个技术 T1-T9）的适用性声明，优先级分层 P1-P4 - `/arckit:uae-cloud-residency` — 国家云安全政策 v2 主权云评估 - 按分类划分的驻地，批准的 CSP（Core42 / G42，微软阿联酋北部/中部，TDRA FedNet，e& 在 AWS 上的主权启动平台），共享责任矩阵，出口/可移植性计划 **联邦身份**: - `/arckit:uae-uaepass` — 阿联酋通行证集成设计（OIDC/OAuth 流程，声明映射，基本与验证配置文件选择，服务提供商上线，电子签名审计跟踪） **内阁文书**: - `/arckit:uae-zero-bureaucracy` — 阿联酋政府服务代码和零官僚计划下的服务目录审查 - `/arckit:uae-digital-records` — 阿联酋政府服务数字记录政策下的数字记录计划（每项服务的真实来源注册表，保留时间表，官方来源指定） - `/arckit:uae-data-sharing` — 阿联酋政府服务数据共享政策下的数据共享协议（“一次收集，安全使用”）附带 PDPL 合法性依据 - `/arckit:uae-priorities-alignment` — 阿联酋联邦政府指南下的国家优先级对齐声明 - 重用 vs. 建设，能力重用注册表（阿联酋通行证，FedNet），NIS 2031 / AI 2031 / 我们是阿联酋 2031 战略对齐 **AI 治理**: - `/arckit:uae-ai-charter` — 阿联酋 AI 发展和使用宪章合规性评估（12 项原则） - `/arckit:uae-ai-autonomy-tier` — 三层 AI 自主性姿态（Tier 1 内部生产力，Tier 2 投资者面对面且需批准，Tier 3 受监管/金融）附带每层防护栏，批准门槛，审计义务，层级晋升标准 **采购**: - `/arckit:uae-procurement` — 联邦采购战略下的联邦法令 - 法律 No. 11 of 2023 - ITT/RFP 包针对 MoF 数字采购平台模板，在国内价值（ICV）计划，评估报告结构，合同注册 这些命令按规范顺序链接在一起，从 `principles → uae-classification → uae-pdpl → uae-ias → uae-cloud-residency → uae-uaepass → uae-zero-bureaucracy → uae-digital-records → uae-data-sharing → uae-ai-charter → uae-ai-autonomy-tier → uae-priorities-alignment → uae-procurement → sobc → wardley → framework`。完整指南：[`docs/guides/uae-overlay.md`](docs/guides/uae-overlay.md)。 --- ## 英国 NHS 临床安全叠加层（社区贡献） > ⚠️ **社区贡献叠加层** - ArcKit 中的第一个行业特定叠加层。以下 4 个命令涵盖了 NHS 临床安全（DCB0129 制造商 + DCB0160 部署者），NHS DTAC 采购保证，以及 UK MDR 2002 + EU MDR 2017/745 软件作为医疗设备分类。采用 Dr Marcus Baw 的 [SAFETY.md 规范](https://github.com/pacharanero/SAFETY.md) 进行 DCB0129/0160 文件命名和 YAML 前置事项危险日志。输出 **不是** 临床，法律或监管建议 - 必须由合格的临床安全官员（CSO 具有适当的 GMC / NMC / HCPC / GPhC 注册）和 MDR 分类合格的监管事务专家审查后方可依赖。 **临床安全（DCB0129 + DCB0160）**: - `/arckit:uk-nhs-dcb0129` — NHS DCB0129 制造商临床安全案例 + 危险日志。在 `projects/{NNN}/clinical-safety/` 中生成 3 个文件集：`SAFETY.md`（前门锚点），`SAFETY-CASE.md`（受 GSN 启发的 safety 论证），`HAZARD-LOG.md`（YAML 前置事项危险数组 + 渲染的 Markdown 表格；6 个启动危险涵盖错误患者，过期数据，审计，授权，警报传递，写入完整性） - `/arckit:uk-nhs-dcb0160` — NHS DCB0160 部署者临床安全案例 + 部署危险日志。在 `projects/{NNN}/clinical-safety/deployment/` 中生成 3 个文件集；10 个启动部署危险涵盖培训，工作流程集成，BC，并行运行，迁移，本地配置，术语，RBAC，事件报告 **采购和监管**: - `/arckit:uk-nhs-dtac` — NHS 数字技术评估标准 v3 - 5 个部分（临床安全，数据保护，技术保证，互操作性，可用性和可访问性）+ AI 附件。交叉引用 DCB0129/0160，DPIA，ATRS，安全设计 - `/arckit:uk-mdr-classification` — UK MDR 2002（如已修订）+ EU MDR 2017/745 软件作为医疗设备（SaMD）和 AI 作为医疗设备（AIaMD）分类。UKCA / UKNI / CE 标记路径，温莎框架 NI 处理，一致性评估路线，MHRA SaMD/AIaMD 计划对齐，ISO 14971 / IEC 62304 / ISO 13485 标准映射，上市后义务 这些命令与英国政府基准（`tcop`，`secure`，`dpia`，`atrs`，`risk`，`service-assessment）组合使用，而不是替换它们。配方：`uk-nhs-clinical-safety`（跨临床安全波的 44 个目标）。提议的领域共同维护者：Dr Marcus Baw（[@pacharanero](https://github.com/pacharanero)）- RCPCH 的临床信息学家，openEHR，NHS 英格兰。 DCB0129/0160 输出故意 **不** 带有 `ARC-` 前缀 - 它们遵循 Marcus 的 SAFETY.md 规范约定，以便保持对临床医生，MHRA 审查者和采购团队的可读性。其他制品通过相对路径交叉引用它们。完整的设计日志：[`docs/superpowers/specs/2026-05-19-uk-nhs-overlay-design.md`](docs/superpowers/specs/2026-05-19-uk-nhs-overlay-design.md)。 --- ## 美国联邦民事叠加层（10 个命令） > ⚠️ **社区贡献叠加层**。以下 10 个命令涵盖了美国联邦民事合规文书（FedRAMP 授权，FISMA / NIST 800-53 修订版 5，CISA 零信任成熟度模型，OMB M-19-17 ICAM，NIST AI RMF + OMB M-24-10/M-25-21 AI 保证，E-Government Act §208 PIA，EO 14028 SBOM 自我评估）。它们作为 **arckit-us** 社区贡献叠加层提供（不是官方维护的 72 个基准的一部分）。**EO 14110 于 2025 年 1 月被撤销**；当前的 AI 指令是 **OMB M-24-10 + M-25-21**。**FedRAMP 于 2024 年完成了修订版 5 的转换**。该叠加层目前由 @tractorjuice 单独维护；一名美国联邦民事领域共同维护者正在被招募（欢迎 CISO / SAOP / FedRAMP PMO / CAIO 背景）之前，该叠加层可以被重新评估为官方基准提升。输出应由合格的美国联邦顾问审查后方可依赖。 **范围内（v1）**：联邦民事机构及其向其销售的供应商。 **范围外（未来其他叠加层）**：联邦防御（CMMC / RMF / DISA STIG），州政权（StateRAMP / TX-RAMP / CJIS / IRS Pub 1075 / CCPA），行业特定（HIPAA / GLBA / SOX / FERPA / PCI DSS），第 508 条无障碍访问（延期至 v5.2）。 | 命令 | 锚点 | 文档类型 | | --- | --- | --- | | `/arckit:us-fisma-categorization` | FIPS 出版物 199 + NIST SP 800-60 卷 2 修订版 1 | `FIPS199` | | `/arckit:us-nist-800-53` | NIST SP 800-53 修订版 5 + SP 800-53B + FedRAMP 修订版 5 基线 | `NIST` | | `/arckit:us-fedramp-ssp` | FedRAMP SSP 模板修订版 5 + NIST SP 800-37 修订版 2 | `FRSSP` | | `/arckit:us-fedramp-readiness` | FedRAMP 3PAO 就绪评估报告模板 | `FRRR` | | `/arckit:us-zero-trust` | CISA 零信任成熟度模型 v2.0 + OMB M-22-09 + NIST SP 800-207 | `ZTA` | | `/arckit:us-icam` | OMB M-19-17 + NIST SP 800-63-3（A/B/C）+ FIPS 201-3 + login.gov | `ICAM` | | `/arckit:us-ai-rmf` | NIST AI RMF 1.0 + NIST AI 600-1（生成式 AI 配置文件） | `AIRMF` | | `/arckit:us-ai-impact` | OMB M-24-10 + OMB M-25-21 | `AIIA` | | `/arckit:us-privacy-pia` | E-Government Act §208 + OMB M-03-22 + 隐私法 §552a + NIST SP 800-122 | `USPIA` | | `/arckit:us-sbom-eo-14028` | EO 14028 + OMB M-22-18 + OMB M-23-16 + CISA 自我评估表格 + NTIA 最低要素 | `SBOM` | 配方：`us-federal`（5 波 - 基线 → 控制 → 状态 → AI → 授权）。 安装：`claude plugin install arckit arckit-us`。请参阅 [`docs/guides/us-federal-overlay.md`](docs/guides/us-federal-overlay.md) 获取美国联邦民事叠加层维护指南和引用注册。 --- ## 英国金融支付叠加层（4 个命令）- 第一行业叠加层 > **实验性行业叠加层**。以下 4 个命令涵盖了英国受监管的支付系统运营商在 PSD2 SCA-RTS、CASS V、FCA 消费者责任和 CREST 协议下扩大业务。它们作为 **arckit-uk-finance** 社区贡献叠加层提供 - 第一个 **行业特定** 叠加层（不同于 7 个司法管辖区叠加层）。输出需要由合格的英国金融服务监管顾问、MLRO 和 SMF 持有者审查后方可实施。 **支付架构和合规**: - `/arckit:uk-nhs-dcb0129` — 待定 - `/arckit:uk-nhs-dcb0160` — 待定 - `/arckit:uk-nhs-dtac` — 待定 - `/arckit:uk-mdr-classification` — 待定 配方：`uk-fs-payments`（多波支付系统现代化）。 安装：`claude plugin install arckit arckit-uk-finance`。帮助：招募一名英国金融服务领域共同维护者（CISO / 合规 / 架构负责人背景欢迎）以过渡到官方基准状态。 --- ## 英国 G-Cloud 供应商投标撰写叠加层（11 个命令）- 专有 > **专有，Claude 代码仅限**。以下 11 个命令是供应商侧叠加层，用于撰写英国 G-Cloud（数字市场）框架投标：供应商资料，服务设计，三个服务定义文档批次，供应商声明，定价，安全断言，竞争者基准，提交审查和最终提交包。与所有其他 ArcKit 插件不同，`arckit-uk-gcloud` 在 **专有许可下提供（非 MIT）**，并且 **不分发到非 Claude 扩展格式**（Codex / Gemini / OpenCode / Copilot）- 它仅在 Claude Code 上运行。这是第四个行业特定叠加层（在 `arckit-uk-finance`，`arckit-uk-nhs`，`arckit-au-energy` 之后），需要 `arckit` 核心插件。 **G-Cloud 投标撰写**: - `/arckit:supplier-profile` — 供应商资料和公司能力声明（SUPP） - `/arckit:service-design` — 服务设计和价值主张（SVCD） - `/arckit:sdd-lot1` — 服务定义文档，批次 1 云托管（SDD） - `/arckit:sdd-lot2` — 服务定义文档，批次 2 云软件（SDD） - `/arckit:sdd-lot3` — 服务定义文档，批次 3 云支持（SDD） - `/arckit:declaration` — 供应商声明和框架声明（DECL） - `/arckit:pricing` — 定价文件和 SFIA 费率卡（PRIC） - `/arckit:security` — 安全断言和云安全评估（SECA） - `/arckit:gcloud-competitors` — G-Cloud 竞争者基准（GCMP） - `/arckit:review` — G-Cloud 提交审查和差距分析（GCRV） - `/arckit:submission-pack` — 组装最终的 G-Cloud 提交包 技能：`gcloud-framework`，`cloud-security`，`sfia-skills`。配方：`uk-gcloud-submission`（端到端投标组装）。 安装：`claude plugin install arckit arckit-uk-gcloud`。专有 - 请参阅此 README 结尾的许可异常说明。移植自独立的 gcloud-kit 插件。 --- ## ArcKit 工作流程 ArcKit 通过企业架构生命周期引导您： ### 阶段 0：项目规划 **`/arckit:plan`** → 使用时间表、阶段和关卡创建项目计划 可视化您的整个项目交付： - GDS 敏捷交付阶段（发现 → Alpha → Beta → 上线） - 带有时间线、依赖关系和里程碑的 Mermaid 甘特图 - 显示关卡和决策点的流程图 - 根据项目复杂性量身定制的时间线 - 将所有 ArcKit 命令集成到时间表中 - 治理的关卡审批标准 ### 阶段 1：建立治理 **`/arckit:principles`** → 创建企业架构原则 定义组织的架构标准： - 云策略（AWS / Azure / GCP） - 安全框架（零信任，合规） - 技术标准 - FinOps 和成本治理 ### 阶段 2：利益相关者分析 **`/arckit:stakeholders`** → 分析利益相关者的驱动因素、目标和结果 **在进行业务案例之前**，了解谁关心该项目以及为什么： - 确定所有利益相关者（内部和外部） - 记录潜在驱动因素（战略、运营、财务、合规、风险、个人） - 将驱动因素映射到 SMART 目标 - 将目标映射到可衡量的结果 - 创建利益相关者 → 驱动因素 → 目标 → 结果的追溯链 - 确定冲突和协同作用 - 定义参与和沟通策略 ### 阶段 3：风险评估 **`/arckit:risk`** → 创建综合风险登记册（橙色手册） **在进行业务案例之前**，系统性地识别和评估风险： - 遵循 2023 年 HM 财政部橙色手册框架 - 确定六类风险（战略、运营、财务、合规、声誉、技术） - 评估固有风险（控制前）和剩余风险（控制后） - 应用 4T 响应框架（容忍、处理、转移、终止） - 将每个风险与 RACI 矩阵中的利益相关者联系起来 - 监控风险偏好合规性 - 输入 SOBC 管理案例第 E 部分 ### 阶段 4：业务案例论证 **`/arckit:sobc`** → 创建战略概要商业案例（SOBC） **在需求之前**，为了证明投资并获得批准： - 使用 HM 财政部绿色手册 5 案例模型（战略、经济、商业、财务、管理） - 分析战略选项（不作为、最小、平衡、全面） - 将利益与利益相关者的目标映射（完整追溯） - 提供高级别的成本估算（粗略数量级） - 经济评估（ROI 范围，回收期） - 采购和资金策略 - 治理和风险管理（使用风险登记册） - 实现 GO/NO-GO 决策 **在详细需求工作之前** ### 阶段 5：定义需求 **`/arckit:requirements`** → 文档综合需求 根据利益相关者的目标创建详细需求（如果 SOBC 获得批准）： - 业务需求及其依据 - 具有验收标准的详细需求 - 非功能性需求（性能、安全、扩展性、合规性） - 集成需求（上游/下游系统） - 数据需求（DR-xxx） - 成功标准和 KPI ### 阶段 5.3：平台战略设计（可选 - 适用于多侧平台） **`/arckit:platform-design`** → 使用平台设计工具包设计多侧平台战略 在设计 **基于生态系统的平台**（政府即平台、市场、数据平台）时使用此阶段： - **生态系统画布**：绘制供给侧、需求侧、支持实体的关系图 - **实体角色肖像**：深入研究 3-5 个关键实体（背景、压力、目标、收益） - **动机矩阵**：使用缓解策略识别实体间的协同作用和冲突 - **交易委员会**：设计 10-20 个交易并进行成本降低分析（搜索、信息、谈判、协调、执行） - **学习引擎画布**：5+ 个服务，帮助参与者改进（数据、反馈环、网络效应） - **平台体验画布**：带有商业模式和单位经济的旅程图 - **MVP 画布**：解决鸡和蛋问题的流动性引导策略 - **平台设计画布**：将所有 8 个画布合成一个完整的平台战略 - **英国政府背景**：与政府即平台（GaaP）、TCoP 第 8 点（共享/重用）、数字市场对齐 **用例**：NHS 预约预订、地方政府数据市场、培训采购平台、公民服务门户 ### 阶段 5.5：数据建模 **`/arckit:data-model`** → 使用 ERD 创建综合数据模型 根据数据需求（DR-xxx）创建数据模型： - 视觉实体关系图（ERD），使用 Mermaid - 详细的实体目录，包括属性、类型、验证规则 - PII 识别和 GDPR/DPA 2018 合规 - 数据治理矩阵（业务所有者、管理员、保管人） - 显示组件访问模式的 CRUD 矩阵 - 数据集成映射（上游来源、下游消费者） - 具有可衡量指标的数据质量框架 - 需求追溯性（DR-xxx → 实体 → 属性） ### 第5.7阶段：数据保护影响评估 **`/arckit:dpia`** → 为英国GDPR第35条合规性生成DPIA **高风险处理** 必备 - 在技术选型前评估隐私风险： - ICO 9项自动筛选（敏感数据、大规模、弱势群体、AI/ML等） - 从数据模型自动填充（实体、个人可识别信息、特殊类别数据、合法依据） - 风险评估聚焦于对个人的影响（隐私损害、歧视） - 数据主体权利实施检查清单（SAR、删除、移植） - 儿童数据评估（年龄验证、家长同意） - AI/ML算法处理评估（偏差、可解释性、人工监督） - ICO高剩余风险预警咨询 - 国际传输安全措施（SCC、BCR、充分性决定） - 与风险登记册的双向链接（DPIA-xxx风险ID） - 与“安全设计”安全控制措施的链接 ### 第5.8阶段：数据源发现 **`/arckit:datascout`** → 发现外部数据源 发现和评估外部数据源以满足项目数据需求： - 从DR/FR/INT/NFR需求中提取数据需求 - 英国政府开放数据门户（data.gov.uk、ONS、NHS Digital、Companies House、OS Data Hub） - 商业API提供商和数据市场 - 免费/试用API和开源数据集 - 加权评估评分（需求匹配度、数据质量、许可证&成本、API质量、合规性、可靠性） - 未满足数据需求的差距分析 - 数据模型影响评估（新实体、属性、同步策略） - 需求可追溯性（每个DR-xxx映射到源或标记为缺口） - TCoP第10点合规（更好地利用数据） ### 第6阶段：技术研究 **`/arckit:research`** → 研究技术、服务和产品 研究满足需求的可行解决方案，并进行构建vs购买分析： - 从需求中动态检测类别（身份验证、支付、数据库等） - 商业SaaS选项，含定价、评论和评分（WebSearch） - 开源替代方案，含GitHub统计和社区成熟度 - 英国政府GOV.UK平台（One Login、Pay、Notify、Forms） - 数字市场供应商（G-Cloud、DOS） - 总拥有成本（TCO）比较（3年） - 构建vs购买vs采用建议 - 更深入评估的供应商短名单 - 与Wardley映射集成（演化定位） - 输入SOBC经济案例（成本数据、选项分析） ### 第6.5阶段：资助和资金研究 **`/arckit:grants`** → 研究英国政府资助、慈善资金和加速器计划 识别和评估资金机会，并进行资格评分： - 英国Innovate UK资助和研发资金（例如Smart Grants、KTP、SBRI） - 英国研究和创新（UKRI）资金呼吁 - 慈善基金会和慈善资金（例如国家彩票遗产基金、威尔康姆信托） - 加速器和孵化器计划（例如DCMS、DSIT支持的队列） - 对英国实体的欧盟地平线欧洲继任资金开放 - 资格评分矩阵针对项目需求和利益相关者概况 - 申请时间表、截止日期和奖励价值 - 战略契合度评估（与项目目标和公共部门背景的对齐） - 输出结构化的GRNT资金机会登记册 ### 第7阶段：Wardley映射战略规划 **`/arckit:wardley`** → 创建战略Wardley地图 使用Wardley地图进行战略定位： - 组件演化分析（Genesis → Custom → Product → Commodity） - 构建vs购买决策框架 - 供应商比较和采购策略 - 英国政府数字市场映射 - 演化预测和战略游戏玩法 ### 第7.5阶段：战略路线图 **`/arckit:roadmap`** → 创建多年架构路线图 为多年转型计划创建战略路线图： - **多年时间线**：3-5年路线图，带有Mermaid Gantt图表，与财政年度对齐（例如2024/25财年） - **战略主题**：云迁移、数据现代化、安全&合规、DevOps转型 - **能力演化**：从L1（初始）到L5（优化）的时间成熟度进展 - **投资规划**：按财政年度划分的CAPEX/OPEX预算、ROI预测、收益实现 - **治理框架**：ARB每月、项目管理委员会每月、指导委员会每季度 - **服务标准关口**：Alpha/Beta/Live评估里程碑（英国政府） - **依赖关系**：Mermaid流程图显示计划顺序和关键路径 - **成功指标**：云采用率、技术债务减少、部署频率、上市时间 - **可追溯性**：路线图主题链接到利益相关者驱动因素、架构原则、需求 - **英国政府特定要求**：支出审查对齐、TCoP合规时间线、NCSC CAF进展 **使用场景**：当您有一个包含多个并行计划的多年转型计划时使用。路线图是战略性的（多年、多个计划、行政沟通），而项目计划是战术性的（单个计划、详细任务、团队执行）。 **路线图输入**：`/arckit:plan`用于详细阶段执行，`/arckit:sobc`用于投资商业案例，`/arckit:backlog`用于优先排序的用户故事，`/arckit:strategy`用于高层综合。 ### 第7.6阶段：架构战略综合 **`/arckit:strategy`** → 综合战略文件，生成高层架构战略 创建一个综合的架构战略文件，将多个战略文件综合成一个连贯的叙述： - **战略愿景**：2-3段阐述转型愿景和成功定义 - **战略驱动因素**：从利益相关者分析中总结，包括外部驱动因素（监管、市场、技术） - **指导原则**：关键原则及其战略影响、合规性总结 - **当前状态评估**：技术格局、能力成熟度基线（L1-L5）、技术债务、SWOT - **目标状态愿景**：未来架构、能力成熟度目标、架构愿景图 - **技术演化**：构建vs购买决策、技术雷达（采用/试用/评估/持有）来自Wardley地图 - **战略主题**：3-5个投资主题，包含目标、计划、成功标准、原则对齐 - **交付路线图摘要**：时间线、阶段、里程碑来自路线图文件 - **投资总结**：CAPEX/OPEX、NPV、IRR、回收期、收益实现来自SOBC - **战略风险**：前置风险，带有热图、假设、约束来自风险登记册 - **成功指标**：关键绩效指标，带有基准和逐年目标 - **治理模型**：论坛、决策权、审查频率 - **可追溯性**：驱动因素→目标→结果→主题→原则→KPI链 **使用场景**：当您有多个战略文件（原则、利益相关者、Wardley、路线图、SOBC）并需要创建一个单一的高层文件，将它们综合成一个连贯的战略时使用。适用于战略委员会演讲、行政简报或利益相关者沟通。 **独特要求**：这是唯一一个需要两个必填输入（原则和利益相关者）的ArcKit命令。没有理解决策框架和利益相关者驱动因素，就无法创建战略。 **战略输入**：`/arckit:requirements`用于详细需求，`/arckit:roadmap`用于扩展时间线，`/arckit:plan`用于项目交付。 ### 第7.7阶段：架构决策记录 **`/arckit:adr`** → 记录架构决策 使用MADF v4.0格式并增强英国政府要求，创建架构决策记录（ADR）： - **决策元数据**：顺序编号（ADR-001、ADR-002）、状态（拟议/接受/废止）、升级级别（团队/跨团队/部门/跨政府） - **利益相关者RACI**：决策者（负责）、咨询（专家、双向）、信息提供（单向沟通） - **背景和问题陈述**：为什么需要此决策、业务/技术/监管驱动因素 - **决策驱动因素**：技术力量（性能、安全、可扩展性）、业务力量（成本、时间）、合规力量（GDS服务标准、TCoP、NCSC、英国GDPR） - **选项分析**：至少2-3个选项加上“不作为”基准，每个都有优缺点、成本（CAPEX/OPEX/TCO）、GDS服务标准影响、Wardley演化阶段 - **Y陈述**：结构化理由 - “在X的背景下，面临Y，我们决定Z以实现A，接受B” - **后果**：积极（收益、能力）、消极（权衡、技术债务）、中立（培训、基础设施）、风险和缓解措施 - **验证**：如何验证实施（设计审查、代码审查、测试、监控） - **可追溯性**：链接到需求、原则、利益相关者、研究、Wardley地图、图表、风险登记册 - **英国政府特定要求**：升级级别（团队→跨团队→部门→跨政府）、治理论坛（ARB、TDA、项目委员会）、服务标准/TCoP合规文档 **使用场景**：在影响系统结构、质量属性或行为的重要架构决策时使用 - 技术选择（数据库、框架、云服务）、集成模式、安全方法、部署策略、数据管理。 **ADR输入**：`/arckit:diagram`（架构图反映决策）、`/arckit:hld-review`和`/arckit:dld-review`（审查验证决策实施）、`/arckit:traceability`（决策是关键可追溯性工件）。 ### 第 14 阶段：合规性评估（英国政府） 适用于英国政府和公共部门项目： **`/arckit:service-assessment`** → [GDS 服务标准](https://www.gov.uk/service-manual/service-assessments) 评估准备 准备强制性的 GDS 服务标准评估： - 分析所有 14 个服务标准点的证据 - 确定 alpha、beta 或 live 评估的差距 - 生成 RAG（红/琥珀/绿）评级和整体准备度评分 - 提供具有优先级和时间表的可行动建议 - 包括评估日准备指南 - 将 ArcKit 工件映射到服务标准证据要求 在发现结束时运行（用于 alpha 准备），在 beta 中期（用于 beta 准备），或在上线前，以确保准备就绪。 **`/arckit:tcop`** → [技术行为准则](https://www.gov.uk/guidance/the-technology-code-of-practice) 评估 评估所有 13 个 TCoP 点的合规性： - 要点 1：定义用户需求 - 要点 2：使事物易于访问 - 要点 3：保持开放并使用开源 - 要点 4：利用开放标准 - 要点 5：优先考虑云服务 - 要点 6：确保安全 - 要点 7：确保隐私完整 - 要点 8：共享、重复使用和协作 - 要点 9：集成和适应技术 - 要点 10：更好地利用数据 - 要点 11：定义采购策略 - 要点 12：满足数字支出控制 - 要点 13：定义负责任的 AI 使用 **`/arckit:secure`** → 英国政府安全设计评估 安全合规性评估： - NCSC 云安全原则 - NCSC 网络评估框架（CAF） - 网络基本 / 网络基本增强版 - 英国 GDPR 和 DPA 2018 合规 - 安全架构审查 - 威胁建模 **`/arckit:ai-playbook`** → [英国政府 AI 手册](https://www.gov.uk/government/publications/ai-playbook-for-the-uk-government) 合规（适用于 AI 系统） 负责任的 AI 评估： - AI 伦理原则 - 透明度和可解释性 - 公平性和偏差缓解 - AI 的数据治理 - 人类监督机制 - 影响评估 **`/arckit:atrs`** → [算法透明度记录标准](https://www.gov.uk/government/collections/algorithmic-transparency-recording-standard-hub) 为算法决策生成 ATRS 记录： - 算法详细信息和逻辑 - 目的和用例 - 数据源和数据质量 - 性能指标和监控 - 影响评估和缓解 **适用于国防部项目**： **`/arckit:mod-secure`** → 国防部安全设计评估 国防部特有的安全合规性： - JSP 440（国防项目和计划管理） - 信息保障成熟度模型（IAMM） - 国防部安全许可和审查 - STRAP 分类处理 - 安全操作程序（SyOPs） - 供应商证明要求 **`/arckit:jsp-936`** → [国防部 JSP 936](https://www.gov.uk/government/publications/jsp-936-dependable-artificial-intelligence-ai-in-defence-part-1-directive) AI 保证文档 适用于使用 AI/ML 系统的国防项目： - JSP 936（国防中的可靠 AI） - 5 个伦理原则（以人为本、责任、理解、偏差和危害缓解、可靠性） - 5 个风险分类级别（关键到次要） - 8 个 AI 生命周期阶段（规划到质量保证） - 批准途径（2PUS/部长级 → 国防级 → TLB 级） - RAISOs 和伦理经理治理 - 人类-AI 团队策略和持续监控 ### 第 14.5 阶段：合规性评估（欧盟和法国政府） ArcKit 包括适用于欧盟监管合规和法国公共部门治理的命令。这些命令适用于在欧盟或法国司法管辖区运营的组织，无论是公共部门还是私营部门。 #### 欧盟法规 **`/arckit:eu-rgpd`** → GDPR 合规性评估（法规 2016/679） 评估个人数据处理义务： - 法律依据确定（同意、合同、合法权益、法律义务） - 数据主体权利实施（访问、删除、便携性、异议） - 法国 CNIL 注册和 DPO 义务 - 跨境转移保障（SCC、BCR、充分性决定） - 与 DPIA（`/arckit:dpia`）集成，用于高风险处理 **`/arckit:eu-ai-act`** → 欧盟 AI 法规合规（法规 2024/1689） 根据欧盟的风险为基础的 AI 框架评估 AI 系统义务： - 风险分类（不可接受/高风险/有限风险/最小风险） - 高风险系统义务：合格评定、CE 标志、EUDB 注册 - 通用 AI 模型提供商义务 - 人类监督、透明度和基本权利影响评估 - 禁止的做法（社会评分、实时生物识别监控） **`/arckit:eu-nis2`** → NIS2 指令合规（指令 2022/2555） 评估基本和重要实体的网络安全义务： - 行业分类（附件 I 基本 vs 附件 II 重要） - 法国转化下的 OIV/OSE 指定（LPM/LCEN） - 治理、风险管理和事件报告义务 - 供应链安全和漏洞披露 - ANSSI 通知时间表（24 小时 → 72 小时 → 30 天最终报告） **`/arckit:eu-dora`** → DORA 合规（法规 2022/2554），适用于金融实体 金融实体数字运营弹性法案义务： - ICT 风险管理框架（5 个支柱） - 主要 ICT 相关事件分类和报告（4 小时 → 72 小时 → 每月最终） - 对显著机构的 TLPT（威胁引导的渗透测试）要求 - 第三方 ICT 提供商管理和关键提供商指定 - ICT 服务协议的合同要求 **`/arckit:eu-cra`** → 网络弹性法案合规（法规 2024/2847） 具有数字元素的产品强制性网络安全要求： - 产品分类（默认/重要类别 I / 关键类别 II） - 12 个附件 I 第一部分的安全设计要求 - SPDX 或 CycloneDX 格式的 SBOM（强制性） - 漏洞披露政策和 24 小时 ENISA 报告 - 合格评定路径（内部控制 vs 通知机构） - 完整申请截止日期：2027 年 12 月 11 日 **`/arckit:eu-dsa`** → 欧盟数字服务法合规（法规 2022/2065） 在线中间服务分级义务： - 提供商分类（单纯通道 / 主机 / 平台 / VLOP / VLOSE） - VLOP/VLOSE 指定阈值：4500 万欧盟月活跃用户 - 内容审核、推荐系统透明度和广告义务 - 法国数字服务协调员（DSC）为 ARCOM - VLOP 的系统性风险评估和独立审计 **`/arckit:eu-data-act`** → 欧盟数据法合规（法规 2023/2854） 连接产品和云提供商的数据共享义务： - 角色确定：制造商/数据持有者/DAPS/公共部门机构 - 用户数据访问权（第 II 章）和 B2B 共享（第 III 章） - 云切换义务（第 VI 章）— 2027 年 9 月消除出口费用 - 国际数据传输限制（第 27 条） - 生效日期：2025 年 9 月 12 日 #### 法国公共部门治理 **`/arckit:fr-rgpd`** → 法国 GDPR 合规，符合 CNIL 特定要求 在欧盟 GDPR 的基础上扩展法国背景： - CNIL 执法优先事项和行业特定指南 - 法国 DPO 注册和 CNIL 事先咨询义务 - 法国法律下的生物识别数据处理（需要 CNIL 授权） **`/arckit:fr-ebios`** → EBIOS 风险管理器方法论（ANSSI 2018） 法国标准风险分析，用于 IS 同源： - 5 个工作坊结构（框架、风险源、战略场景、运营场景、风险处理） - OIV/OSE/公共部门 IS 同源证据 - 攻击路径建模和恐惧事件 - 与 PSSI 和 SecNumCloud 资格集成 **`/arckit:fr-anssi`** → ANSSI 42 网络安全卫生措施评估 评估 ANSSI 的基础卫生指南的合规性： - 7 个主题：管理、身份验证、更新、监控、备份、网络、工作站 - 云安全建议（ANSSI 云资格矩阵） - 具有优先级补救的差距分析（P1-P3） - 与 EBIOS 和 PSSI 集成 **`/arckit:fr-anssi-carto`** → ANSSI SI 地图（4 级 IS 映射） 按照 ANSSI 的 4 级方法生成结构化的 IS 地图： - 第 1 级：业务流程和核心任务 - 第 2 级：应用和数据映射 - 第 3 级：服务器、数据库和系统库存 - 第 4 级：网络拓扑、防火墙规则、互连 - 攻击面总结和敏感流程识别 **`/arckit:fr-secnumcloud`** → SecNumCloud 资格评估 评估 ANSSI 的 SecNumCloud 参考标准下的云提供商和客户义务： - 签证与资格区分（仅完整资格满足 OIV/部长级使用） - SecNumCloud 部署的 IS 同源要求 - SecNumCloud 兼容的架构要求 - 公共云合同的采购条款 **`/arckit:fr-dinum`** → DINUM 数字教义评估 评估法国数字政府教义的合规性： - RGI（互操作性通用参考）— 互操作性标准 - RGAA（可访问性通用参考）— 可访问性 - 云教义（云原生、云优先、敏感数据的 SecNumCloud） - SILL（跨部门自由软件基础）— 推荐的开源堆栈 **`/arckit:fr-marche-public`** → 法国公共采购（公共订单代码） 生成符合法国公共合同法的采购文档： - 公共订单阈值和程序（低于/高于欧盟阈值） - CCAP、CCTP、RC 文档模板 - ANSSI 合格提供商要求（PASSI、PRIS、PDIS） - 公共采购可持续性义务（环境和社会条款） **`/arckit:fr-pssi`** → PSSI（信息系统安全政策） 为法国公共部门实体生成信息系统安全政策： - 最高权威机构批准的 9 部分结构 - 7 个安全领域（网络、工作站、应用程序、信息系统管理、物理、人员、连续性） - RSSI、DPO、DSI 和 FSSI 角色 - 审查周期和与 EBIOS 和同源集成 **`/arckit:fr-dr`** → 限制扩散（DR）合规 评估 DR 管理分类下的文档和信息系统处理要求： - II 901/SGDSN 规则的 DR 文档生命周期 - 电子存储、传输和物理处理义务 - DR 处理系统的 IS 同源 - 范围明确界定：仅 DR — IGI 1300（机密防御及以上）不在范围内 **`/arckit:fr-algorithme-public`** → 法国公共算法透明度通知 根据 CRPA Art. L311-3-1 生成强制性透明度通知： - 范围确定：哪些自动决策被覆盖 - 每个算法的参数、参数和权重描述 - 人类监督机制和上诉权利 - GDPR 第 22 条交汇点（自动个人决策） - ML 系统的 EU AI 法规标记 - 比英国 ATRS 对应条款更具法律约束力 **`/arckit:fr-code-reuse`** → 法国公共代码重复使用评估（ circulaire 2021-1524） 在构建或采购前评估代码重复使用义务： - code.gouv.fr 搜索（法国公共代码目录） - SILL（跨部门自由软件基础）— 部委推荐的开源 - EU 公共代码替代方案（Joinup、欧洲委员会存储库） - 许可兼容性矩阵（推荐 EUPL-1.2 用于公共代码发布） - 决策矩阵：重复使用/分叉/SILL 采用/采购/构建 - circulaire 2021 发布义务：修改后的公共代码必须返回 --- ### 第 15 阶段：项目故事和报告 **`/arckit:story`** → 生成综合项目故事 创建具有完整时间线分析的叙事历史记录： - **时间线分析**：4 种可视化类型（甘特图、线性流程图、详细表格、阶段持续时间饼图） - **时间线指标**：项目持续时间、速度、阶段分析、关键路径识别 - **完整时间线**：git 日志或文件修改日期的所有事件，距开始日期的天数 - **8 个叙事章节**：基础 → 商业案例 → 要求 → 研究 → 采购 → 设计 → 交付 → 合规 - **可追溯性演示**：使用 Mermaid 图显示利益相关者 → 目标 → 要求 → 故事 → 冲刺的端到端链条 - **治理成就**：展示合规性（TCoP、服务标准、NCSC CAF）、风险管理、决策理由 - **战略背景**：Wardley Map 见解、构建 vs 购买决策、供应商选择理由 - **经验教训**：节奏分析、时间线偏差、未来项目建议 - **综合附录**：工件注册、时间线活动日志、DSM、命令参考、词汇表 **何时使用**：在项目里程碑或完成时，为利益相关者、领导层或投资组合报告创建可共享的故事。适用于展示系统化治理和 ArcKit 工作流价值。 **`/arckit:presentation`** → 从项目工件生成 MARP 幻灯片 从现有架构工件生成演示幻灯片： - **MARP 格式**：基于 Markdown 的幻灯片，带有 `---` 分隔符 — 导出为 PDF、PPTX 或 HTML - **焦点模式**：高管（董事会级）、技术（架构细节）、利益相关者（关注收益）、采购（RFP 简报） - **基于工件**：读取所有可用的项目工件，并将关键内容提取到幻灯片中 - **Mermaid 图表**：甘特图、C4 图、饼图和象限图原生嵌入 - **可配置**：选择幻灯片数量（6-8、10-12、15-20）和 MARP 主题（默认、gaia、uncover） - **文档类型代码**：`PRES` **何时使用**：在治理委员会、利益相关者简报、关卡审查或季度投资组合演示之前运行。在创建大多数项目工件以获得最丰富的幻灯片之前运行。 ### 第 16 阶段：文档发布 **`/arckit:pages`** → 生成文档站点 发布所有项目文档为交互式网站： - **静态站点生成**：生成 `docs/index.html` 和 `docs/manifest.json` — 可部署到任何静态主机（GitHub Pages、Netlify、Vercel、S3 等） - **Mermaid 图表渲染**：所有架构图在内联中使用 mermaid.js 渲染 - **项目导航**：具有可折叠项目树、文档类别和版本徽章的侧边栏 — 显示多个版本的文档显示内联下拉选择器 - **GOV.UK 样式**：专业政府设计系统样式 - **文档索引**：manifest.json 提供对所有工件的编程访问 - **LLM 发现**：生成 `docs/llms.txt` ([llmstxt.org](https://llmstxt.org/) 格式），以便 LLM 代理和爬虫可以索引每个工件、指南和项目。手动策划的 `docs/llms.txt` 文件（不带 ArcKit 生成标记）在重新运行时保留 **何时使用**：当您想通过专业网页界面与利益相关者共享项目文档，或创建所有架构工件的投资组合视图时使用。 --- ## 支持的 AI 助手 | 助手 | 支持 | 备注 | |-----------|---------|-------| | [Claude Code](https://www.anthropic.com/claude-code) | ✅ 首选 | **主要平台。** 插件支持代理、钩子、MCP 服务器和自动更新 | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ✅ 完整 | 扩展支持命令、MCP 服务器和自动更新 | | [GitHub Copilot](https://github.com/features/copilot) | ✅ 核心 | VS Code 文件、自定义代理和存储库范围的指令（`arckit init --ai copilot`） | | [OpenAI Codex CLI](https://chatgpt.com/features/codex) | ✅ 核心 | CLI 支持命令和模板。ChatGPT Plus/Pro/Enterprise（[设置指南](.codex/README.md)) | | [OpenCode CLI](https://opencode.net/cli) | ✅ 核心 | CLI 支持命令和模板 | > **平台支持**：ArcKit 在 **Linux** 上开发和测试。Windows 有限支持 — 钩子（会话初始化、项目上下文、文件名验证、MCP 自动允许）需要 bash 和 jq，而这些在 Windows 上不可用。对于 Windows 上的最佳体验，请使用 **devcontainer** 或 **WSL2**。 ### 为什么选择克劳德代码？ 克劳德代码是 **ArcKit的主要开发平台**，提供了其他格式所不具备的功能： | 功能 | 克劳德代码 | Gemini CLI | Copilot | Codex / OpenCode | |---------|:-----------:|:----------:|:-------:|:----------------:| | 75种跨AI斜杠命令 | ✅ | ✅ | ✅ | ✅ | | `/arckit:build` 并行构建工具（仅克劳德 - 依赖并行Agent调度） | ✅ | — | — | — | | 模板和脚本 | ✅ | ✅ | ✅ | ✅ | | 捆绑的MCP服务器（AWS，Azure，GCP，DataCommons，govreposcrape） | ✅ | ✅（3个服务器） | — | 手动设置 | | **自主研究代理**（10个研究、数据侦察、云研究、政府代码发现、拨款、框架代理） | ✅ | — | ✅（10个代理） | — | | **SessionStart钩子**（自动检测版本 + 项目） | ✅ | — | — | — | | **UserPromptSubmit钩子**（每个提示的项目上下文注入） | ✅ | — | — | — | | **PreToolUse钩子**（ARC文件名自动纠正） | ✅ | — | — | — | | **PermissionRequest钩子**（自动允许MCP文档工具） | ✅ | — | — | — | | **每命令停止钩子**（输出验证，例如沃德利地图数学检查） | ✅ | — | — | — | | 沃德利映射技能（带有Pinecone MCP书籍语料库） | ✅ | — | — | — | | Mermaid语法参考技能（23种图表类型 + 配置） | ✅ | ✅ | — | ✅ | | 自动市场更新 | ✅ | ✅ | 手动重新安装 | 手动重新安装 | | 零配置安装 | ✅ | ✅ | 需要`arckit init` | 需要`arckit init` | **代理**在隔离的上下文窗口中运行研究密集型命令（市场研究、数据源发现、云服务评估），保持主对话清洁，并启用数十个WebSearch/WebFetch/MCP调用而不会导致上下文膨胀。 **钩子**提供自动治理：文件名自动纠正为ArcKit约定，每个提示注入项目上下文，以便命令知道存在哪些工件，MCP工具自动批准，生成的输出（如沃德利地图）在最终确定前进行数学一致性验证。 Gemini CLI提供了所有命令和MCP服务器的强大体验，但缺乏代理委托和钩子。GitHub Copilot提供了所有75个官方命令作为提示文件和10个自定义代理，但缺乏钩子和MCP服务器。Codex CLI和OpenCode CLI提供了核心命令功能，但需要手动设置和`arckit init`脚手架。 ### 为什么是命令，而不是技能 克劳德代码自动将ArcKit命令公开为 **技能**（它们出现在技能列表中，可以通过自然语言匹配）。ArcKit故意使用 **斜杠命令** 而不是独立的技能，因为： - **需要故意调用** - 每个命令都会生成一个重量级的治理文档（需求规范、风险登记、DPIA等）。根据对话意图自动触发可能会浪费大量时间和令牌。 - **依赖顺序** - 命令遵循一个刻意的顺序（原则 → 利益相关者 → 需求 → 数据模型 → 等）。可以自动触发的技能可能会乱序运行。 - **用户输入通过 `$ARGUMENTS`** - 大多数命令接受来自用户的上下文（项目名称、范围、约束）。命令系统使用 `$ARGUMENTS` 替换来处理这一点。 - **两者兼而有之** - 由于克劳德代码自动将命令公开为技能，用户可以明确调用 `/arckit:requirements`，也可以在克劳德识别意图时使用自然语言匹配 - 无需重新构造。 ### 与 GitHub Copilot 结合使用 对于 VS Code 中的 GitHub Copilot 用户，ArcKit 命令作为提示文件和自定义代理提供： ```bash # 安装和创建项目（3个步骤，零配置） pip install git+https://github.com/tractorjuice/arc-kit.git arckit init my-project --ai copilot cd my-project && code . # 然后在 Copilot Chat 中使用 ArcKit 命令 /arckit-principles 为金融服务创建原则 /arckit-stakeholders 分析云迁移的利益相关者 /arckit-requirements 创建全面需求 ``` 这会创建 `.github/prompts/arckit-*.prompt.md`、`.github/agents/arckit-*.agent.md`（10 个自定义代理）和 `.github/copilot-instructions.md`（存储库范围的上下文）。 ### 与 Codex CLI 结合使用 对于 OpenAI Codex CLI 用户，ArcKit 命令作为技能提供并自动发现： ```bash # 安装和创建项目（3个步骤，零配置） pip install git+https://github.com/tractorjuice/arc-kit.git arckit init my-project --ai codex cd my-project && codex # 然后使用 ArcKit 技能 $arckit-principles 为金融服务创建原则 $arckit-stakeholders 分析云迁移的利益相关者 $arckit-requirements 创建全面需求 ``` 参见 [.codex/README.md](.codex/README.md) 了解 Codex CLI 的完整设置和使用。 ## 项目结构 ArcKit 创建以下结构： ```text payment-modernization/ ├── .arckit/ │ ├── scripts/ │ │ └── bash/ # 自动化脚本 │ ├── templates/ # 默认模板（由 arckit init 刷新） │ └── templates-custom/ # 自定义模板（在更新过程中保留） ├── projects/ │ ├── 000-global/ │ │ └── ARC-000-PRIN-v1.0.md # 全球原则 │ └── 001-payment-gateway/ │ ├── ARC-001-STKE-v1.0.md # 利益相关者分析 │ ├── ARC-001-RISK-v1.0.md # 风险登记册（橙皮书） │ ├── ARC-001-SOBC-v1.0.md # 战略概要商业案例 │ ├── ARC-001-REQ-v1.0.md # 全面的需求 │ ├── ARC-001-DATA-v1.0.md # 数据模型与 ERD、GDPR 合规性 │ ├── wardley-maps/ # 战略沃德利地图 │ │ ├── ARC-001-WARD-001-v1.0.md # 当前架构定位 │ │ ├── ARC-001-WARD-002-v1.0.md # 目标架构愿景 │ │ ├── ARC-001-WARD-003-v1.0.md # 差距分析 │ │ └── ARC-001-WARD-004-v1.0.md # 构建 vs 购买决策 │ ├── ARC-001-SOW-v1.0.md # 工作说明（RFP） │ ├── ARC-001-EVAL-v1.0.md # 供应商评估框架 │ ├── vendors/ │ │ ├── acme-corp/ │ │ │ ├── proposal.pdf │ │ │ ├── scoring.md │ │ │ ├── hld-v1.md │ │ │ └── reviews/ │ │ │ └── hld-v1-review.md │ │ ├── beta-systems/ │ │ │ └── ... │ │ └── comparison.md │ ├── ARC-001-SNOW-v1.0.md # 服务管理设计 │ ├── ARC-001-TRAC-v1.0.md # 追溯性矩阵 │ └── final/ │ ├── selected-vendor.md │ ├── approved-hld.md │ └── dld/ ├── .agents/skills/ # Codex CLI 技能（自动发现） ├── .codex/ │ ├── agents/ # 代理配置 │ └── config.toml # MCP 服务器 + 代理角色 ├── .github/ │ ├── prompts/arckit-*.prompt.md # GitHub Copilot 提示文件（70 个官方 + 社区叠加层） │ ├── agents/arckit-*.agent.md # GitHub Copilot 自定义代理（10 个代理） │ └── copilot-instructions.md # 存储库范围的 Copilot 上下文 └── .opencode/commands/ # OpenCode CLI 命令 ``` --- ## 模板定制 在不修改默认模板的情况下自定义 ArcKit 模板： ```bash # 在 AI 助手内 /arckit:customize requirements # 复制需求模板进行编辑 /arckit:customize all # 复制所有模板 /arckit:customize list # 查看可用模板 ``` **工作原理：** - 默认模板位于 `.arckit/templates/`（由 `arckit init` 刷新） - 自定义模板位于 `.arckit/templates-custom/`（在更新过程中保留） - 命令自动检查自定义模板，首先使用默认模板作为备用 **常见自定义：** - 添加组织特定的文档控制字段 - 包括强制性合规部分（ISO 27001、PCI-DSS） - 添加部门特定的审批工作流程 - 自定义英国政府分类横幅 --- ## 完整命令参考 ArcKit核心命令，附有成熟度状态和公共测试存储库的示例输出。 ### 状态图例 | 状态 | 描述 | |--------|-------------| | 🟢 **上线** | 生产就绪，已广泛测试 | | 🔵 **测试中** | 功能完整，积极完善 | | 🟠 **测试中** | 可用，测试有限 | | 🟣 **实验中** | 新增于 v0.11.x，早期采用者 | ### 示例存储库 | 代码 | 存储库 | 描述 | |------|------------|-------------| | v1 | [arckit-test-project-v1-m365](https://github.com/tractorjuice/arckit-test-project-v1-m365) | Microsoft 365 GCC-H 迁移 | | v2 | [arckit-test-project-v2-hmrc-chatbot](https://github.com/tractorjuice/arckit-test-project-v2-hmrc-chatbot) | HMRC 税务助手聊天机器人 | | v3 | [arckit-test-project-v3-windows11](https://github.com/tractorjuice/arckit-test-project-v3-windows11) | Windows 11 企业部署 | | v6 | [arckit-test-project-v6-patent-system](https://github.com/tractorjuice/arckit-test-project-v6-patent-system) | IPO 专利申请系统 | | v7 | [arckit-test-project-v7-nhs-appointment](https://github.com/tractorjuice/arckit-test-project-v7-nhs-appointment) | NHS 预约预订 | | v8 | [arckit-test-project-v8-ons-data-platform](https://github.com/tractorjuice/arckit-test-project-v8-ons-data-platform) | ONS 数据平台现代化 | | v9 | [arckit-test-project-v9-cabinet-office-genai](https://github.com/tractorjuice/arckit-test-project-v9-cabinet-office-genai) | 内阁办公室 GenAI 平台 | | v10 | [arckit-test-project-v10-training-marketplace](https://github.com/tractorjuice/arckit-test-project-v10-training-marketplace) | 英国政府培训市场 | | v11 | [arckit-test-project-v11-national-highways-data](https://github.com/tractorjuice/arckit-test-project-v11-national-highways-data) | 国家公路数据架构 | | v14 | [arckit-test-project-v14-scottish-courts](https://github.com/tractorjuice/arckit-test-project-v14-scottish-courts) | 苏格兰法院 GenAI 战略 | | v16 | [arckit-test-project-v16-doctors-appointment](https://github.com/tractorjuice/arckit-test-project-v16-doctors-appointment) | 医生在线预约系统 | | v17 | [arckit-test-project-v17-fuel-prices](https://github.com/tractorjuice/arckit-test-project-v17-fuel-prices) | 英国政府燃料价格透明度服务 | | v18 | [arckit-test-project-v18-smart-meter](https://github.com/tractorjuice/arckit-test-project-v18-smart-meter) | 英国智能电表数据消费者应用 | | v19 | [arckit-test-project-v19-gov-api-aggregator](https://github.com/tractorjuice/arckit-test-project-v19-gov-api-aggregator) | 英国政府 API 聚合器 | | v21 | [arckit-test-project-v21-criminal-courts](https://github.com/tractorjuice/arckit-test-project-v21-criminal-courts) | 刑事法院技术审查 - 技术与 AI | | v22 | [arckit-test-project-v22-genai-playbook](https://github.com/tractorjuice/arckit-test-project-v22-genai-playbook) | 英国政府 GenAI 攻略 | | v45 | [arckit-test-project-v45-nsi-rainbow](https://github.com/tractorjuice/arckit-test-project-v45-nsi-rainbow) | NS&I 数字化现代化（彩虹项目） | | v46 | [arckit-test-project-v46-gds-local](https://github.com/tractorjuice/arckit-test-project-v46-gds-local) | GDS 本地 | | v46 | [arckit-test-project-v46-sdg](https://github.com/tractorjuice/arckit-test-project-v46-sdg) | ArcKit 可持续发展目标（SDG）多仓库（17个联合国可持续发展目标，78个英国政府项目） | | v47 | [arckit-test-project-v47-dft-transforming-city-regions](https://github.com/tractorjuice/arckit-test-project-v47-dft-transforming-city-regions) | 交通部城市地区转型资金系统 | | v50 | [arckit-test-project-v50-post-office-horizon](https://github.com/tractorjuice/arckit-test-project-v50-post-office-horizon) | 邮局地平线 | ### 基础 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:init` | 初始化 ArcKit 项目结构，包含编号的项目目录和全局工件 | — | 🟢 上线 | | `/arckit:start` | 使用 ArcKit 进行定位 - 检查项目状态，探索可用命令并选择下一步 | — | 🟢 上线 | | `/arckit:plan` | 创建具有时间线、阶段、关口和 Mermaid 图的项目计划 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-PLAN-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-PLAN-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-PLAN-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/ARC-005-PLAN-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-PLAN-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-PLAN-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/ARC-001-PLAN-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-PLAN-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-PLAN-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-PLAN-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-PLAN-v1.0.md) | 🟢 上线 | | `/arckit:principles` | 创建或更新企业架构原则 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/000-global/ARC-000-PRIN-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/000-global/ARC-000-PRIN-v1.0.md) [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/000-global/ARC-000-PRIN-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/000-global/ARC-000-PRIN-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/000-global/ARC-000-PRIN-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/000-global/ARC-000-PRIN-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/000-global/ARC-000-PRIN-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/000-global/ARC-000-PRIN-v1.0.md) [v7](https://tractorjuice.github.io/arckit-test-project-v7-nhs-appointment/#projects/000-global/ARC-000-PRIN-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/000-global/ARC-000-PRIN-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/000-global/ARC-000-PRIN-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/000-global/ARC-000-PRIN-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/000-global/ARC-000-PRIN-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/000-global/ARC-000-PRIN-v1.0.md) | 🟢 上线 | ### 互操作性 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:export-okf` | 将 ArcKit 项目工件导出为 OKF Markdown 包，而不更改源 ARC 文件 | — | 🔵 测试中 | | `/arckit:import-okf` | 将 OKF Markdown 包导入 ArcKit 作为可审查的研究笔记，并附带 JSON 报告 | — | 🔵 测试中 | ### 战略背景 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:stakeholders` | 分析利益相关者的驱动因素、目标和可衡量的结果 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/ARC-001-STKE-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-STKE-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-STKE-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-STKE-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-STKE-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-STKE-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/ARC-005-STKE-v1.0.md) [v3/006](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/006-large-format-printer/ARC-006-STKE-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/ARC-007-STKE-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-STKE-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-STKE-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-STKE-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/ARC-001-STKE-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-STKE-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-STKE-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-STKE-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-STKE-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-STKE-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/ARC-001-STKE-v1.0.md) | <font color="green">上线</font> | | `/arckit:risk` | 创建符合英国财政部橙皮书原则的全面风险登记册 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-RISK-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-RISK-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-RISK-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-RISK-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/ARC-005-RISK-v1.0.md) [v3/006](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/006-large-format-printer/ARC-006-RISK-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/ARC-007-RISK-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-RISK-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-RISK-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-RISK-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-RISK-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-RISK-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-RISK-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-RISK-v1.0.md) | <font color="green">上线</font> | | `/arckit:sobc` | 使用英国政府绿皮书5-case模型创建战略大纲商业案例（SOBC） | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-SOBC-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-SOBC-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-SOBC-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-SOBC-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/ARC-005-SOBC-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/ARC-007-SOBC-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-SOBC-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-SOBC-v1.0.md) | <font color="green">上线</font> | ### 需求与数据 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:requirements` | 创建全面的业务和技术需求 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/ARC-001-REQ-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-REQ-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-REQ-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-REQ-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-REQ-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-REQ-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/ARC-005-REQ-v1.0.md) [v3/006](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/006-large-format-printer/ARC-006-REQ-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/ARC-007-REQ-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-REQ-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-REQ-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-REQ-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/ARC-001-REQ-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-REQ-v1.0.md) [v7](https://tractorjuice.github.io/arckit-test-project-v7-nhs-appointment/#projects/001-nhs-appointment-booking/ARC-001-REQ-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-REQ-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-REQ-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-REQ-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-REQ-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/ARC-001-REQ-v1.0.md) | <font color="green">上线</font> | | `/arckit:data-model` | 创建全面的数据模型，包括实体关系、GDPR合规性和数据治理 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-DATA-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-DATA-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-DATA-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-DATA-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/ARC-001-DATA-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-DATA-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-DATA-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-DATA-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-DATA-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-DATA-v1.0.md) | <font color="green">上线</font> | | `/arckit:data-mesh-contract` | 为网格架构创建联邦数据产品合约，包括SLA、治理和互操作性保证 | — | <font color="#ff0">Alpha</font> | | `/arckit:dpia` | 为英国GDPR第35条合规性生成[数据保护影响评估（DPIA）](https://ico.org.uk/for-organisations/uk-gdpr-guidance-and-resources/accountability-and-governance/data-protection-impact-assessments-dpias/) | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-DPIA-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-DPIA-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-DPIA-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-DPIA-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-DPIA-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-DPIA-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-DPIA-v1.0.md) | <font color="#008000">Beta</font> | ### 研究与策略 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:platform-design` | 使用平台设计工具包（8个画布，用于多边生态系统）创建平台策略 | [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-GAAP-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/ARC-001-PLAT-v1.0.md) | <font color="#a020f0">实验中</font> | | `/arckit:research` | 研究满足需求的技术、服务和产品，并进行构建或购买分析 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-RSCH-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-RSCH-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/research/ARC-001-RSCH-001-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-RSCH-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-RSCH-v1.0.md) | <font color="#008000">Beta</font> | | `/arckit:grants` | 研究英国政府拨款、慈善资金和加速器计划，并评估其资格 | — | <font color="#a020f0">实验中</font> | | `/arckit:wardley` | 为架构决策和构建或购买分析创建战略Wardley地图 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/wardley-maps/ARC-001-WARD-001-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/wardley-maps/ARC-001-WARD-001-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/wardley-maps/ARC-001-WARD-001-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/wardley-maps/ARC-001-WARD-001-v1.0.md) | <font color="#a020f0">实验中</font> | | `/arckit:wardley.value-chain` | 将用户需求分解为Wardley映射的值链 | — | <font color="#a020f0">实验中</font> | | `/arckit:wardley.doctrine` | 评估组织教义成熟度（4个阶段，40+原则） | — | <font color="#a020f0">实验中</font> | | `/arckit:wardley.gameplay` | 分析来自60+种游戏玩法的战略 | — | <font color="#a020f0">实验中</font> | | `/arckit:wardley.climate` | 评估影响映射组件的32种气候模式 | — | <font color="#a020f0">实验中</font> | | `/arckit:strategy` | 将战略制品合成成面向高层的架构战略文档 | — | <font color="#008000">Beta</font> | | `/arckit:roadmap` | 创建具有多年时间表、能力演进和治理的战略架构路线图 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-ROAD-v1.0.md) | <font color="#008000">Beta</font> | | `/arckit:framework` | 将架构制品转化为结构化、可重用的框架，具有原则、模式和实施指导 | — | <font color="#008000">Beta</font> | | `/arckit:adr` | 使用选项分析和可追溯性记录架构决策 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/decisions/ARC-001-ADR-001-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/decisions/ARC-002-ADR-001-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/decisions/ARC-003-ADR-001-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/decisions/ARC-004-ADR-001-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/decisions/ARC-005-ADR-001-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/decisions/ARC-007-ADR-001-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/decisions/ARC-001-ADR-001-v1.0.md) | <font color="#008000">Beta</font> | ### 云研究（MCP） 这些命令使用 [模型上下文协议（MCP）](https://modelcontextprotocol.io/) 服务器实时访问权威的云提供商文档。Claude Code 插件自动捆绑了 MCP 服务器。Gemini 和 Codex 用户需要单独安装它们。 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:azure-research` | 使用 [微软学习MCP](https://www.npmjs.com/package/@anthropic/mcp-server-microsoft-docs) 研究 Azure 服务和架构模式 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/research/ARC-001-AZRS-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/research/ARC-002-AZRS-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/research/ARC-001-AZRS-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/research/ARC-001-AZRS-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/research/ARC-001-AZRS-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/research/ARC-001-AZRS-v1.0.md) | 🟣 实验中 | | `/arckit:aws-research` | 使用 [AWS 知识MCP](https://awslabs.github.io/mcp/servers/aws-knowledge-mcp-server) 研究 AWS 服务和架构模式 | [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/research/ARC-001-AWRS-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/research/ARC-001-AWRS-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/research/ARC-001-AWRS-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/research/ARC-001-AWRS-v1.0.md) | 🟣 实验中 | | `/arckit:gcp-research` | 使用 [谷歌开发者知识MCP](https://developerknowledge.googleapis.com/mcp) 研究 Google Cloud 服务和架构模式 | — | 🟣 实验中 | ### 数据源发现 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:datascout` | 发现外部数据源（API、数据集、开放数据门户）以满足项目需求 | [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-DSCT-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-DSCT-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/ARC-001-DSCT-v1.0.md) | 🟣 实验中 | > **注意**: 谷歌开发者知识MCP需要一个API密钥（`GOOGLE_API_KEY`环境变量）。请参阅 [GCP研究指南](docs/guides/gcp-research.md) 获取设置说明。 ### 采购市场情报 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:tenders` | 采购市场情报 - 奖励价值基准、顶级供应商、 incumbency 和集中度，来自英国招标MCP | — | 🟣 实验中 | | `/arckit:competitors` | 竞争对手格局 - 竞争对手供应商、奖励价值市场份额、直接对比和集中度，来自英国招标MCP | — | 🟣 实验中 | > **注意**: `/arckit:tenders` 和 `/arckit:competitors` 都使用捆绑的 `uk-tenders` MCP服务器（无密钥，延迟）通过共享的 `arckit-tenders-reader` 子代理。数据：~677,000 个英国采购流程，涵盖 FTS、Contracts Finder、Public Contracts Scotland、Sell2Wales 和 eTendersNI；每晚刷新；最佳可用性（无正式 SLA）。`/arckit:tenders` 输出一个 `TNDR` 神器（市场范围基准、 incumbency、集中度）。`/arckit:competitors` 输出一个 `CMPT` 神器（竞争对手供应商格局、市场份额排名、直接对比）。 ### 政府代码发现 这些命令使用 [govreposcrape MCP](https://github.com/MHCLG/govreposcrape-mcp) 服务器搜索 24,500+ 个英国政府存储库。Claude Code 插件自动捆绑了 MCP 服务器。不需要 API 密钥。 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:gov-code-search` | 使用自然语言搜索 24,500+ 个英国政府存储库 | — | 🟣 实验中 | | `/arckit:gov-landscape` | 为某个领域映射英国政府代码格局 | — | 🟣 实验中 | | `/arckit:gov-reuse` | 在从头开始构建之前发现可重复使用的英国政府代码 | — | 🟣 实验中 | ### 采购 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:sow` | 为供应商采购生成工作说明书（SOW）/ RFP 文档 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/ARC-001-SOW-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-SOW-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-SOW-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-SOW-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-SOW-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-SOW-v1.0.md) | 🟢 上线 | | `/arckit:dos` | 为英国数字市场生成数字成果和专家（DOS）采购文档 | — | 🟣 实验中 | | `/arckit:gcloud-search` | 在英国数字市场上使用实时搜索和比较查找 G-Cloud 服务 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-GCLD-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-GCLD-v1.0.md) | 🟣 实验中 | | `/arckit:gcloud-clarify` | 分析 G-Cloud 服务差距并生成供应商澄清问题 | — | 🟣 实验中 | | `/arckit:evaluate` | 创建供应商评估框架并评估供应商提案 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/ARC-001-EVAL-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-EVAL-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-EVAL-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-EVAL-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-EVAL-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-EVAL-v1.0.md) | 🟢 上线 | | `/arckit:score` | 使用结构化存储、并排比较、敏感性分析和审计跟踪来评估供应商提案 | — | 🔵 测试中 | ### 设计与架构 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:diagram` | 使用 Mermaid 生成架构图进行可视化文档 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/diagrams/ARC-001-DIAG-001-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/diagrams/ARC-001-DIAG-001-v1.0.md) [v3/005](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/005-cloud-pki/diagrams/ARC-005-DIAG-001-v1.0.md) [v3/007](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/007-vpn-service-windows11-autopilot/diagrams/ARC-007-DIAG-001-v1.0.md) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/#projects/001-ai-training-marketplace/diagrams/ARC-001-DIAG-001-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/diagrams/ARC-001-DIAG-001-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/diagrams/ARC-001-DIAG-001-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/diagrams/ARC-001-DIAG-001-v1.0.md) | 🟢 上线 | | `/arckit:hld-review` | 审查高级别设计（HLD）以对抗架构原则和需求 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-HLDR-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-HLDR-v1.0.md) | 🔵 测试中 | | `/arckit:dld-review` | 审查详细设计（DLD）以检查实施准备情况 | — | 🔵 测试中 | ### 操作 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:backlog` | 从 ArcKit 工件生成优先产品待办事项 - 将需求转换为用户故事，组织成冲刺 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-BKLG-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-BKLG-v1.0.md) [|v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-BKLG-v1.0.md) [v3/004](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/004-conference-facilities-modernization/ARC-004-BKLG-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-BKLG-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-BKLG-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-BKLG-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/ARC-001-BKLG-v1.0.md) | 🔵 测试中 | | `/arckit:trello` | 将产品待办事项导出到 Trello - 从待办事项 JSON 创建板块、列表、卡片，带有标签和检查清单 | — | 🟣 实验中 | | `/arckit:servicenow` | 使用 CMDB、SLA、事件管理和变更控制创建全面的 ServiceNow 服务设计 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-SNOW-v1.0.md) | 🔵 测试中 | | `/arckit:devops` | 使用 CI/CD 管道、IaC、容器编排和开发人员体验创建 DevOps 策略 | [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-DEVOPS-v1.0.md) | 🟣 实验中 | | `/arckit:mlops` | 使用模型生命周期、训练管道、服务、监控和治理创建 MLOps 策略 | [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-MLOPS-v1.0.md) | 🟣 实验中 | | `/arckit:finops` | 使用云成本管理、优化、治理和预测创建 FinOps 策略 | [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-FINOPS-v1.0.md) | 🟣 实验中 | | `/arckit:operationalize` | 使用支持模型、运行手册、DR/BCP、on-call 和交接文档创建运营就绪包 | [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-OPS-v1.0.md) | 🟣 实验中 | | `/arckit:traceability` | 从需求到设计到测试生成需求可追溯性矩阵 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/#projects/001-exchange-online-migration/ARC-001-TRAC-v1.0.md) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-TRAC-v1.0.md) [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-TRAC-v1.0.md) [v3/002](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/002-application-packaging-rationalisation/ARC-002-TRAC-v1.0.md) [v3/003](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/003-peripherals-update-upgrade/ARC-003-TRAC-v1.0.md) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-TRAC-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-TRAC-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-TRAC-v1.0.md) | 🟢 上线 | ### 质量与治理 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:analyze` | 对架构工件进行全面治理质量分析 | [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-ANAL-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-ANAL-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-ANAL-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-ANAL-v1.0.md) | 🔵 测试中 | | `/arckit:principles-compliance` | 评估架构原则的合规性并生成记分卡，包含证据、差距和建议 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-PRIN-COMP-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-PRIN-COMP-v1.0.md) | 🟢 上线 | | `/arckit:story` | 使用时间线分析、可追溯性和治理成就生成综合项目故事 | [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-STORY-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-STORY-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-STORY-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-STORY-v1.0.md) | 🟢 上线 | | `/arckit:presentation` | 从项目工件生成 MARP 幻灯片用于治理委员会和利益相关者简报 | — | 🔵 测试中 | | `/arckit:conformance` | 评估架构一致性 - ADR 决策实施、决策间一致性、架构漂移、技术债务和自定义约束规则 | — | 🔵 测试中 | | `/arckit:health` | 扫描项目是否存在过时的研究、被遗忘的 ADR、未解决的审查条件、孤立的需求、缺失的可追溯性和版本漂移 | — | 🔵 测试中 | | `/arckit:impact` | 分析变更的爆炸半径 - 反向依赖跟踪 | — | 🟣 实验中 | | `/arckit:search` | 按关键词、文档类型或需求 ID 跨所有项目工件进行搜索 | — | 🔵 测试中 | | `/arckit:navigator` | 项目级 GPS - 显示针对 ArcKit 基线覆盖率的覆盖情况，浮出 DRAFT/stale/孤立工件，并推荐运行的下一个斜杠命令 | — | 🟢 上线 | | `/arckit:graph-report` | 治理指标仪表盘 - 覆盖率分类、交叉引用密度、合规性就绪情况以及跨所有工作项目的项目比较 | — | 🟢 上线 | | `/arckit:customize` | 复制模板到 `.arckit/templates-custom/` 进行自定义（在更新期间保留） | — | 🟢 上线 | | `/arckit:maturity-model` | 使用当前状态评估、目标状态定义和改进路线图生成能力成熟度模型 | — | 🔵 测试中 | | `/arckit:template-builder` | 通过交互式采访创建新的文档模板 - 生成社区来源的模板、指南和可选的可共享包 | — | 🟠 Alpha | ### 英国政府 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:service-assessment` | 为 [GDS 服务标准](https://www.gov.uk/service-manual/service-assessments) 评估做准备 - 分析 14 个要点证据，识别差距，生成就绪报告 | [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-SASS-v1.0.md) | 🔵 测试中 | | `/arckit:tcop` | 为英国政府技术项目生成[技术实践准则（TCoP）](https://www.gov.uk/guidance/the-technology-code-of-practice) 审查文件 | [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/#projects/001-patent-management-system-for-the-intellectual-property-office/ARC-001-TCOP-v1.0.md) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-TCOP-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-TCOP-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-TCOP-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-TCOP-v1.0.md) | 🔵 测试中 | | `/arckit:secure` | 为英国政府项目（民用部门）生成“安全设计”评估 | [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/#projects/001-ons-data-platform-modernisation/ARC-001-SECD-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-SECD-v1.0.md) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/#projects/001-national-highways-data-architecture-modernization/ARC-001-SECD-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-SECD-v1.0.md) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/#projects/001-doctors-appointment/ARC-001-SECD-v1.0.md) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/#projects/001-uk-fuel-price-transparency-service/ARC-001-SECD-v1.0.md) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/#projects/001-smart-meter-app/ARC-001-SECD-v1.0.md) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/#projects/001-uk-government-api-aggregator/ARC-001-SECD-v1.0.md) | 🔵 测试中 | | `/arckit:ai-playbook` | 评估英国政府 AI 指南的合规性，以实现 AI 的负责任部署 | [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-AIPB-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-AIPB-v1.0.md) | 🟠 Alpha | | `/arckit:atrs` | 为 AI/算法工具生成[算法透明度记录标准（ATRS）](https://www.gov.uk/government/collections/algorithmic-transparency-recording-standard-hub) 记录 | [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/#projects/001-hmrc-chatbot/ARC-001-ATRS-v1.0.md) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/#projects/001-cabinet-office-genai/ARC-001-ATRS-v1.0.md) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/#projects/001-scts-genai-programme/ARC-001-ATRS-v1.0.md) | 🟠 Alpha | ### 英国国防部 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:mod-secure` | 为英国国防部项目使用 CAAT 和持续保障生成“安全设计”评估 | [v3/001](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/001-windows-11-migration-intune/ARC-001-SECD-MOD-v1.0.md) [v3/006](https://tractorjuice.github.io/arckit-test-project-v3-windows11/#projects/006-large-format-printer/ARC-006-SECD-MOD-v1.0.md) | 🟣 实验中 | | `/arckit:jsp-936` | 为国防 AI/ML 系统生成 [MOD JSP 936](https://www.gov.uk/government/publications/jsp-936-dependable-artificial-intelligence-ai-in-defence-part-1-directive) AI 保障文档 | — | 🟣 实验中 | ### 文档和发布 | 命令 | 描述 | 示例 | 状态 | |---------|-------------|----------|--------| | `/arckit:glossary` | 生成包含术语、定义、缩写和交叉引用的综合项目词汇表 | — | 🔵 测试中 | | `/arckit:pages` | 生成带有 Mermaid 图支持的文档站点 | [v1](https://tractorjuice.github.io/arckit-test-project-v1-m365/) [v2](https://tractorjuice.github.io/arckit-test-project-v2-hmrc-chatbot/) [v3](https://tractorjuice.github.io/arckit-test-project-v3-windows11/) [v6](https://tractorjuice.github.io/arckit-test-project-v6-patent-system/) [v7](https://tractorjuice.github.io/arckit-test-project-v7-nhs-appointment/) [v8](https://tractorjuice.github.io/arckit-test-project-v8-ons-data-platform/) [v9](https://tractorjuice.github.io/arckit-test-project-v9-cabinet-office-genai/) [v10](https://tractorjuice.github.io/arckit-test-project-v10-training-marketplace/) [v11](https://tractorjuice.github.io/arckit-test-project-v11-national-highways-data/) [v14](https://tractorjuice.github.io/arckit-test-project-v14-scottish-courts/) [v16](https://tractorjuice.github.io/arckit-test-project-v16-doctors-appointment/) [v17](https://tractorjuice.github.io/arckit-test-project-v17-fuel-prices/) [v18](https://tractorjuice.github.io/arckit-test-project-v18-smart-meter/) [v19](https://tractorjuice.github.io/arckit-test-project-v19-gov-api-aggregator/) | 🟠 Alpha | --- ## 战略架构的沃德利映射 ArcKit 使用沃德利地图来暴露每个组件的战略位置，然后再提交解决方案。`/arckit:wardley` 命令生成可直接可视化的地图： - 跟踪用户需求通过支持价值链，以便显现空白和重复的工作。 - 绘制从 Genesis → 商品的演变，以揭示何时构建、购买、重用或淘汰能力。 - 为采购、供应商评估和设计审查提供共享的情境感知。 地图以开放的沃德利地图格式发出 - 直接粘贴到 [https://create.wardleymaps.ai](https://create.wardleymaps.ai) 以获得可视化视图。完整的示例输出位于公共演示中，例如 `arckit-test-project-v3-windows11`（企业操作系统升级策略）和 `arckit-test-project-v14-scottish-courts`（GenAI 平台策略）。 --- ## 带有 Mermaid 的架构图 **ArcKit 使用 Mermaid 生成视觉架构图以实现清晰的技术交流。** ### 什么是架构图？ 架构图可视化系统结构、交互和部署，用于： - **技术交流**：与利益相关者共享架构 - **设计文档**：记录当前和未来状态 - **供应商评估**：比较供应商的技术方法 - **英国政府合规**：可视化 Cloud First、GOV.UK 服务、PII 处理 ### 图表类型 ArcKit 支持基于 C4 模型和企业架构最佳实践的 6 种基本图表类型： | 图表类型 | 级别 | 目的 | 何时使用 | |--------------|-------|---------|-------------| | **C4 上下文** | 级别 1 | 系统及其用户和外部系统的上下文 | 需求后，用于显示系统边界 | | **C4 容器** | 级别 2 | 技术容器和技术选择 | 高级设计后，用于供应商审查 | | **C4 组件** | 级别 3 | 容器内的内部组件 | 详细设计后，用于实现 | | **部署** | 基础设施 | 云资源和网络拓扑 | Cloud First 合规、成本估算 | | **序列** | 交互 | API 流和请求/响应模式 | 集成需求、API 设计 | | **数据流** | 数据 | 数据流动、PII 处理、GDPR 合规 | 英国 GDPR、DPIA 要求 | 直接使用 `/arckit:diagram` 或提供显式类型，如 `context`、`container`、`sequence` 或 `dataflow`。输出捆绑组件库存和沃德利演变标签、内置 GOV.UK 合规脚手架（Notify、Pay、Design System）、Cloud First 网络模式、GDPR 注释以及可追溯到需求和测试的跟踪。对于完整的示例，请浏览 `arckit-test-project-v3-windows11` 和 `arckit-test-project-v14-scottish-courts` 中的图表文件夹。 ## ServiceNow 服务管理设计 ArcKit 将架构工件转化为可运行的 ServiceNow 软件包。`/arckit:servicenow` 命令构建： - CMDB 层次结构、SLA 和变更风险直接来自需求、图表和沃德利地图。 - ITIL 对齐的运行手册，涵盖事件、变更、监控和转换活动。 - 当相关时，英国政府额外内容，如 GDS 服务标准、技术实践准则和 GOV.UK Pay/Notify 依赖项。 有关完整输出，请查看公共演示（例如 `arckit-test-project-v3-windows11`），其中发布了生成的 ServiceNow 设计文件和检查清单。 --- ## 文档 关键参考资料位于 `docs/` 和顶级指南： - 快速游览： [docs/index.html](docs/index.html) 镜像公共登陆页面。 - 生命周期视觉化： [WORKFLOW-DIAGRAMS.md](docs/WORKFLOW-DIAGRAMS.md) 和 [DEPENDENCY-MATRIX.md](docs/DEPENDENCY-MATRIX.md) 涵盖命令流程和关系。 - 核心指南： [docs/guides/principles.md](docs/guides/principles.md)、 [docs/guides/requirements.md](docs/guides/requirements.md)、 [docs/guides/procurement.md](docs/guides/procurement.md)、 [docs/guides/design-review.md](docs/guides/design-review.md)。 - 可追溯性： [docs/guides/traceability.md](docs/guides/traceability.md) 记录端到端覆盖模式。 - **DDaT 角色指南**： [docs/guides/roles/](docs/guides/roles/) — 18 个指南将 ArcKit 命令映射到 [英国政府 DDaT 能力框架](https://ddat-capability-framework.service.gov.uk/) 角色（企业架构师、解决方案架构师、产品经理等）。 --- ## 与其他工具的比较 | 功能 | ArcKit | Sparx EA | Ardoq | LeanIX | Confluence | |---------|--------|----------|-------|--------|------------| | **AI 辅助** | ✅ | ❌ | ❌ | ❌ | ❌ | | **沃德利映射** | ✅ | ❌ | ⚠️ 有限 | ❌ | ❌ | | **版本控制** | ✅ Git | ❌ | ❌ | ❌ | ⚠️ 有限 | | **供应商 RFP** | ✅ | ❌ | ❌ | ❌ | ⚠️ 手动 | | **设计审查门** | ✅ | ⚠️ 手动 | ❌ | ❌ | ⚠️ 手动 | | **可追溯性** | ✅ 自动 | ⚠️ 手动 | ✅ | ⚠️ 有限 | ❌ | | **成本** | 免费 | $$$$ | $$$$ | $$$$ | $ | | **学习曲线** | 低 | 高 | 中等 | 中等 | 低 | --- ## 需求 - **Python 3.11+** - **Git** （可选但推荐） - **AI 编码代理**： [Claude Code](https://www.anthropic.com/claude-code) v2.1.172+（通过插件）， [Gemini CLI](https://github.com/google-gemini/gemini-cli) （通过扩展）， [OpenCode CLI](https://opencode.net/cli) （通过 CLI），或 [OpenAI Codex CLI](https://chatgpt.com/features/codex) （通过 CLI） - **uv** 用于包管理： [安装 uv](https://docs.astral.sh/uv/) --- ## 从源码安装 ```bash # 克隆仓库 git clone https://github.com/tractorjuice/arc-kit.git cd arc-kit # 开发模式安装 pip install -e . # 运行 CLI arckit init my-project ``` --- ## 文档 完整指南位于 `docs/` 和静态站点。 - 快速游览： [docs/index.html](docs/index.html) （镜像公共登陆页面）。 - 核心指南： [docs/guides/principles.md](docs/guides/principles.md)、 [docs/guides/requirements.md](docs/guides/requirements.md)、 [docs/guides/procurement.md](docs/guides/procurement.md)、 [docs/guides/design-review.md](docs/guides/design-review.md)。 - 参考包： [WORKFLOW-DIAGRAMS.md](docs/WORKFLOW-DIAGRAMS.md) 和 [DEPENDENCY-MATRIX.md](docs/DEPENDENCY-MATRIX.md) 涵盖生命周期可视化和命令依赖矩阵。 - 可追溯性： [docs/guides/traceability.md](docs/guides/traceability.md) 记录端到端需求覆盖。 ## 与 Spec Kit 的关系 ArcKit 灵感来自 [Spec Kit](https://github.com/github/spec-kit)，但针对不同的受众： | | Spec Kit | ArcKit | |---|----------|--------| | **受众** | 产品经理、开发者 | 企业架构师、采购 | | **关注点** | 功能开发（0→1 代码生成） | 架构治理 & 供应商管理 | | **工作流程** | 规格 → 计划 → 任务 → 代码 | 需求 → RFP → 设计审查 → 可追溯性 | | **输出** | 工作代码 | 架构文档 & 治理 | --- ## 贡献 我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。 **需要帮助的领域**： - 与企业工具的集成（Jira、Azure DevOps） - 额外的 AI 代理支持 - 基于实际使用的模板改进 - 文档和示例 - ServiceNow 规划 --- ## 支持 - **问题**： [GitHub Issues](https://github.com/tractorjuice/arc-kit/issues) - **发布**： [GitHub Releases](https://github.com/tractorjuice/arc-kit/releases) - **最新版本**： [v5.15.0](https://github.com/tractorjuice/arc-kit/releases/tag/v5.15.0) --- ## 许可 MIT 许可 - 详情请参阅 [LICENSE](LICENSE) 。 > **例外：** `plugins/arckit-uk-gcloud/` 覆盖是 **专有** （非 MIT），请参阅 [`plugins/arckit-uk-gcloud/LICENSE`](plugins/arckit-uk-gcloud/LICENSE) 。 --- ## 致谢 ArcKit 灵感来自 [Spec Kit](https://github.com/github/spec-kit) 中的方法和模式，适用于企业架构工作流程。 --- <p align="center"> <img src="docs/assets/ArcKit_Logo_Horizontal_Dark.svg" alt="ArcKit" height="40"> </p> <p align="center"> <strong>由 ❤️ 为希望采用 AI 辅助治理的企业架构师打造。</strong> </p>