企业官网建设流程全解析

ArcKit Token预算管理：75个命令如何压进约1万token常驻上下文

【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kit

🤖 ArcKit 是一个企业架构治理工具包（Enterprise Architecture Governance Harness），通过 AI 编码助手完成战略、架构、交付与合规保障。它的核心插件内置了 75 个架构命令，却只占用约 10,042 个 token 的常驻上下文——这篇文章拆解这套 Token 预算管理方案是如何做到的。

一、问题：每个会话都要为"没用过的命令"付费

用 AI 编码助手写代码时，很多人没意识到：插件加载的每条命令描述，都会常驻在你的系统上下文里。你每开一个新会话，这些 token 就被默默扣掉一次。

ArcKit v5.0.0 之前把所有功能焊死在一个插件里，实测结果是：

也就是说，一个英国政府项目的架构师，每开一个会话都要为 UAE 联邦合规、法国 ANSSI 指引等自己永远不会用到的命令付出约三分之一的 token 成本 💸

📌 关键结论：这不是零头误差，而是常驻预算的 1/3，而且每新增一个辖区就会无上限地继续膨胀。

二、拆解：75 个命令的 token 都花在哪了

ArcKit 用claude plugin details给整个插件"算了笔账"。常驻成本里真正的大头出乎多数插件作者的意料：

2.1 命令本身很便宜，描述才贵

• 核心命令：每条命令技能常驻仅 20–70 tokens（平均约 35），71 条合计约 2,600 tokens。因为描述只写一句话，完整提示词只在调用时加载（on-invoke）。
• 叠加层命令：每条常驻 70–120 tokens，是核心的 3 倍——因为描述必须带上法规上下文（实施哪部法规、对标哪个框架、产出什么工件）。描述对命令选择是好的，但也不免费。

2.2 Agent 描述才是核心预算的大头

ArcKit 的研究类 agent（如 plugins/arckit-claude/agents/ 下的arckit-gcp-research、arckit-datascout）携带长描述来教会模型"何时该调度我"：

2.3 免费选手：Hooks 与 MCP

plugins/arckit-claude/hooks/ 里的 9 类钩子和 6 个 MCP 服务器不计入常驻成本——它们在运行 harness 中解析，不进模型上下文。这是把"常驻 vs 运行时"成本分清楚的第一课 ✅

2.4 用paths:通配符给技能"限流"

5 个工具技能（mermaid-syntax、wardley-mapping等）通过paths:glob 只在相关文件存在的项目中加载，把它们的常驻成本锁死在约 730 tokens。

💡 一句话总结：描述决定常驻成本，提示词决定调用成本，hooks 免费。

三、解法：把 15,291 压回 10,042 的三步操作

3.1 先测量，再动手

拆分前先用claude plugin details分别测整体和每个拟拆单元。ArcKit 的拆分之所以果断，就是因为数据果断——1/3 的常驻预算来自可选内容。如果你的数字很小，诚实的做法是按"相关性"而非"省 token"来拆。

3.2 找准接缝：核心 vs 可选

• 核心保留共享基建：hooks、MCP 定义、文档类型注册表（校验钩子必须有一份权威工件代码清单）。
• 可选内容按"服务单一受众"切出：每个辖区/行业只带走自己的命令、模板和指南。

3.3 拆成独立插件，按需安装

v5.0.0 后，ArcKit 拆成 7 个市场插件，每个叠加层（如 plugins/arckit-uae/）都是完整插件结构：独立 manifest、VERSION、CHANGELOG.md。关键点：

• 声明依赖：manifest 里"dependencies": {"arckit": "5.0.0"}，安装叠加层时自动先装核心，不会把用户丢在半路。
• 成本可见：README.md 的 "What it costs (plugin footprint)" 一节公开了常驻/调用两类数字，不藏在捆绑包里。
• 存量用户迁移：SessionStart 钩子读取项目清单，识别项目用过的辖区，打印精确的安装命令，一次性提示完成迁移。

效果：只用英国基线的用户常驻成本从 ~15,291 降到 ~10,042，直降约 34%；多辖区用户按需装叠加层，为用到的部分精确付费。更妙的是核心基线从此有界——第 8 个叠加层上线也不会给老用户加价。事实证明这一点：行业向叠加层arckit-uk-nhs（临床安全）已按同一模式顺利接入，零改动核心。

四、给插件维护者的清单 📋

1. 先跑claude plugin details，读 always-on 数字，再决定拆不拆。
2. 描述瘦身：核心命令用一句话，法规细节留给调用时加载。
3. agent 描述控制长度：触发示例要，但别贪多——它们是大头。
4. 能用 hooks / 运行时解析的就不进上下文。
5. 给可选技能加paths:作用域。
6. 拆分后声明版本依赖 + 给迁移提示，别抛弃存量用户。

完整的数据账本和拆分步骤可查阅官方文章 2026-05-20-plugin-split-token-budget.md，命令实现位于 plugins/arckit-claude/commands/。

结语：Token 预算管理不是玄学，而是一笔可以逐项对账的账单。ArcKit 用一次plugin details测量，把 75 个命令的常驻成本从约 1.5 万 token 压回约 1 万，并把未来增长关进了"按需安装"的笼子里——这大概就是 2026 年写好 AI 插件的第一课：先数 token，再谈功能 🚀

【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kit