3 步给 Kimi CLI 加上自定义命令:从零到调用的完整工具开发指南
3 步给 Kimi CLI 加上自定义命令从零到调用的完整工具开发指南【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli如果你日常用 Kimi CLI 写代码、跑脚本多半遇到过这样的事它不会执行你项目里才有的那条命令。Kimi CLI 是命令行里的智能代理而自定义命令正是它的扩展口——把一段 Python 脚本包装成工具AI 就能在对话中直接调用它。本文以仓库里现成的 examples/custom-tools/ 为参照带你走完从写工具到注册、验证的完整闭环。先看场景AI 缺的不是一句提示词而是一个能调用的动作假设你维护一个内部项目每次部署前都要先跑一遍本地检查脚本。你可以把用法写在 AGENTS.md 里让 AI 照着做但它终究是人肉执行——容易漏参数也拿不到结构化结果。把脚本包装成 Kimi CLI 自定义工具后情况变成AI 把它当成一个插座需要时插上调用传入参数拿到返回。就像厨房电器不需要懂电路原理插上插座就能工作自定义命令也一样接口清晰AI 就能稳定使用。搭骨架一个自定义工具项目长什么样仓库提供的示例目录就是一个完整的最小工程照着它的目录结构起步最省事my_tools/——工具实现所在的 Python 包myagent.yaml——代理配置声明用哪些工具main.py——演示入口用于验证工具是否被 AI 识别pyproject.toml——依赖声明先把示例跑起来确认环境没问题cd examples/custom-tools uv sync --reinstall uv run main.py写一个 AI 能看懂的工具Ls 实例工具的三要素是名字、参数模型、执行逻辑。示例里的Ls工具做了一件小事——列出指定目录下的文件。核心代码不长关键在于参数用 Pydantic 模型描述AI 才能知道该传什么from kosong.tooling import CallableTool2, ToolError, ToolOk, ToolReturnValue from pydantic import BaseModel, Field class Params(BaseModel): directory: str Field(description要列出文件的目录, default.) class Ls(CallableTool2): name: str Ls description: str 列出目录下的文件 params: type[Params] Params async def __call__(self, params: Params) - ToolReturnValue: import os try: items os.listdir(params.directory) return ToolOk(output\n.join(items)) except Exception as e: return ToolError(output, messagestr(e), brief列目录失败)两个细节值得注意description是给 AI 看的说明书写清楚工具能干什么AI 选工具时才会选对它。失败时返回ToolError而不是抛异常AI 拿到明确的错误信息后能自己调整重试。实现好之后在my_tools/__init__.py里导出即可让my_tools.ls:Ls这个路径可被配置引用。注册到代理配置把工具插进插槽写好工具只是第一步还要告诉代理你有这个工具。这一步改 myagent.yaml一行配置就把自定义工具加进了工具清单version: 1 agent: extend: default tools: - kimi_cli.tools.file:ReadFile - kimi_cli.tools.shell:Shell - my_tools.ls:Ls # 你的自定义命令extend: default表示继承默认代理的工具集你只需要追加自己的部分。整个引用格式是模块路径:类名改哪个类就改哪里不需要额外写注册代码。三十秒验证让 AI 自己报出工具清单注册是否成功不用猜。示例工程的 main.py 会创建会话并直接问 AI 一句你有哪些工具回答里出现Ls就说明注册生效uv run main.py如果回答里没有Ls排查顺序建议是先确认myagent.yaml的引用路径拼写再确认my_tools包内类已正确导出。这类问题 90% 出在路径上而不是工具逻辑。从单个工具到工作流组合、权限与分发单个工具跑通后真正的价值来自组合。常见做法有两类多工具协作——在tools列表里同时挂载文件读取、Shell、你的 LsAI 会自己决定先列目录、再读文件的链路无需你写编排脚本。权限约束——Kimi Code CLI 对工具调用有审批机制敏感工具可以要求用户确认后才执行启动时用--yolo或--afk参数可放开审批适合 CI 场景日常使用保持默认更稳妥。详见 docs/zh/configuration/overrides.md。工具成熟后如何分享两个方向把my_tools打成 Python 包发布到 PyPI别人uv add之后在各自的代理配置里引用即可如果只是团队内部使用直接把这个目录放进项目仓库配合 docs/zh/customization/skills.md 里的 Skills 机制补充使用规范同事克隆仓库就自动拥有这套工具链。走到这里你已经完成了一次完整的 Kimi CLI 工具开发识别缺口、写出最小工具、一行配置注册、让 AI 自证可用。下一个值得做的工具就从你每次都要手动敲的那条命令开始。【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Kryo序列化中unregistered class ID错误解析与解决方案

Kryo序列化中unregistered class ID错误解析与解决方案

1. 问题现象与背景分析最近在项目中使用Kryo进行对象序列化时,遇到了一个典型的报错:com.esotericsoftware.kryo.KryoException: Encountered unregistered class ID: 104这个错误通常发生在使用Kryo进行反序列化操作时,表明Kryo在读取序列化…

2026/11/20 19:33:24 阅读更多 →
二手车数据爬取与可视化分析:从抓包到交互看板的完整实现

二手车数据爬取与可视化分析:从抓包到交互看板的完整实现

简介:一套基于Python的汽车信息爬取与可视化分析系统设计展示资料,面向大数据、爬虫开发及数据可视化方向的学习者,适合用于课程设计、毕业设计或技术方案参考。资源围绕汽车信息采集与展示场景,整合Django后端框架、Scrapy爬虫、…

2026/11/18 10:30:16 阅读更多 →
美赛可用的可复现复杂网络随机图生成工具

美赛可用的可复现复杂网络随机图生成工具

简介:本资源是面向美国数学建模竞赛(MCM/ICM)参赛者的复杂网络核心算法参考代码包,聚焦Random Graph建模与分析,适用于需快速实现网络结构生成、社区识别及动力学模拟的中高级建模选手。压缩包仅含1个MATLAB源文件&…

2026/11/18 10:30:20 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻