DeepSeek Harness 爆火的同一周,我用 Kimi Code 在本地搭出了跨项目多智能体调度

TL;DR:多个项目各自配了 Agent 人格(AGENTS.md)、项目技能和工具链,想从一个主会话统一调度,直接派子代理是不行的——子代理继承的是主会话的技能清单和 MCP 注册表,不随工作目录切换。正解是在目标项目目录起无头会话,人格/技能/MCP/模型四线全部按 cwd 自动加载,干完退出,留可续派的 session id。本文是搭建过程和实测记录,文末附复现清单。

背景一句:8 月 13 日 DeepSeek 开源智能体框架 Harness(一切皆插件、可换模型、无头运行),两天冲到 9.5 万 star(8 月 15 日 GitHub 数据)。它解决的是"通用框架"问题,我解决的是自己的问题:手里的项目、数据、工具链,不出本机,一个窗口调度。

环境:Windows 11 + Git Bash,Kimi Code CLI 0.37.2,Python 3.13 项目 venv。

问题定义

我有两个 Kimi Code 项目:

• D:/code/thinking:主控项目,日常会话都在这里;
• D:/code/甬金改扩建:公文写作项目,AGENTS.md 定义了"征迁科负责人"人格,自带 python-docx 工具链。

需求:不切换窗口,从主控项目指挥公文项目的 Agent 干活,且它的人格、技能、配置必须生效。

先证伪:子代理方案为什么不成立

Kimi Code 的 Agent 工具可以派子代理,子代理也能读目标目录的 AGENTS.md 文件(系统会强制提示先读)。但有三样东西不跟过去:

1. 项目级技能:技能分四级加载,Project > User > Extra > Built-in,Project 级取自"工作目录向上找最近的 .git 所在根"下的 .agents/skills/ 和 .kimi-code/skills/。子代理跑在主会话的 cwd 下,看到的是主控项目的技能清单;
2. MCP 配置:会话级,跟启动目录走;
3. 模型配置:子代理用主会话的模型,目标项目 config 里配的 default_model 不生效。

子代理方案的正确用法只剩一种:在任务书里写明技能文件路径让它先读。人格靠读文件,技能靠读文件,能用,但每一步都要手工拼。

正解:在目标目录起无头会话

kimi -p 是非交互模式:不开 TUI,给一句 prompt,跑完输出到 stdout 退出,默认 auto 权限(静态 deny 规则仍生效)。

实测命令:

cd /d/code/甬金改扩建 && kimi -p "用一句话说明你是谁,列出你的项目级技能"

实测输出(节选):

我是 Kimi Code CLI 智能体,在本项目中作为 TJ01 标征迁科负责人的 AI 工作助手,职责是政务写作、制定计划、编制方案、制作 PPT 报告及各类文档处理。当前没有项目级技能——现有技能列表全部属于用户级范围。

人格加载正确(读的是目标目录的 AGENTS.md),技能报告与事实一致(该项目确实没有项目级技能)。进程正常退出,返回可续派的 session id。

配套参数:

kimi -p "任务" -m <model>            # 本次调用换模型
kimi -p "任务" --skills-dir <dir>    # 外挂技能目录(可重复)
kimi -p "任务" --output-format stream-json  # JSONL 输出,可编程解析
kimi -r <session_id> -p "追加任务"   # 续派同一会话,有记忆延续

调度架构:三通道

约束条件:-p 与 --yolo/--auto/--plan 互斥(它自己就是 auto);在对方目录是自动放权,任务书必须写死读写边界;产出必须落文件,无头会话零记忆,上下文全靠文件传递。

实战案例:公文生成派单

任务:起草一份小区给指挥部的公文报告。流程:

1. 主控项目整理素材包 Markdown(时间线、诉求、审批链路、禁写项),落到目标项目目录;
2. 写任务书 Markdown:文种、主送、落款、骨架、硬约束(只许新建两个文件、内部研判不入文、缺失信息标【待核实】);
3. kimi -p "$(cat 任务书.md)" 派单;
4. 产物:A4 公文版式 docx(python-docx 生成)+ 同名 md 审阅稿;
5. 主控侧验收:对照任务书逐项核。

踩坑记录

坑 1:WPS 文件锁。 改写正在 WPS 里打开的 docx,python-docx save 报 PermissionError: [Errno 13]。只能先关文件。教训:改用户可能正在看的文档前,先确认占用。

坑 2:Git Bash 中文路径乱码。 mv 批量移动中文文件名直接报 cannot stat,命令行编码把文件名打花了。改用 Python shutil.move,进程内 UTF-8,一次过。教训:Windows 下批量中文文件操作,不要走 shell 走 Python。

坑 3:python-docx 拒绝 .dotm/.dotx。 想把 WPS 默认模板(Normal.dotm)当生成底稿,python-docx 直接抛 ValueError: not a Word file,因为它只认 document.main+xml 的 content type。解法:zip 级改写 [Content_Types].xml,把 template.macroEnabledTemplate.main+xml 替换成 document.main+xml,剔除 vbaProject 部件(如有),另存为 .docx 底稿。模板里的页面设置(GB/T 9704 公文边距:上 3.7/下 3.5/左 2.8/右 2.6cm,行距固定 28 磅)和字体样式全部保留。

复现清单

1. 每个项目根目录写 AGENTS.md:角色、职责、硬约束、目录约定;
2. 项目专属技能放 <项目>/.agents/skills/<名>/SKILL.md,目录形式需显式写 name 和 description;
3. 派单前两件落文件:素材包 + 任务书(含读写边界);
4. cd <项目> && kimi -p "$(cat 任务书.md)";
5. 验收对照任务书,产出归档到 类型目录/YYYYMMDD_任务名/ 任务文件夹。

参考:kimi 命令参考、Agent Skills。

这套体系我另写了一份完整 SOP:术语表、四件套配置规格、三通道操作规程、质量闸门、故障案例库、逐条验收清单,丢给 AI 就能照着复刻。评论区扣"中台"或者点个关注,我把《跨项目多智能体调度体系 SOP v1.0》完整版发你。

野生码农 · 全网同名 · AI 数字员工实战复盘,数据只报实测

素材点

• 子代理三不继承:项目技能/MCP/模型配置不随目录切换
• python-docx 打开 .dotm 的 content-type 改写解法
• Windows 中文文件批处理:绕开 Git Bash 走 Python
• WPS 模板收编成 AI 公文底稿:GB/T 9704 版式自动化
• 内容升级包玩法:S2/S3 结尾用 S4 完整 SOP 换互动

分发配套

标题 Top5

1. DeepSeek Harness 爆火的同一周,我用 Kimi Code 在本地搭出了跨项目多智能体调度(实体锚定+热点+反差,88 分,综合首选)
2. 子代理为什么调不动另一个项目的 Agent?我查了官方文档,命门在 cwd(问题悬念+机制,84 分,知乎向)
3. Kimi Code 技能四级加载机制实测:Project 级技能为什么不继承(隐藏机制,82 分,搜索版)
4. 不上面向平台,零平台费:我的本地多智能体调度方案(数字反差,81 分,公众号向)
5. 从派子代理失败到无头派单:我的跨项目 AI 调度踩坑记(身份场景,79 分,实验版)

摘要(98 字):DeepSeek Harness 两天 9.5 万 star 的同一周,一个开发者用 Kimi Code 在本地搭出跨项目多智能体调度:实测证伪子代理方案(技能/MCP/模型不随目录继承),正解是在目标项目目录起无头会话,四线配置按 cwd 自动加载。附架构对照、三个坑与复现清单。

分类与话题:掘金-AI/后端;#Kimi Code #多智能体 #Agent #DeepSeek Harness #自动化

封面文案:DeepSeek Harness 爆火同一周,我本地搭出多智能体调度(综合首选压缩版,保留热点实体+动作)