ArcKit converter.py源码解析一套命令如何自动生成6种AI平台格式完整指南【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kitArcKit是一个用 AI 编码助手驱动的企业架构治理工具包而它的多平台分发引擎就是 converter.py只写一份命令源文件运行一次转换脚本就能自动把 125 个左右的企业架构命令扇出到 Codex、Gemini CLI、OpenCode、GitHub Copilot、Mistral Vibe、Kimi Code CLI 等 6 种 AI 助手平台全程零手工复制。为什么需要单一事实源转换器如果 7 个平台各维护一套命令副本改一处就得改七处漂移只是时间问题。ArcKit 的思路是唯一可编辑的源plugins/arckit-claude/commands/下的 Markdown 命令文件外加各地域插件目录里的命令其余全部是生成物Codex 的SKILL.md、Gemini 的 TOML、Copilot 的 prompt 文件等都不许手改——改源文件重跑python scripts/converter.py全部再生官方文档 custom-commands.md 里写得很直白A command is a single Markdown file that ArcKit fans out to six AI-assistant formats automatically.第一层把 14 个插件源合并成一份命令清单v5.0.0 之后ArcKit 的命令分散在 14 个插件目录里阿联酋、法国、荷兰、加拿大、欧盟、奥地利、澳大利亚、英国金融、英国 NHS、TOGAF/ADM、OAA、Agent 架构、核心……。converter 的PLUGIN_SOURCES列表按社区插件在前、核心插件最后的顺序声明这些源见 converter.py 第253-269行合并时逐目录扫描.md命令文件重名时打印 WARNING 并先出现者胜——由于文件名都带地域前缀uae-*、fr-*…实践中不会冲突而核心插件排最后保证了真撞车时核心赢三个插件被刻意排除在转换之外arckit-fde、arckit-repo独立工具插件以及专有许可证的arckit-uk-gcloud——注释里专门说明这是防止许可泄漏不能混进 MIT 协议的公开扩展见 converter.py 第270-276行合并结果按文件名排序保证生成物顺序稳定、无 diff 噪音第二层翻译引擎——路径重写与占位符替换每条命令的 prompt 里写的是 Claude 风格的路径和占位符。rewrite_paths()函数converter.py 第391-426行按目标平台的配置逐项改写源写法转换后举例${CLAUDE_PLUGIN_ROOT}各平台实际安装位置Codex/OpenCode 用.arckitGemini 用~/.gemini/extensions/arckit$ARGUMENTSGemini →{{args}}Copilot →${input:topic:...}Paperclip →{topic}${user_config.KEY}降级为普通环境变量${KEY}非 Claude 平台不支持插件用户配置模板路径有项目级覆盖的平台改为.arckit/templates-custom/先于插件根展开Gemini 还有特殊照顾它的扩展目录在工作区沙箱之外converter 会把 prompt 里Read 某文件的指令正则替换成Run cat ...并在每条命令开头插入一段扩展文件访问须知EXTENSION_FILE_ACCESS_BLOCK见 converter.py 第214-226行——提示模型只能用 shell 命令读模板。第三层一个配置字典驱动 6 种输出converter 最优雅的设计是AGENT_CONFIG字典converter.py 第281-388行每个平台就是一个条目声明输出目录、文件名模式、格式类型和特殊开关。目标平台输出格式输出位置特点Codex CLIMarkdown Skillextensions/arckit-codex/prompts/与skills/arckit-n/SKILL.md一个命令双形态skill 附带agents/openai.yamlOpenCode CLIMarkdownextensions/arckit-opencode/commands/同 Codex 的.arckit路径前缀Gemini CLITOMLextensions/arckit-gemini/commands/arckit/n.toml文件访问须知块 {{args}}参数占位符GitHub CopilotPrompt frontmatterextensions/arckit-copilot/prompts/arckit-n.prompt.md按 prompt 内容自动选配工具集含fetch的研究类命令会加上 fetch 工具Paperclip单一 JSONextensions/arckit-paperclip/src/data/commands.json所有命令、模板内容、handoffs 全部内嵌进一个文件Mistral VibeSkill Markdownextensions/arckit-vibe/skills/附display_name、tags 前缀的 frontmatterKimi Code CLISkill 目录extensions/arckit-kimi/skills/arckit-n/SKILL.md只输出 name/description 字段Claude-only 字段天然被丢弃转换结束后还有一轮配套资产生成Codex 的config.toml生命周期钩子 MCP 服务器自动剔除 Claude-only 的alwaysLoad字段和每个 agent 的.tomlGemini 的子 agent 文件、hooks.json和policies/rules.toml禁止改扩展自身文件、写入密钥前询问Copilot 的.agent.md包装器与copilot-instructions.mdKimi 的插件清单kimi.plugin.jsonMCP 映射 钩子数组。执行顺序也很讲究见 converter.py 主流程先拷贝支撑文件各插件的templates/、data/合并进同一目录脚本/指南/配置只从核心插件取再转换命令最后做平台后处理——因为命令 skill 要生成在参考 skill 就位之后。第四层优雅降级——处理平台不支持的特性不同平台的能力天花板不一样converter 用黑白名单把不兼容的东西干净地剥离掉命令级跳过build.md依赖 Claude Code 独有的并行 Agent 派发没有对应运行时直接不转换CLAUDE_ONLY_COMMANDS见 converter.py 第51行字段级剥离effort、paths、doc-type等 Claude-only frontmatter 字段以及 agent 的maxTurns、disallowedTools等一律剔除后再序列化subagent 过滤带subagent: true的读写子代理只存在于 Claude Code其他目标全部跳过agent 命令内联像research这类命令只是委托给同名 agent的场景converter 直接取 agent 的完整 prompt 作为命令正文并补上## User Request占位段落——因为非 Claude 平台没有 Task/agent 架构hook 依赖替换没有上下文注入 hook 的平台hook 已帮你扫过项目的提示会被替换成自己扫描projects/目录的说明standalone 覆盖commands-standalone/里存着针对无 hook 平台改写的命令版本converter 会按平台的has_sync_guides_hook开关自动选用这套机制的效果是同一份源命令在 6 个平台上都能像原生一样运行而不是带着一堆无效字段硬塞。加一个新 AI 平台要做什么答案写在源码注释里converter.py 第279行adding a new AI target adding a dictionary entry。往AGENT_CONFIG加一个条目输出目录 格式 路径前缀 参数占位符主循环的通用逻辑就会替你处理合并、重写、frontmatter 生成、handoffs 渲染如果格式特殊再补一个后处理函数即可。Vibe 和 Kimi 就是这么加进来的。什么时候该运行 converter.py官方发布流程RELEASING.md要求新增命令、修改 agent prompt、调整模板之后重跑一次python scripts/converter.py需要 Python ≥ 3.11 PyYAML把全部目标文件再生一遍连同源文件一起提交。由于生成过程完全确定性重跑不会有 diff 噪音tests/plugin/ 下还有专门的跨平台一致性测试如test_claude_overlay_namespacing.py、test_kimi_hook_adapter.mjs守着源改了、6 份生成物同步改的约定。参考文件清单转换脚本源码converter.py命令编写规范docs/guides/custom-commands.md发布流程说明docs/RELEASING.md脚本目录说明scripts/README.md跨平台一致性测试tests/plugin/test_claude_overlay_namespacing.py生成产物示例Gemini 扩展extensions/arckit-gemini/生成产物示例Codex 扩展extensions/arckit-codex/【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考