企业官网建设流程全解析

1. 为什么 Multitask 多开 Agent 越用越乱

在 Cursor 里做 Vibe Coding，一开始都很爽：主会话聊需求，旁边开几个 Agent 分别探索、实现、跑测试。任务一多，问题就来了。主会话把半截结论粘给下一个 Agent，一句「按我们刚才说的改」就完事；Worker 之间互相「如上所述」，审计链直接断掉；编排的人手痒顺手写了半个模块，控制面和执行面搅在一起；测试绿了一次就喊完成，实现者还在自评自己的 diff。

这不是模型不够聪明，是协作缺少秩序。CASA（Contract-driven Agent Skill Architecture）给出的回答很直接：Agent 之间只传产物，不传对话；靠授权，不靠信任。落到 Cursor 里，就是 casa-commander 这个 Agent Skill + rules + 可选配置的组合。它面向日常 Vibe Coding 的操作层，不是再造一个重型运行时。

你可以把它理解成 Cursor Multitask 的上位替代——不是「多开几个窗口」，而是「有契约、有产物、有档位、有双次验收的多 Agent」。这篇就聚焦一件事：在 Cursor 里把 casa-commander 的配置文件骨架搭起来，并用几步验证动作确认它真的在按契约跑，而不是又退化成传话接力。

适合谁：跨模块重构、联调、要可审计交付的 Vibe Coding；想用多模型（便宜模型探查、强模型攻坚、独立审查）又不想靠记忆的团队。不适合：真·一行 typo，或者意图还没收敛的纯探索对话——先聊清楚，再写 Contract。

2. TaoToken 前置：统一 Key 接入 casa-commander

casa-commander 的模型路由写在.cursor/casa-commander.yml里，models.aliases.*需要映射到你本机 Cursor 真实可调用的模型 slug。如果你用 TaoToken 做统一入口，就不用为每个模型单独配一堆 Key，一个 Key 覆盖 simple / hard / architect / reviewer 四档路由。

TaoToken 在这里的角色是「模型调用的统一网关」：你在 Cursor 里配置一次 Base URL 和 API Key，casa-commander 的别名路由就能指向不同模型，探查用便宜模型、攻坚用强模型、审查用独立模型，全部走同一个 Key。这样 Contract 里的model_override和 yml 里的别名映射才有意义，不会因为 Key 分散而配错。

先拿 Key。打开控制台创建 API Key，建议按用途命名，比如cursor-casa-dev，方便后面排障时区分是哪个环境在调用：

https://taotoken.net/console

创建后复制 Key，注意只显示一次。接着确认你要用的模型 slug，在模型对话页可以先手动试一次，确认这个模型在你的账号下可用：

https://taotoken.net/model-chat

如果你打算长期跑编码和 Agent 任务，Coding Plan 会比按次调用更省心，额度覆盖多模型切换场景：

https://taotoken.net/coding-plan

接入文档里有 Cursor 的 Base URL 填法和 OpenAI 兼容格式说明，配置前扫一眼能少踩坑：

https://taotoken.net/doc

API 端点本身是https://taotoken.net/api，在 Cursor 的模型配置里填这个作为 Base URL，Key 填刚创建的那串。注意：casa-commander 的 yml 里写的是模型 slug，不是 Key，Key 统一在 Cursor 的 provider 配置里管，两者别混。

3. 可复制配置：settings.json 与 config.toml 骨架

casa-commander 安装后主要动三个地方：.cursor/skills/casa-commander/（Skill 正文和模板）、.cursor/rules/casa-*.mdc（铁律与委派规范）、.cursor/casa-commander.yml（模型路由、知识库模式、代码智能 MCP、架构审查开关）。下面给出可直接复制的骨架。

先装 Skill。仓库地址是https://github.com/surmusz/casa-commander，MIT 协议。一键安装脚本：

git clone https://github.com/surmusz/casa-commander.git cd casa-commander bash scripts/install.sh /path/to/your-project # 无公司知识库时再考虑： # bash scripts/install.sh --with-kb .

装完后编辑目标项目里的.cursor/casa-commander.yml。这是核心骨架，把models.aliases.*改成你本机 Cursor 真实可调用的 slug，禁止编造：

# .cursor/casa-commander.yml models: aliases: simple: "your-cheap-model-slug" # 探查、读文件、列符号 hard: "your-strong-model-slug" # 实现、重构 architect: "your-arch-model-slug" # 架构审查 reviewer: "your-review-model-slug" # 独立复验 routing: complexity_map: simple: simple standard: hard core_framework: architect knowledge: mode: off # off | builtin | external # external 时填： # root: "./docs/kb" # entrypoints: ["index.md"] code_intel: mcp: "codegraph" # 探查工具，不是第二套 CASA policy: "commander_first" # 指挥官查过结构，不再派 explore 用 Grep 重做 architecture_review: enabled: true trigger: "core_framework" # 核心框架任务验收后必须过架构审查

如果你更习惯用config.toml风格管理（部分团队会把它作为 yml 的镜像），可以放一份等价骨架在项目根，方便 CI 读取：

# .cursor/casa-commander.toml（可选镜像） [models.aliases] simple = "your-cheap-model-slug" hard = "your-strong-model-slug" architect = "your-arch-model-slug" reviewer = "your-review-model-slug" [models.routing.complexity_map] simple = "simple" standard = "hard" core_framework = "architect" [knowledge] mode = "off" [code_intel] mcp = "codegraph" policy = "commander_first" [architecture_review] enabled = true trigger = "core_framework"

Cursor 侧的 provider 配置（settings.json片段）负责把 Key 和 Base URL 接上，模型 slug 与 yml 里的别名对应：

{ "cursor.providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-your-taotoken-key", "models": [ "your-cheap-model-slug", "your-strong-model-slug", "your-arch-model-slug", "your-review-model-slug" ] } } }

角色定义放在可选的AGENTS.md里，明确 dialogue / orchestrator / worker / evaluator 四类角色，避免「谁方便谁写」：

# AGENTS.md - dialogue: 只澄清意图，不写业务代码 - orchestrator: 只编排，不实现；产出 Contract 与 brief - worker: 按 brief 的 scope/acceptance 执行，产物落盘 - evaluator: 只读审查，独立复验，不参与实现

两档启用要分清。CASA 最小档：复杂但可单会话完成，写 Contract + 产物落盘 + acceptance，可不启 Task。指挥官档：多模块 / 并行探索 / 需独立审查，主会话只编排，Worker 执行，Evaluator 只读审查。单文件 typo 不必完整 Contract，但仍禁止传话与自评交付。

4. 验证请求：确认 casa-commander 真的在按契约跑

配置完别急着上大任务，先用一个最小验证动作确认链路通。Reload Cursor Window 后，在对话里说「使用 CASA」或「指挥官模式」，观察它是否先出 Contract / Plan，而不是直接改业务代码。

第一步，验证模型路由。发一个探查类请求，看它是否走 simple 档：

使用 CASA 最小档。 Goal: 定位 auth token 过期处理逻辑 Read: src/auth/token.py, tests/test_token.py Write: .cursor/artifacts/run-42/explore.md Scope: only src/auth/**, tests/test_auth* Tools: readonly Acceptance: explore.md 列出符号 + 过期调用链

正确的结果是：它先产出 Contract（scope / acceptance 写清），批准后才进 Execute，产物落在.cursor/artifacts/run-42/explore.md。如果它直接开始改代码，说明 Contract Gate 没生效，回去检查 rules 是否加载。

第二步，验证委派 brief 格式。指挥官档下，Worker 收到的 brief 应该长这样（来自仓库 examples.md 的正确示范）：

Required model: composer-2.5 Goal: Locate expiry handling in auth token code Read: src/auth/token.py, tests/test_token.py Write: .cursor/artifacts/run-42/explore.md Scope: only src/auth/**, tests/test_auth*; do not touch src/billing/** Tools: readonly; Data: repo paths above Acceptance: explore.md lists symbols + call chain for expiry

错误示范只有一句就够警醒：As we discussed, fix the token thing…。如果你在日志里看到这种「如上所述」的传话，说明 brief 没走结构化字段，检查.cursor/rules/casa-*.mdc是否被覆盖。

第三步，验证双次验收。让一个任务故意留个小问题，看它是否走 Verify + 独立 Reverify，失败时只注入fail-*.md+ Contract，而不是把整段对话再塞一遍。产物默认落在.cursor/contracts/与.cursor/artifacts/，人眼可查、可 diff、可回放。

第四步，验证架构审查关。把任务标成complexity: core_framework，验收后应触发 Architecture Review，不过关不得 done。这一步能确认architecture_review.enabled和trigger生效。

5. 本篇常见错排查

报错一：模型 slug 找不到 / 调用 404。最常见原因是 yml 里的别名映射了不存在的 slug。排查：在模型对话页手动试一次该 slug，确认可用；再核对settings.json的models列表是否包含它。别在 yml 里写 Key，Key 只在 provider 配置里。

报错二：Contract Gate 不生效，直接改代码。检查.cursor/rules/casa-*.mdc是否被项目其他 rules 覆盖，以及 Skill 是否装到了正确路径.cursor/skills/casa-commander/。Reload Window 后重试。

报错三：Worker 之间还在传话。说明 brief 没走结构化字段。对照 examples.md 的正确示范，确认 brief 只含路径与结构化字段，禁止「如上所述」。必要时在AGENTS.md里重申 orchestrator 不实现、worker 按 scope 执行。

报错四：知识库模式配错。已有公司 KB 时推荐保持off；builtin是install --with-kb后的最小 KB；external要指向任意知识根 + entrypoints。配错会导致探查阶段读到无关内容。

报错五：代码智能 MCP 被当成第二套 CASA。Codegraph 这类是探查工具，不是编排层。策略是「指挥官查过结构就别再派 explore 用 Grep 重做一遍」，intel 全文须落盘再引用路径，禁止当传话粘贴。

报错六：core_framework 任务没过架构审查就 done。检查architecture_review.enabled是否为 true，trigger是否为core_framework。核心框架任务验收后必须过架构审查，这是硬门禁。

排障时如果怀疑是 Key 或额度问题，去 API Keys 页确认 Key 状态和用量：

https://taotoken.net/api-keys

接入格式和 Cursor 配置细节以接入文档为准：

https://taotoken.net/doc

6. 把秩序补上：从配置到日常习惯

Vibe Coding 的上限，不取决于你能多开几个 Agent，而取决于协作是否可契约、可产物、可授权、可复验。casa-commander 把 CASA 从理论公理变成 Cursor 里每天能点的 Skill——它不是否定 Multitask，而是给多 Agent 写代码补上缺了很久的那层秩序。

落地时记住几个习惯：复杂任务先说「使用 CASA」，让它先出 Contract 再动手；brief 只传路径和结构化字段，不传对话摘要；产物落.cursor/artifacts/，可 diff 可回放；核心框架任务必过架构审查。模型路由交给 yml，Key 交给 TaoToken 统一管，两者别混。

如果你还在用 Multitask 硬扛多模块任务，不妨先用最小档跑一个探查任务，感受一下「有契约」和「靠记忆」的区别。跑通后再上指挥官档，把探查、实现、审查分给不同模型，稳定性和可审计性会明显不一样。