Prompt、Rule、Skill 总被混用CodeBuddy 模型通道改到 TaoToken 再验 SKILL.md 触发CodeBuddy 的 SKILL.md 写了却没有按条件触发多半不是 Skill 语法本身而是模型通道没接稳。把 CodeBuddy 模型通道改到 TaoToken官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content后再用.codebuddy/skills/里的allowed-tools做一次触发验证Prompt、Rule、Skill 的分层才会清楚。很多人在这三个词上争论其实争的是不同工具的命名边界但落到 CodeBuddy 里问题非常具体User Rules、Project Rules 放在 Settings 与.codebuddy/目录Skill 放在.codebuddy/skills/并由SKILL.md描述触发条件模型请求则必须经过一个可用的通道。通道没配好Skill 写得再规范也可能表现为“不触发”“工具没调用”“请求超时”。这篇不讨论抽象定义直接从 CodeBuddy 的模型设置切入把 Base URL 指向 TaoToken 兼容入口再用一个带allowed-tools的SKILL.md验证是否按条件加载最后回看 Prompt、Rule、Skill 到底各自该放什么。CodeBuddy 里 Prompt、Rule、Skill 混用为什么 SKILL.md 不触发CodeBuddy 的 Rule 和 Skill 是两层不同的机制。Rule 负责持久约束分为 User Rules 和 Project RulesUser Rules 更偏个人偏好跨项目生效Project Rules 放在项目内跟随仓库走适合团队规范、框架约定、禁用模式、版本要求。Skill 则放在.codebuddy/skills/目录下每个 Skill 通常是一个子目录里面用SKILL.md描述名称、触发条件、执行步骤、输出格式以及可选的allowed-tools、context: fork、user-invocable: false。这三者混用时最常见的错误是把一次性 Prompt 写进 Rule把团队规范写进 Skill又把 Skill 当成“更长的 Prompt”。Prompt 解决的是本次请求说什么。它随对话产生也随对话结束而失效不负责跨会话沉淀。Rule 解决的是这类项目始终怎么做。它被注入到上下文里AI 每次处理请求前都应当“记得”。Skill 解决的是这类任务如何稳定触发并执行通常还涉及工具调用、外部依赖、结构化流程。allowed-tools就是 Skill 和普通文本约束的分水岭声明了工具权限AI 在触发后才可能读取文件、搜索代码、执行命令没有工具调用需求的内容更适合放 Rule或者用user-invocable: false作为背景知识加载。问题在于CodeBuddy 要真正按 Skill 消耗模型前提是模型通道可用。Base URL 填错、Key 失效、模型名不匹配、请求被写到错误端点都会让 CodeBuddy 的模型请求不稳定。此时表现可能不是明显的报错而是回复变慢、触发条件识别不准、工具调用丢失甚至SKILL.md看起来完全没生效。所以排查顺序应该是先确认模型通道再确认 Skill 文件位置和 frontmatter最后才调整 Prompt 措辞。TaoToken 前置Key、Base URL 和 CodeBuddy 的边界TaoToken 在这里的角色很明确提供 API Key 和兼容 Base URL让 CodeBuddy 的模型请求走 TaoToken 通道。它不替 CodeBuddy 执行 Skill也不替代 CodeBuddy 本身。Skill 的触发、工具权限、上下文隔离仍然由 CodeBuddy 读取.codebuddy/skills/后决定。因此配置动作只有两步先拿到 Key再把 CodeBuddy 的模型地址改到 TaoToken。第一步打开官网注册并创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content进入 API Keys 页面创建 Key复制后先放在安全位置。本文统一用YOUR_API_KEY占位实际使用时替换成自己的 Key。不要把 Key 提交到仓库也不要写进公开的SKILL.md。第二步记住 Base URLhttps://taotoken.net/api这个地址不带/v1也不加任何 UTM 参数。CodeBuddy 的模型设置里如果要求填 Base URL就填这一串。若你的 CodeBuddy 版本把协议拆成 Provider、Endpoint、API Host 等多个字段以“最终请求根地址为https://taotoken.net/api”为准。第三步确认边界。TaoToken 只负责模型请求通道CodeBuddy 负责读取 Settings、User Rules、Project Rules 和.codebuddy/skills/。所以“SKILL.md 不触发”不能只怪通道也不能只怪 Skill 写法。正确做法是先用最小请求验证通道再放一个带allowed-tools的 Skill 验证触发链路。需要创建 Key 或核对接入字段时可以直接看 API Keys 和接入文档API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc可复制配置CodeBuddy Settings 与 SKILL.md 示例先处理 CodeBuddy 的模型设置。不同版本的 Settings 面板字段名可能不同但核心就三项Base URL、API Key、Model。按下面等价关系填写Provider: 选择 CodeBuddy 支持的兼容协议 Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model: 按 CodeBuddy 当前可选模型列表填写例如 claude-sonnet-4-20250514如果 CodeBuddy 允许用 JSON 覆盖设置可以写成类似下面的结构。注意键名只是示意实际以当前 CodeBuddy 版本读取的 Settings 为准{ model.provider: taotoken, model.baseUrl: https://taotoken.net/api, model.apiKey: YOUR_API_KEY, model.id: claude-sonnet-4-20250514 }配置完成后不要急着写复杂 Skill。先发一条最小请求例如“只回复 OK”确认 CodeBuddy 能通过 TaoToken 拿到响应。如果这一步失败优先检查 Key、Base URL 和模型名不要继续调SKILL.md。通道通了以后再放 Skill。目录结构如下项目根目录/ .codebuddy/ skills/ crash-log-scan/ SKILL.mdSKILL.md示例--- name: crash-log-scan description: 当用户提到崩溃日志、Crash 分析、堆栈聚合时触发 allowed-tools: - read_file - grep_search - run_terminal_cmd context: fork user-invocable: true --- # Crash 日志扫描 ## 触发条件 - 用户提到“Crash 分析”“崩溃日志”“堆栈聚合” - 当前项目存在 crash/ 或 logs/ 目录 ## 执行步骤 1. 读取 crash/ 下最近 24 小时日志 2. 按 exception 类型聚合 3. 输出 Top 10、首次出现版本与建议 ## 输出格式 | 异常类型 | 次数 | 首次版本 | 建议 | | --- | --- | --- | --- |这里的allowed-tools是验证重点。工具名要按 CodeBuddy 当前支持的白名单填写不要照搬其他工具的命名。context: fork表示 Skill 在隔离子上下文中执行不携带主对话历史适合代码扫描、日志分析这类需要独立上下文的任务。user-invocable: false表示 Skill 不出现在用户的/菜单里只作为 AI 内部背景知识加载适合放项目规范类内容。如果你要做的是“必须由用户手动触发”的 Skill就设成true或保持默认可见。验证请求用一个带 allowed-tools 的 SKILL.md 看是否按条件加载验证分三层不要跳步。第一层验证模型通道。在 CodeBuddy 里发送一个不依赖 Skill 的请求例如“只回复 OK”。如果返回正常说明 Base URL、Key、模型名基本可用。若返回 401查 Key若返回 404查 Base URL 是否多写/v1若超时查网络或代理配置。模型通道的连通性也可以用模型对话页做最小验证https://taotoken.net/console/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat第二层验证 Skill 是否被识别。把上面的crash-log-scan放进.codebuddy/skills/crash-log-scan/SKILL.md重启 CodeBuddy 或重新加载工作区。然后在对话里输入明确触发词“帮我做一次 Crash 分析按 SKILL.md 的格式输出。”观察 CodeBuddy 是否加载了该 Skill。有些版本会在执行记录里显示 Skill 名称有些版本会显示工具调用。如果没有反应先看description是否包含触发词再看目录层级是否多了一层或少了一层最后确认文件名是不是严格的SKILL.md。第三层验证allowed-tools是否生效。输入同样触发词后看 AI 是否尝试读取crash/或logs/目录是否调用搜索或终端工具。如果 Skill 被识别但没有工具调用常见原因是allowed-tools里的工具名不在 CodeBuddy 白名单或者 YAML 缩进错误导致数组没有被解析。成功结果应当是模型请求经 TaoToken 返回Skill 按条件加载工具调用发生输出结构接近SKILL.md中定义的表格或步骤。还要理解两个特殊字段的验证表现。context: fork执行时Skill 不携带主对话历史所以你在主对话里看不到完整的中间推理这是正常隔离不是失败。user-invocable: false的 Skill 不会出现在/菜单只能靠description被 AI 自动加载如果你在菜单里找不到它不代表文件没生效。验证时可以直接问“当前加载了哪些 Skill”或者查看 CodeBuddy 的执行日志。本篇常见错排查Base URL、/v1、SKILL.md 路径、allowed-tools、context: fork第一类错在模型通道。Base URL 写成https://taotoken.net/api/v1或带上一串 UTM 参数都会导致请求路径不符合预期。正确写法是https://taotoken.net/api不带/v1不加 UTM。API Key 复制时带了空格、换行或少了字符会直接 401。模型名不在 CodeBuddy 可选列表里会表现为请求失败或模型不可用。第二类错在 Skill 路径。SKILL.md必须放在.codebuddy/skills/skill-name/SKILL.md。有的读者放在.codebuddy/skills/SKILL.md或者放进.codebuddy/rules/CodeBuddy 不会按 Skill 加载。文件名大小写也要一致skill.md与SKILL.md在部分系统上不等价。第三类错在 frontmatter。description写得太泛例如“处理代码问题”AI 无法判断何时触发。触发条件要具体到用户可能说出的词崩溃日志、TAPD Bug、接口扫描、发布检查。allowed-tools如果写成字符串而不是数组或者缩进不对可能被解析成空值。工具名要按 CodeBuddy 当前白名单填写不要直接写其他工具里的工具名。第四类错在语义混用。把一次性指令写进 Rule导致 Rule 越来越长把团队规范写进 Skill导致每次都要触发才有用把 Skill 写成 Prompt 合集没有触发条件、没有工具调用、没有执行步骤。判断标准很简单只影响本次对话的放 Prompt跨会话、跨项目或项目级始终生效的放 Rule需要按条件触发并调用工具的放 Skill。user-invocable: false更适合纯规范类内容但它仍然在 Skill 机制里和 Project Rules 的加载方式不同。第五类错在环境。请求超时、证书错误、代理拦截都会让 Skill 看起来不触发。先回到最小请求验证通道再检查 CodeBuddy 日志里的请求地址是否为https://taotoken.net/api。如果日志里仍然是旧地址说明 Settings 没保存或工作区覆盖了配置。此时去 API Keys 核对 Key再看接入文档确认字段https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keyshttps://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc语义一致 CTA把 CodeBuddy 模型通道固定到 TaoToken再谈 Skill 分层如果你现在卡在 CodeBuddy 的 Settings 里不知道 Base URL 填什么或者SKILL.md写了不触发处理顺序不要反先去官网注册并创建 Key再把 CodeBuddy 模型设置里的 Base URL 改成https://taotoken.net/api然后用一个带allowed-tools的SKILL.md验证触发。TaoToken 在这里提供的是 Key 和兼容 Base URL不替 CodeBuddy 执行 Skill也不改变 CodeBuddy 对 Rule、Skill 的加载逻辑。接入和排障入口官网注册https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc模型对话验证https://taotoken.net/console/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat长期编码与 Agenthttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan最后再回到 Prompt、Rule、Skill 的分层Prompt 是这次说什么Rule 是始终怎么做Skill 是这类任务如何按条件触发并调用工具。CodeBuddy 已经把 Rule 和 Skill 做成双层结构Settings与.codebuddy/skills/各司其职。模型通道接到 TaoToken 后SKILL.md的触发验证才有意义通道不稳时任何关于 Skill 的讨论都会被误判。先把https://taotoken.net/api填对再用allowed-tools跑通一次触发这三个词就不会再混着用了。