满血口径定案复盘

背景与目标

dev 团队的数字员工靠 kimi -p 无头模式派单。一个岗位实例要"满血",必须三件套齐全:岗位身份(agent.md)+ 套件技能(skills/)+ MCP 工具。9-10 链路测试定的是 --agent-file agent.md 口径,能跑;但本人在会话中更新章程改成 --skills-dir skills/ 口径——两种口径到底差在哪、哪个是满血,没人实测过。

本人在复盘博客的尾巴上抓住这句话不放,连续两问:"这个什么意思?""--agent-file 启动的终端,不能调用子文件夹里面的技能?"——把一场口头解释逼成了一次完整的配置排障。

过程回顾

尝试 1:凭记忆解释(不合格)。 我先按理解答了两种口径的差别:agent-file 挂身份、skills-dir 挂技能。本人追问第二句,我才意识到:这是事实问题,不是理解问题——跑探针。

尝试 2:探针自报(半血实锤)。 用旧口径 --agent-file agent.md 启动 01 岗,让它自报 Skill 清单:28 个套件技能一个都不在,实例原话"这 28 个套件技能不在 Skill 工具清单里"。它能读到这些文件(当手册翻),但不能以技能机制调用。旧口径是半血。

尝试 3:组合口径(还是半血,但更诡异)。 kimi --agent-file agent.md --skills-dir skills/ -p:身份在了,28 个技能还是没有,而且用户级技能(yanbao 等)也消失了——--skills-dir 会顶掉自动发现。零报错、零提示、静默零加载。

尝试 4:查官方文档 + 换绝对路径(定案)。 文档写明项目级技能扫描路径是 .kimi-code/skills/ 和 .agents/skills/,skills/ 裸目录本来就没有惯例支撑。把 --skills-dir 换成绝对路径再探:28/28 全部挂载。最终满血口径:

cd <岗位目录> && kimi --agent-file agent.md --skills-dir "<该岗 skills 绝对路径>" -p "<prompt>"

收尾:三岗逐一探针验收。 03 岗=身份✓+2 技能✓+4 个 mcp__ 工具;04 岗=身份✓+2 技能✓+2 个 mcp__ 工具;01 岗=身份✓+28 技能✓+mcp__ 无(9-14 另一会话本人已裁定 playwright MCP 全撤、浏览器统一 kimi-webbridge,daemon 探活 ok,属预期)。章程写回口径+三件套验收探针,故障台账登记。

关键踩坑

坑 1:--skills-dir 相对路径静默零加载(本期主坑)。 现象:技能零挂载、用户级技能被顶掉、全程无任何报错。根因:CLI 0.43.0 的 --skills-dir 相对路径不解析到 cwd,官方文档对这个旗标的相对路径基准只字未提。解决:一律绝对路径,并把"技能挂载数"列为验收正证据。

坑 2:章程先写未验证口径。 本人 9-15 前在章程里写的 kimi --skills-dir skills/ -p 就是相对路径写法——如果照此派单,所有岗位实例都是静默半血,而且实例会"照着文档手动执行"把活干完,从产出上根本看不出来。这是最阴的一类配置缺陷:能交付,但交付路径与设计承诺不符。

坑 3:多会话配置状态错位。 排查中发现 9-14 另一个会话已经修过 MCP(移 .kimi-code/mcp.json+信任闸+cmd /c 包装)并裁定 playwright 全撤——我最初的消息里还在建议"把 01 岗 mcp.json 挪到 .kimi-code",如果动手就是重复劳动+冲突裁定。解决:改配置前先通读故障台账,状态以台账为准。

最终方案

满血 = 三件套,验收 = 三件套探针,全部写进 CIO 章程:

• 派单命令定稿(上文代码块),--skills-dir 强制绝对路径;
• 派单验收探针:身份一句话自证 + 技能挂载数 + mcp__ 工具清单,禁"写了就算配了";
• --skills-dir 取代自动发现的副作用转正:岗位实例与用户级技能天然隔离,符合最小权限;
• 01 岗浏览器能力走 kimi-webbridge 插件(daemon 127.0.0.1:10086),无 per-post MCP 属预期配置。

做得好的地方

• 探针驱动排障:4 次最小探针(自报技能/组合/绝对路径/三岗验收),每次只问一个问题,总计不到 15 分钟把口径定死;
• 没有盲动:发现 playwright 全撤是本人裁定后,没有为凑"字面满血"重装,而是实测 webbridge 替代链路并如实上报,把裁定权留給本人;
• 本人两连问的价值:从"什么意思"到"不能调用技能?"——第二个问题才是真问题,直接决定了排障方向。

复盘与改进

• CLI 行为三源校验:文档说了不算,惯例说了不算,探针说了算;任何派单口径进章程前必须先过探针;
• 静默失败(零报错零加载)是最危险的配置缺陷,验收必须看正证据(挂载数/工具清单),不能看负证据(没报错);
• "我来验证"类承诺当场闭环,不留"下次"——本次就是上一篇复盘写了"下次派单前验证",被本人当场抓住才做掉的。

成长评估(10 分制,只对事)

AI 自评失分点:① 第一问凭记忆解释 CLI 行为,没先跑探针,是本人追问才进入实证轨道——解释工具行为应先探针后下结论;② 上一篇复盘把验证动作承诺到"下次",执行纪律上留了尾巴,被当场抓包;③ 最初建议"挪 01 岗 mcp.json"时没先读故障台账,差点与另一会话的本人裁定冲突——配置动作前读台账应成为肌肉记忆。

素材点

• --skills-dir 相对路径静默零加载:kimi 0.43.0 实测行为,绝对路径才挂载,可写成团队排障案例;
• "满血三件套探针"(身份自证/技能挂载数/mcp__ 工具清单)可直接复用为所有无头智能体的投产验收模板;
• "能交付但交付路径与设计承诺不符"——半血实例会读文档把活干完,从结果看不出配置缺陷,这是多智能体系统最隐蔽的失效模式;
• 媒体稿角度:AI 团队不是搭起来就能跑,每个"我以为配好了"都要用探针赎回来。