zdq 量化项目从 Trae/Claude 迁移到 Kimi Code 的完整过程记录

背景

D:\code\python\zdq 量化交易系统项目历史上先后用过 Trae CN 和 Claude Code,留下 .trae/skills、.claude/skills、.agents/skills 三套不同步的技能配置,以及 Trae 云端智能体、.trae/rules 规则等遗产。本次会话目标:完成向 Kimi Code 的环境迁移,并让多角色多智能体并发工作流可运转。

核心内容

1. 三端技能对齐

• .trae/skills(9 个,最早期中文原版)与 .agents/skills(8 个)完全不同步:8 个同名 SKILL.md 全部有差异(中译英改写);tushare 从 285 行被精简到 78 行,丢失大量接口文档;frontend-test-mcp 改名 frontend-test;task-executor 是空目录。
• .claude/skills 与 .agents/skills 8 个技能中 6 个逐字节相同,差异仅为合理的工具适配(脚本路径、CLAUDE.md→AGENTS.md 引用)。
• 整合结果(核心功能零变更为原则):
  • tushare 从 .trae 原版恢复合并(78→158 行,补回 72 行接口条目和 86 个在线文档直链);
  • daily-work-start 恢复被英文改写抹掉的"调用 CIO 智能体"语义(依据:其自带 main.py 里仍写着 CIO);
  • stock-data-manager 修 10 处中英混杂瑕疵,ai-dev-blog 修 1 处;
  • code-cleaner 残留 5 处 CLAUDE.md 引用改为 AGENTS.md。
• .trae/、.claude/ 定位为存档目录,全程只读,不做反向同步。

2. Trae 云端智能体恢复为 Kimi Code 技能

• Trae CN 自定义智能体完整列表只在云端,本地仅从 state.vscdb(全局状态库)和聊天输入历史恢复了部分定义;用户后续从 Trae 面板手动粘贴补齐。
• Kimi Code 子智能体只有 coder/explore/plan 三种内置类型、不支持自定义类型,角色的载体用技能(SKILL.md):Trae 智能体的 名称+描述(何时调用)+prompt 与技能结构一一对应。
• 六角色团队最终形态:
  • CIO(首席投资官)→ cio 技能
  • 量化架构总监 → quant-architect-director 技能
  • 后端架构师 → backend-architect 技能
  • 前端架构师 → frontend-architect 技能
  • DuckDB 运维专家 → duckdb-sre 技能(含 db_config.py 连接规范、LIMIT 规则)
  • 量化质监总监 → 现有 strategy-validator 技能(逐项核对验收标准一字不差,不重建)
• 每个角色技能统一格式:Kimi frontmatter → Trae 原文角色定义(一字未改)→ 何时调用 → 本项目适配说明。

3. 并发调度层补齐

角色齐备但缺"并发调度"胶水,新增:

• AGENTS.md 加 "Multi-Agent Concurrent Dispatch" 节:角色↔技能↔执行载体映射表(CIO 由主智能体直接扮演,其余映射到 coder 子智能体)、派发模板四要素(角色注入/任务与验收标准/边界约束/汇报格式)、并发规则(同文件不并发、单轮 2–8 个、有依赖串行)。
• cio 技能补:计划确认后由主智能体按规则并发派发;daily-work-start 第 10 步指向调度规则,闭环"扫描→CIO 计划→确认→并发派发"。

4. .trae/rules 规则迁移进 AGENTS.md

• 并入:DuckDB 运维 4 条细则(禁多线程写入、百万条提交事务、断点续传+内存去重、启动自检)、内存规则加强(超 85% 降速)、"禁止擅自创建用户未要求的文件"、协作验收 4 条(交付过 strategy-validator 验收、偏差≥20% 预警、数据诚信)、文件恢复改为 git 回滚点方式。
• 废弃:PowerShell 专属规则(Kimi 用 Git Bash)、Trae Timeline 恢复命令、"全自动执行授权"(yolo 模式已覆盖)、project-overview.md 整文件(已被 AGENTS.md 取代且参数过时)。

5. MCP 服务接入

• 最大缺口:Trae 时代 MCP 配置从未迁移。新建项目级 .kimi-code/mcp.json 并冒烟验证:
  • duckdb(uvx + mcp-server-motherduck,指向 F:/zdq_data/stock_data.duckdb,本地文件默认只读不持锁,与夜间写入任务安全并行)
  • playwright(给 frontend-test 技能补真实浏览器能力)
  • context7(第三方库文档查询)
• 环境坑:本机默认 node v24 缺 npm/npx,配置统一用 nvm v22.11.0 和 uvx 绝对路径。
• 发现 quant_data_mcp 自首次提交起就是坏的(缺 adapters/、router.py),标注"未完成"未接入,是否补建待用户决策。
• MCP 服务只在新启动的会话中连接。

6. Git 落库

• 0ac62ec — 迁移前回滚保护快照(动手前先提交推送,用户明确要求)
• a7b97ee — 迁移完成(技能整合+角色技能+调度规则+规则迁移+MCP)
• 0ad1f06 — 当日任务执行成果(回测脚本修复+违规脚本清理+日度计划)

原文链接

提炼自 inbox/kimi_code/20260717_bee70a3a.md(会话 session_bee70a3a)