企业官网建设流程全解析

1. Qoder Agent 三大扩展能力到底解决什么问题

Qoder Agent 是 Qoder IDE 里的智能体体系，能读项目文件、跑终端命令、调网页搜索，适合在 Vibe Coding 场景下把「说需求 → 出代码 → 验证」这条链路压缩到一次对话里。但默认状态下它有三个高频痛点：每次审查代码都要重新打一大段提示词；问一个 Java 语法问题它却先扫全项目再搜网页，几十秒过去 Token 也烧了；前后端两个任务只能串行做，上下文越滚越长。

这三个痛点分别对应 Commands、Skills、Subagents 三个自定义扩展。Commands 把常用提示词封装成/命令名一键调用；Skills 把领域工作流做成知识模块，让 Agent 自动识别加载；Subagents 把大任务拆成独立上下文的子代理并行跑。复杂度是递进的：Commands 五分钟上手，Skills 是团队知识资产，Subagents 是并行执行力。

我这次把它们和 TaoToken 统一 Key 接在一起，是因为 Qoder Agent 的模型通道可以指向自定义 Base URL，把https://taotoken.net/api填进去后，Commands、Skills、Subagents 三条链路共用同一个 Key，不用每个扩展单独配一遍。下面按「先接通道 → 再配 Commands → 再写 Skills → 最后编排 Subagents → 排错」的顺序走，每一步都给可复制片段。

先明确三者定位，避免配错目录：

注意：Commands 和 Skills 是两套独立机制，目录不要混。Commands 是纯提示词文本，Skills 带 frontmatter 元数据，Subagents 是完整子任务定义。

2. TaoToken 前置：统一 Key 与 Base URL 接入 Qoder Agent

Qoder Agent 支持自定义模型通道，核心就三件套：Base URL、API Key、Model ID。把 Base URL 指向https://taotoken.net/api，Key 从控制台生成，Model ID 按你要用的模型填。这样 Commands 里屏蔽工具后的纯 LLM 直答、Skills 的知识注入、Subagents 的并行调用，全部走同一条通道，计费和限流也统一在一处看。

第一步，拿 Key。打开控制台https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite，登录后在 API Keys 页面新建一个 Key，复制出来先存好。这个 Key 后面在 Qoder 的模型配置里填一次即可。

第二步，确认通道地址。API 根地址是https://taotoken.net/api，注意不要带 UTM 参数，配置里写干净地址。模型对话调试入口在https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite，可以先用它验证 Key 是否可用，再去配 Qoder。

第三步，在 Qoder 里填三件套。Qoder 的模型配置一般放在设置里的 Provider / Custom Model 区域，字段对应关系如下：

如果你用的是 Claude Code 风格的配置文件，可以写成 JSON 形式，路径按 Qoder 实际读取位置放：

{ "provider": "custom", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "model": "claude-sonnet-4-5", "timeout": 60000 }

注意：Key 不要提交到 Git。项目级配置建议放.qoder/下并加进.gitignore，用户级配置放~/.qoder/。

第四步，验证通道。配完后在 Qoder 对话框发一句最简单的「你好，回复 ok」，如果模型正常回，说明 Base URL + Key + Model ID 三件套通了。这一步不通，后面 Commands 和 Skills 全是白配，所以务必先过。

如果你更习惯用 Coding Plan 做长期编码任务，可以在https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite看套餐说明，把 Key 复用在同一通道上。接入文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，字段有疑问时对照查。

3. Commands 可复制配置：工具屏蔽与一键调用

Commands 的价值不只是少打几个字，而是精确控制 Agent 的工具调用行为。Agent 执行命令时会判断是否激活search_file、search_web、memory三个工具。你在命令首行写屏蔽指令，它就会跳过文件扫描和网页搜索，直接调 LLM 输出，速度和 Token 都省下来。

先建目录。用户级命令放~/.qoder/r/c/commands/，项目级放<项目根>/​.qoder/r/c/commands/。用户级对所有项目生效，项目级只对当前项目生效，团队共享用项目级。

创建一个知识查询类命令/j/java，文件路径~/.qoder/r/c/commands/java.md，内容如下：

Don't search project's files! Don't search web! Don't search memory! 请根据你了解的 Java(8-25) 相关知识回答用户问题。 Programming language: Java

再创建一个代码审查类命令/c/code-inspect，路径<项目根>/​.qoder/r/c/commands/code-inspect.md：

## 概述 用于评估源代码的系统化框架，验证技术卓越性、稳健性和安全合规性。 ## 评估领域 ### 技术实现 - [ ] 需求准确实现 - [ ] 算法效率验证 - [ ] 资源管理优化 ### 风险管理 - [ ] 遵循安全最佳实践 - [ ] 数据验证全面 - [ ] 身份验证方法安全

工具屏蔽的写法对照：

对比实验很直观：直接问「Java 有哪些新特性」，Agent 会扫项目文件、搜网页，几十秒才回；用/j/java后跳过所有工具调用，直接从 LLM 知识输出，秒回且准。我实测下来，纯知识类问题用屏蔽命令，响应时间能压到原来的三分之一左右。

命名建议用名词，像/java、/translator、/sql，调用体验接近「向某个角色提问」。一个命令只做一件事，别把审查和生成塞进同一个文件。声明语言和环境能让输出更准，比如在命令里写Programming language: Bash或Target database: PostgreSQL。

如果你用 Qoder v2.0，也可以在对话框输入/，点底部「添加指令」走可视化入口，效果和手写文件一致。Commands 配好后，Skills 才有意义——因为 Skills 的自动触发依赖模型判断，而 Commands 是你主动给 Agent 划边界。

4. Skills 定义示例与 Subagents 编排步骤

Skills 是带 frontmatter 的知识模块，放在.qoder/r/s/skills/{name}/SKILL.md。它和 Commands 的区别是：Commands 你主动调，Skills 模型根据description自动识别加载。写一个代码审查 Skill，路径~/.qoder/r/s/skills/code-review/SKILL.md：

--- name: code-review description: 代码审查专家，检查代码质量和安全性 tools: Read, Grep, Glob, Bash --- 你是一位资深代码审查员，负责确保代码质量。 ## 审查清单 1. 代码可读性 2. 命名规范 3. 错误处理 4. 安全性检查 5. 测试覆盖

frontmatter 字段里name和description必填，tools可选，用逗号分隔。支持的工具包括Bash、Edit、Write、Glob、Grep、Read、WebFetch、WebSearch。description写得越准，模型自动识别越靠谱。SKILL.md 控制在 100 行以内，详细参考拆到子目录，一个 Skill 只解决一类问题。

触发方式有三种：自然语言描述任务让模型自动识别；输入/技能名显式调用；在一条指令里串联多个，比如「先用 design subagent 完成系统设计，再用 code-review subagent 完成 review」。

Subagents 放在.qoder/r/a/agents/{name}.md，是独立上下文的子代理。编排全栈开发时，前端子代理和后端子代理并行跑，互不污染上下文。创建可以用/c/create-agent交互式引导，也可以手写文件。一个后端子代理示例，路径<项目根>/​.qoder/r/a/agents/backend-api.md：

--- name: backend-api description: 后端 API 开发子代理，负责接口设计与实现 tools: Read, Write, Edit, Bash, Grep --- 你负责后端 API 的开发。只处理接口层相关任务，不修改前端代码。 完成后输出：接口路径、请求方法、参数结构、返回结构。

编排步骤：先确认主 Agent 通道已通（第 2 节的三件套）；再建两个子代理文件，一个前端一个后端；然后在对话里派发「前端子代理做 UI，后端子代理做 API，各自独立完成后汇总」。主 Agent 会自动派发，你只需审阅汇总结果。

三者协同是分层管道：Commands 做触发入口，Skills 注入知识，Subagents 并行执行，主 Agent 汇总输出。选择上，快速触发固定工作流用 Commands，需要领域知识但不用并行用 Skills，任务可分解且要并行用 Subagents。

5. 本篇常见报错排查：401、local proxy failed 与 OAuth

配通道和扩展时最容易撞的几类报错，逐个对。

401 Unauthorized：Key 没填对或过期。检查 Qoder 模型配置里的 API Key 是否和控制台生成的一致，注意别把 Key 前后的空格带进去。如果刚在控制台重新生成过 Key，旧 Key 会失效，要同步更新配置。用模型对话入口https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite单独测一次 Key，能通说明 Key 没问题，问题在 Qoder 配置。

local proxy failed / connection refused：Base URL 写错或网络不通。确认写的是https://taotoken.net/api，不要多写路径后缀，也不要带 UTM 参数。如果 Qoder 里开了本地代理转发，检查代理端口是否和配置一致。这类报错九成是地址拼错。

reading choices 报错：通常是返回体结构不符合预期，多半是 Model ID 填了一个通道不支持的模型。换一个确认可用的 Model ID 再试，或者去接入文档https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite核对模型列表。

OAuth 相关报错：如果你在 Qoder 里同时开了官方账号登录和自定义通道，两者可能冲突。把自定义通道设为默认，或退出官方 OAuth 登录后重配三件套。Claude Code 风格配置里如果残留旧的 auth 字段，也会触发 OAuth 校验，清掉再填 Base URL + Key + Model ID。

Commands 不生效：检查文件是否放在.qoder/r/c/commands/下，扩展名是否.md，首行屏蔽指令是否拼写正确。Qoder 需要重启或重新加载窗口才会识别新命令。

Skills 不自动触发：description写得太泛，模型判断不出相关性。把 description 写具体，比如「检查 Java 接口的安全性和参数校验」比「代码审查」更容易命中。

Subagents 不并行：子代理文件没放对目录，或主 Agent 没识别到。确认路径是.qoder/r/a/agents/{name}.md，frontmatter 的name和文件名一致。

排障顺序建议：先测 Key（模型对话入口）→ 再测 Base URL（发一句你好）→ 再测 Commands（/j/java是否秒回）→ 最后测 Subagents。逐层定位，别一上来就怀疑扩展配置。

6. 把统一 Key 用在长期编码任务上

Commands、Skills、Subagents 配完后，日常 Vibe Coding 的链路就顺了：知识查询用屏蔽命令秒回，代码审查用 Skill 自动加载，全栈任务用 Subagents 并行。所有扩展共用https://taotoken.net/api这一条通道和一个 Key，换模型只改 Model ID，不用动扩展文件。

如果你要把这套用在长期编码或 Agent 任务上，Key 的管理入口在https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite，可以按项目建多个 Key 分开计费。Claude Code 风格的接入细节在https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude-code-anthropic&utm_campaign=rewrite，字段对照着填就行。

最后留一个实用习惯：把项目级 Commands 和 Skills 提交到 Git，团队拉下来就能用同一套工作流；用户级配置放本地，不共享。这样 Commands 管边界、Skills 管知识、Subagents 管并行，三件事各归各位，Agent 才不会越跑越乱。