1. 当 System Prompt 从“手册”膨胀成“全书”Agent 开始不听话了System Prompt 在 Agent 系统里到底是什么一句话说清楚它是每次请求前注入模型的那段“岗前培训手册”负责告诉 Agent 你是谁、你有什么工具、你该按什么流程干活、你的红线在哪、之前发生过什么。适合谁看正在用 Cline、Claude Code、CC Switch 这类工具搭 Agent 工作流并且已经被超长提示词折磨过的开发者。我最早写 Agent 配置时习惯把所有规则、所有工具说明、所有编码规范全塞进一个 System Prompt 文件。刚开始很爽一个文件走天下。但文件从 200 行涨到 1600 行之后问题集中爆发Token 成本肉眼可见地涨模型开始“迷失在中间”——明明写在文件里的规则它就是不遵守改一条规则要翻半天改完还容易碰坏别的段落。后来我把思路换了一下System Prompt 不该做“全书”它应该做“目录”。详细指令拆到外部 Skill 文件里按需加载。这就是从“岗前培训手册”到“可插拔技能库”的演进主线。下面结合 TaoToken 的统一 Key/API 通道把 Cline 和 CC Switch 的配置骨架、技能库切换后的验证动作、以及报错排查路径完整走一遍。2. 前置准备用 TaoToken 统一 Key 与 API 通道在动 System Prompt 治理之前先把模型通道固定下来。原因很实际Agent 的 System Prompt 治理是“多配置切换”的场景你会频繁在 Cline、CC Switch、脚本之间来回验证。如果每个工具各配一套 Key 和地址排查问题时你分不清是提示词的问题还是通道的问题。TaoToken 在这里的角色是统一入口一个 Key、一个 API 地址Cline 和 CC Switch 都指向它。这样技能库切换后的验证结果才可复现。操作路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一个 Key复制保存API 基础地址统一用https://taotoken.net/api这个地址不加 UTM 参数直接填进配置文件即可。注意Key 只在创建时完整显示一次先存到本地密码管理器或环境变量里别直接提交进 Git 仓库。拿到 Key 之后先别急着配 Cline。建议先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条最简单的消息确认 Key 和通道是通的。这一步花 30 秒能省掉后面半小时的“到底是配置错还是通道错”的纠结。3. 可复制配置Cline 与 CC Switch 的骨架3.1 Cline 的 settings.json 骨架Cline 的配置核心是把 API 提供方指向 TaoToken同时把 System Prompt 的“目录化”思路落进自定义指令里。下面是一个可直接改用的骨架{ cline.apiProvider: openai, cline.openAiBaseUrl: https://taotoken.net/api, cline.openAiApiKey: sk-你的TaoTokenKey, cline.openAiModelId: claude-sonnet-4-20250514, cline.customInstructions: ## Skills (mandatory)\n在回复之前先扫描可用技能列表。若恰好有一个技能匹配当前任务用 read 工具读取对应 SKILL.md 后遵照执行。\n\navailable_skills\n- code-review: 代码审查规范与检查清单路径 ./skills/code-review/SKILL.md\n- db-migration: 数据库迁移流程与回滚策略路径 ./skills/db-migration/SKILL.md\n- api-design: 接口设计约定与错误码规范路径 ./skills/api-design/SKILL.md\n/available_skills }这里的关键设计是customInstructions里只放“目录”技能名称、一句话描述、文件路径。真正的详细规则放在各自的SKILL.md里。Agent 判断任务匹配某个技能时才会去读那个文件不匹配就不读上下文自然就短了。3.2 CC Switch 的 config.toml 骨架CC Switch 用来在多个模型通道/配置之间快速切换适合你同时维护“日常编码”和“重任务”两套配置的场景。骨架如下[[profiles]] name taotoken-default base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 system_prompt_file ./prompts/system-core.md skills_dir ./skills [[profiles]] name taotoken-heavy base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-opus-4-20250514 system_prompt_file ./prompts/system-core.md skills_dir ./skills注意两个 profile 共用同一个system_prompt_file和skills_dir。这是刻意的System Prompt 的“核心层”身份、安全护栏保持稳定切换 profile 只换模型和参数不换治理结构。这样你验证技能库时变量只有一个——模型而不是提示词也跟着变。3.3 技能库的目录结构配套的目录长这样prompts/ system-core.md # 薄入口身份 安全 技能目录 skills/ code-review/ SKILL.md # 详细审查规则 db-migration/ SKILL.md # 迁移步骤与回滚 api-design/ SKILL.md # 接口约定system-core.md里只保留三类内容身份定义、安全护栏写死、不可被技能覆盖、技能目录。工作流细节、编码规范、工具路由逻辑全部下沉到各SKILL.md。这就是“可插拔”的物理形态——加一个技能就是加一个目录不用动核心文件。4. 验证请求技能库切换后怎么确认真的生效配置写完不代表生效。技能库这种“按需加载”机制最容易出现的问题是Agent 压根没去读 SKILL.md凭自己的通用能力回答了你还以为技能生效了。验证动作分三步。第一步发一个明确命中某个技能的任务。比如你配了code-review技能就贴一段有明显问题的代码然后说“按项目规范审查这段代码”。第二步观察 Agent 是否调用了 read 工具去读./skills/code-review/SKILL.md。在 Cline 的工具调用记录里能直接看到。如果它没读文件就直接回答说明路由指令没生效。第三步检查回答里是否出现了 SKILL.md 中特有的规则。比如你在code-review/SKILL.md里写了一条“所有函数必须标注副作用”那回答里就应该体现这条。如果回答是泛泛的“建议加注释”说明它用的是通用知识不是你的技能库。用 TaoToken 的模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 也能做同样的验证把 system-core.md 的内容作为系统消息贴进去再发任务看模型是否按目录去“请求”读取技能文件。这个页面适合快速试提示词不用每次都启动完整 IDE。5. 本篇常见错排查5.1 技能不触发Agent 直接回答不读 SKILL.md最常见的原因是路由指令写得太软。像“你可以参考技能列表”这种表述模型大概率忽略。要改成强制语气“在回复之前先扫描可用技能列表。若恰好有一个技能匹配必须用 read 工具读取对应 SKILL.md 后遵照执行。”另一个原因是技能描述太模糊。- code-review: 代码相关这种描述模型判断不出该不该用。描述要写到“什么任务该用它”的程度比如“代码审查规范与检查清单”。5.2 报错 401 / 403Key 或地址问题先确认base_url填的是https://taotoken.net/api不要多写路径、不要带尾部斜杠。再确认 Key 没有多余空格——从网页复制时经常带一个尾随空格肉眼看不出来。如果 Cline 和 CC Switch 同时报 401基本就是 Key 本身的问题去 API Keys 页面重新生成一个。5.3 报错 404模型名写错模型 ID 必须和通道支持的名称完全一致。claude-sonnet-4-20250514和claude-sonnet-4是两个不同的字符串写错就是 404。排查方法先用模型对话页面选一次模型看它实际发出的模型名是什么再抄进配置文件。5.4 技能生效了但回答质量反而下降这通常是 SKILL.md 写太长了把“按需加载”又写成了“全书”。单个 SKILL.md 建议控制在 200 行以内只放这个技能真正需要的规则。如果某个技能超过 300 行考虑再拆一层子技能。5.5 切换 profile 后行为不一致检查两个 profile 是否真的共用同一个system_prompt_file。如果各写各的那切换模型的同时也切换了提示词你就无法判断行为差异来自模型还是来自提示词。治理的前提是控制变量。6. 把治理落到日常从手册到技能库的持续动作System Prompt 的治理不是一次性重构而是持续动作。我的做法是核心文件system-core.md冻结只允许改安全护栏和技能目录两处所有业务规则一律进 SKILL.md。每次遇到 Agent 犯同类错误不是去核心文件里加一条而是问“这属于哪个技能”然后改对应的 SKILL.md。长期跑编码和 Agent 任务的话可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 配合上面的技能库结构把“日常编码”和“重任务”分成两个 profile核心提示词共用技能目录共用只换模型。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有疑问时对着查一遍比猜快。最后留一个我踩过的坑技能目录里的路径一定用相对路径并且确认 Agent 的工作目录就是项目根目录。用绝对路径在本地没事换台机器或换个人跑就全挂。相对路径 固定工作目录是技能库能“可插拔”的前提。 System Prompt 在 Agent 系统中的职责与治理：从“岗前培训手册”到“可插拔技能库”的 TaoToken 配置实践
1. 当 System Prompt 从“手册”膨胀成“全书”Agent 开始不听话了System Prompt 在 Agent 系统里到底是什么一句话说清楚它是每次请求前注入模型的那段“岗前培训手册”负责告诉 Agent 你是谁、你有什么工具、你该按什么流程干活、你的红线在哪、之前发生过什么。适合谁看正在用 Cline、Claude Code、CC Switch 这类工具搭 Agent 工作流并且已经被超长提示词折磨过的开发者。我最早写 Agent 配置时习惯把所有规则、所有工具说明、所有编码规范全塞进一个 System Prompt 文件。刚开始很爽一个文件走天下。但文件从 200 行涨到 1600 行之后问题集中爆发Token 成本肉眼可见地涨模型开始“迷失在中间”——明明写在文件里的规则它就是不遵守改一条规则要翻半天改完还容易碰坏别的段落。后来我把思路换了一下System Prompt 不该做“全书”它应该做“目录”。详细指令拆到外部 Skill 文件里按需加载。这就是从“岗前培训手册”到“可插拔技能库”的演进主线。下面结合 TaoToken 的统一 Key/API 通道把 Cline 和 CC Switch 的配置骨架、技能库切换后的验证动作、以及报错排查路径完整走一遍。2. 前置准备用 TaoToken 统一 Key 与 API 通道在动 System Prompt 治理之前先把模型通道固定下来。原因很实际Agent 的 System Prompt 治理是“多配置切换”的场景你会频繁在 Cline、CC Switch、脚本之间来回验证。如果每个工具各配一套 Key 和地址排查问题时你分不清是提示词的问题还是通道的问题。TaoToken 在这里的角色是统一入口一个 Key、一个 API 地址Cline 和 CC Switch 都指向它。这样技能库切换后的验证结果才可复现。操作路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一个 Key复制保存API 基础地址统一用https://taotoken.net/api这个地址不加 UTM 参数直接填进配置文件即可。注意Key 只在创建时完整显示一次先存到本地密码管理器或环境变量里别直接提交进 Git 仓库。拿到 Key 之后先别急着配 Cline。建议先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条最简单的消息确认 Key 和通道是通的。这一步花 30 秒能省掉后面半小时的“到底是配置错还是通道错”的纠结。3. 可复制配置Cline 与 CC Switch 的骨架3.1 Cline 的 settings.json 骨架Cline 的配置核心是把 API 提供方指向 TaoToken同时把 System Prompt 的“目录化”思路落进自定义指令里。下面是一个可直接改用的骨架{ cline.apiProvider: openai, cline.openAiBaseUrl: https://taotoken.net/api, cline.openAiApiKey: sk-你的TaoTokenKey, cline.openAiModelId: claude-sonnet-4-20250514, cline.customInstructions: ## Skills (mandatory)\n在回复之前先扫描可用技能列表。若恰好有一个技能匹配当前任务用 read 工具读取对应 SKILL.md 后遵照执行。\n\navailable_skills\n- code-review: 代码审查规范与检查清单路径 ./skills/code-review/SKILL.md\n- db-migration: 数据库迁移流程与回滚策略路径 ./skills/db-migration/SKILL.md\n- api-design: 接口设计约定与错误码规范路径 ./skills/api-design/SKILL.md\n/available_skills }这里的关键设计是customInstructions里只放“目录”技能名称、一句话描述、文件路径。真正的详细规则放在各自的SKILL.md里。Agent 判断任务匹配某个技能时才会去读那个文件不匹配就不读上下文自然就短了。3.2 CC Switch 的 config.toml 骨架CC Switch 用来在多个模型通道/配置之间快速切换适合你同时维护“日常编码”和“重任务”两套配置的场景。骨架如下[[profiles]] name taotoken-default base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 system_prompt_file ./prompts/system-core.md skills_dir ./skills [[profiles]] name taotoken-heavy base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-opus-4-20250514 system_prompt_file ./prompts/system-core.md skills_dir ./skills注意两个 profile 共用同一个system_prompt_file和skills_dir。这是刻意的System Prompt 的“核心层”身份、安全护栏保持稳定切换 profile 只换模型和参数不换治理结构。这样你验证技能库时变量只有一个——模型而不是提示词也跟着变。3.3 技能库的目录结构配套的目录长这样prompts/ system-core.md # 薄入口身份 安全 技能目录 skills/ code-review/ SKILL.md # 详细审查规则 db-migration/ SKILL.md # 迁移步骤与回滚 api-design/ SKILL.md # 接口约定system-core.md里只保留三类内容身份定义、安全护栏写死、不可被技能覆盖、技能目录。工作流细节、编码规范、工具路由逻辑全部下沉到各SKILL.md。这就是“可插拔”的物理形态——加一个技能就是加一个目录不用动核心文件。4. 验证请求技能库切换后怎么确认真的生效配置写完不代表生效。技能库这种“按需加载”机制最容易出现的问题是Agent 压根没去读 SKILL.md凭自己的通用能力回答了你还以为技能生效了。验证动作分三步。第一步发一个明确命中某个技能的任务。比如你配了code-review技能就贴一段有明显问题的代码然后说“按项目规范审查这段代码”。第二步观察 Agent 是否调用了 read 工具去读./skills/code-review/SKILL.md。在 Cline 的工具调用记录里能直接看到。如果它没读文件就直接回答说明路由指令没生效。第三步检查回答里是否出现了 SKILL.md 中特有的规则。比如你在code-review/SKILL.md里写了一条“所有函数必须标注副作用”那回答里就应该体现这条。如果回答是泛泛的“建议加注释”说明它用的是通用知识不是你的技能库。用 TaoToken 的模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 也能做同样的验证把 system-core.md 的内容作为系统消息贴进去再发任务看模型是否按目录去“请求”读取技能文件。这个页面适合快速试提示词不用每次都启动完整 IDE。5. 本篇常见错排查5.1 技能不触发Agent 直接回答不读 SKILL.md最常见的原因是路由指令写得太软。像“你可以参考技能列表”这种表述模型大概率忽略。要改成强制语气“在回复之前先扫描可用技能列表。若恰好有一个技能匹配必须用 read 工具读取对应 SKILL.md 后遵照执行。”另一个原因是技能描述太模糊。- code-review: 代码相关这种描述模型判断不出该不该用。描述要写到“什么任务该用它”的程度比如“代码审查规范与检查清单”。5.2 报错 401 / 403Key 或地址问题先确认base_url填的是https://taotoken.net/api不要多写路径、不要带尾部斜杠。再确认 Key 没有多余空格——从网页复制时经常带一个尾随空格肉眼看不出来。如果 Cline 和 CC Switch 同时报 401基本就是 Key 本身的问题去 API Keys 页面重新生成一个。5.3 报错 404模型名写错模型 ID 必须和通道支持的名称完全一致。claude-sonnet-4-20250514和claude-sonnet-4是两个不同的字符串写错就是 404。排查方法先用模型对话页面选一次模型看它实际发出的模型名是什么再抄进配置文件。5.4 技能生效了但回答质量反而下降这通常是 SKILL.md 写太长了把“按需加载”又写成了“全书”。单个 SKILL.md 建议控制在 200 行以内只放这个技能真正需要的规则。如果某个技能超过 300 行考虑再拆一层子技能。5.5 切换 profile 后行为不一致检查两个 profile 是否真的共用同一个system_prompt_file。如果各写各的那切换模型的同时也切换了提示词你就无法判断行为差异来自模型还是来自提示词。治理的前提是控制变量。6. 把治理落到日常从手册到技能库的持续动作System Prompt 的治理不是一次性重构而是持续动作。我的做法是核心文件system-core.md冻结只允许改安全护栏和技能目录两处所有业务规则一律进 SKILL.md。每次遇到 Agent 犯同类错误不是去核心文件里加一条而是问“这属于哪个技能”然后改对应的 SKILL.md。长期跑编码和 Agent 任务的话可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 配合上面的技能库结构把“日常编码”和“重任务”分成两个 profile核心提示词共用技能目录共用只换模型。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有疑问时对着查一遍比猜快。最后留一个我踩过的坑技能目录里的路径一定用相对路径并且确认 Agent 的工作目录就是项目根目录。用绝对路径在本地没事换台机器或换个人跑就全挂。相对路径 固定工作目录是技能库能“可插拔”的前提。