如何搭建多 AI 工具的提示词架构(1)

Fri, 09 Oct 2026 08:00:00 +0800

日期: 2026-10-09

一、现场:一台机器上并存的四个 AI 王国

实测本机同时驻留四家 AI 编码工具,各自拥有独立的配置目录(dot-dir),互不统属:

dot-dir	工具	指令文件约定(勘误后修正)	目录里还有
~/.claude	Claude Code	~/.claude/CLAUDE.md	会话、缓存、settings
~/.codex	Codex CLI	~/.codex/AGENTS.md	auth、config.toml、日志
~/.dsh	DeepSeek harness	~/.dsh/AGENTS.md	profiles、sessions
~/.zcode	ZCode	~/.zcode/AGENTS.md(用户级,最先注入)+ 工作区向上扫描	会话流水、db、插件

两个实测观察:

观察一:文件名趋同,作用域割裂。 .codex 和 .dsh 里都有叫 AGENTS.md 的文件,但互不相通——“AGENTS.md"成了事实标准的文件名,阅读范围却是各家私有的。勘误补充:ZCode 官方指南证实它支持私有域,但GLM 5.3自己对自己的harness产品一开始理解错误. ~/.agents/skills|commands|mcp.json 兼容层,跨工具共享体系比初稿断言的"名存实亡"更完整,“割裂"仅对全局指令文件这一层成立。

观察二:dot-dir 是工具的"全部家当”。 以 .zcode 为例:会话流水(rollout/*.jsonl,长会话一天可涨数 MB)、结构化数据库、执行现场、图片缓存、插件、配置,实测 988 个文件。每个 dot-dir = 该工具的身份、记忆与状态的总和。

二、架构整理:共识层与角色层分离

四工具并存时,提示词内容天然分两类:

共识层:所有工具都该知道的事实——机器环境、网络规则、服务器、工作习惯、分工地图;
角色层:每家"你是谁、负责什么”——有意不同,不应镜像。

原状态是反面教材:共识与角色混在一份文件里,四家各持一份陈旧副本,彼此漂移。

对"跨工具标准"的准确表述:每家 harness 都有自己的配置约定,AGENTS.md 只是部分厂商采纳的兼容层。真实生态是:文件名事实趋同,阅读范围各家私有,共享靠人为桥接。

三、勘误与正解:ZCode 有用户级指令槽

Zcode初稿此处曾断言:“ZCode 没有自己的提示词目录,全局指令写死在 ~/AGENTS.md(home 根,所有会话共享的公共位置),其配置文件里没有任何指令路径的可配置项”,并"建议厂商提供 ~/.zcode/AGENTS.md"。发布后复读官方配置指南(zcode-guide 插件),证实该结论错误:

AGENTS.md on 鬼属文

如何搭建多 AI 工具的提示词架构(1)

一、现场:一台机器上并存的四个 AI 王国

二、架构整理:共识层与角色层分离

三、勘误与正解:ZCode 有用户级指令槽