在 Cursor 里落地 CASA：casa-commander 配置文件骨架与验证动作

1. 为什么 Multitask 多开 Agent 越用越乱在 Cursor 里做 Vibe Coding一开始都很爽主会话聊需求旁边开几个 Agent 分别探索、实现、跑测试。任务一多问题就来了。主会话把半截结论粘给下一个 Agent一句「按我们刚才说的改」就完事Worker 之间互相「如上所述」审计链直接断掉编排的人手痒顺手写了半个模块控制面和执行面搅在一起测试绿了一次就喊完成实现者还在自评自己的 diff。这不是模型不够聪明是协作缺少秩序。CASAContract-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-commandercasa-commander 的模型路由写在.cursor/casa-commander.yml里models.aliases.*需要映射到你本机 Cursor 真实可调用的模型 slug。如果你用 TaoToken 做统一入口就不用为每个模型单独配一堆 Key一个 Key 覆盖 simple / hard / architect / reviewer 四档路由。TaoToken 在这里的角色是「模型调用的统一网关」你在 Cursor 里配置一次 Base URL 和 API Keycasa-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/docAPI 端点本身是https://taotoken.net/api在 Cursor 的模型配置里填这个作为 Base URLKey 填刚创建的那串。注意casa-commander 的 yml 里写的是模型 slug不是 KeyKey 统一在 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-commanderMIT 协议。一键安装脚本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_frameworkCursor 侧的 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 列出符号 过期调用链正确的结果是它先产出 Contractscope / 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 里写 KeyKey 只在 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 时推荐保持offbuiltin是install --with-kb后的最小 KBexternal要指向任意知识根 entrypoints。配错会导致探查阶段读到无关内容。报错五代码智能 MCP 被当成第二套 CASA。Codegraph 这类是探查工具不是编排层。策略是「指挥官查过结构就别再派 explore 用 Grep 重做一遍」intel 全文须落盘再引用路径禁止当传话粘贴。报错六core_framework 任务没过架构审查就 done。检查architecture_review.enabled是否为 truetrigger是否为core_framework。核心框架任务验收后必须过架构审查这是硬门禁。排障时如果怀疑是 Key 或额度问题去 API Keys 页确认 Key 状态和用量https://taotoken.net/api-keys接入格式和 Cursor 配置细节以接入文档为准https://taotoken.net/doc6. 把秩序补上从配置到日常习惯Vibe Coding 的上限不取决于你能多开几个 Agent而取决于协作是否可契约、可产物、可授权、可复验。casa-commander 把 CASA 从理论公理变成 Cursor 里每天能点的 Skill——它不是否定 Multitask而是给多 Agent 写代码补上缺了很久的那层秩序。落地时记住几个习惯复杂任务先说「使用 CASA」让它先出 Contract 再动手brief 只传路径和结构化字段不传对话摘要产物落.cursor/artifacts/可 diff 可回放核心框架任务必过架构审查。模型路由交给 ymlKey 交给 TaoToken 统一管两者别混。如果你还在用 Multitask 硬扛多模块任务不妨先用最小档跑一个探查任务感受一下「有契约」和「靠记忆」的区别。跑通后再上指挥官档把探查、实现、审查分给不同模型稳定性和可审计性会明显不一样。