Skills 与 Agent

Agent Skills

Skill 是一份带 YAML frontmatter 的 Markdown 文档，描述专业知识或工作流程（代码风格、PR 评审清单等），沉淀在文件里可跨项目和团队复用，可通过斜杠命令一键加载，也可以让模型在需要时自动调用。两种文件结构：目录形式（推荐）——Skills 目录下建子目录，主文件 SKILL.md，可放脚本、参考资料（正文用 ${KIMI_SKILL_DIR} 引用）；扁平形式——直接把一个 .md 放在 Skills 目录顶层，适合简单 Skill（name 可省略，取文件名去掉 .md）。同一目录下 <name>/SKILL.md 与 <name>.md 并存时以目录形式为准。frontmatter 字段：name（大小写不敏感，目录型必填）、description（一行总结，模型据此判断何时使用，目录型必填）、type（如 prompt）、whenToUse、disableModelInvocation、arguments 等。

Agent 与 subagent

每个会话由一个 main agent 驱动：理解意图、规划步骤、调用工具，必要时派发 subagent 处理聚焦子任务。subagent 在自己的独立上下文里工作，只返回结论，中间思考和工具调用不混入 main agent 的历史；多个可并行，但各自独立消耗 token，简单任务没必要派发。内置三种：coder（默认，通用软件工程助手，可读写文件、执行命令、搜索、落地改动）、explore（只读的代码库探索）、plan（实现规划与架构设计，连 Shell 命令都不提供）；三者都不能再派发新的 subagent。每次派发会以审批请求呈现（除非 allow 规则放行或处于 YOLO 模式），可后台运行，完成后结果自动回到 main agent。权限继承：subagent 的权限规则继承自 main agent。自定义 Agent：用带 Frontmatter 的 Markdown 文件定义（名称、描述、工具权限在 Frontmatter，正文是系统提示），可被 main agent 自动委派，也可在启动时选为 main agent（--agent/--agent-file）。目录优先级：显式（--agent-file）> 项目 > 额外 > 用户 > Plugin > 内置；用户级在 ~/.kimi-code/agents/ 和 ~/.agents/agents/。SYSTEM.md 可永久覆盖 main agent 的系统提示词。指令文件：全局 Kimi 专属指令放 $KIMI_CODE_HOME/AGENTS.md（默认 ~/.kimi-code/AGENTS.md），项目里用 /init 生成的 AGENTS.md。