人工智能大模型AI Agent代码智能体工具调用交互助手CLI【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址https://gitcode.com/GitHub_Trending/ki/kilocode点击查看免费下载Kilo Code 的自定义指令Custom Instructions机制允许开发者在不改动模型本身的前提下通过文件与配置精准塑造 Agent 的编码风格、文档规范、测试要求与决策流程。本文将系统讲解 VSCode 与 CLI 两种形态下的全部指令来源——从 Settings UI 中的按 Agent 提示词、项目根目录自动发现的AGENTS.md到全局配置目录与kilo.jsonc的instructions数组——并结合仓库源码剖析指令的向上查找、聚合注入与动态更新原理帮助读者搭建一套可落地、可维护的多层级指令体系。什么是自定义指令Custom Instructions 定义了超出 Kilo 基础角色设定role definition之外的扩展行为、偏好与约束。典型场景包括编码风格缩进宽度、命名规范、是否严格遵循 PEP8 等文档标准注释格式、README 维护要求、API 文档写作规范测试要求单元测试覆盖范围、测试框架选择、测试结构约定工作流指南代码评审流程、提交信息规范、禁止访问的敏感文件。自定义指令的落地方式不是单一入口而是多层叠加从 Settings UI 中每个 Agent 自己的提示词到项目内自动发现的指令文件再到跨项目生效的全局配置最后还有kilo.jsonc中显式引用的补充规则源。VSCode 与 CLI 两个形态都支持这套机制但各自的具体配置入口不同。指令配置的多层来源总览来源作用域位置优先级Agent 提示词按 Agentagent.name.prompt配置或 Agent 定义文件正文1最高Instructions 配置项目项目kilo.jsonc中的instructions键2AGENTS.md项目项目根目录的AGENTS.md3Instructions 配置全局全局kilo.jsonc中的instructions键4Skills两者.kilo/skills/、配置skills键按需加载上层来源的指令可以覆盖下层来源中的冲突内容项目级指令先于全局指令加载并对每个会话生效。VSCode 中的指令配置按 Agent 提示词Per-Agent Prompts每个 Agent 都可以拥有独立的自定义提示词通过设置界面配置打开Settings → Agent Behaviour → Agents子页签选中要定制的 Agent在该 Agent 的prompt字段下的 Markdown 文本区输入指令保存更改。这些提示词会被注入到对应 Agent 的系统提示词system prompt中作用于所有使用该 Agent 的会话。配置解析对应的实现位于 agent 配置插件它会把配置中的system/prompt字段写入 Agent 定义。指令文件Instruction FilesKilo 会在项目根目录及其父目录中自动发现指令文件基于findUp向上查找。以下文件名会被识别AGENTS.md—— Kilo 的主指令文件CLAUDE.md—— 为兼容性而支持CONTEXT.md—— 额外的项目上下文。将任意一个文件放在项目根目录即可为整个项目提供指令。AGENTS.md本质上是为 AI 助手准备的项目 README它随仓库版本管理、可跨多种 AI 编码工具复用详见 agents.md 专题文档。需要留意的是AGENTS.md必须采用全大写文件名且该文件受写保护——Agent 修改它需要显式的用户批准。全局指令Global Instructions当指令需要跨所有项目生效时把AGENTS.md放到全局配置目录Kilo~/.config/kilo/AGENTS.mdClaude 兼容~/.claude/CLAUDE.md直到执行过 Claude Code 迁移。迁移完成后该全局回退机制失效但项目级的CLAUDE.md文件仍可正常工作。项目级指令先于全局指令加载并且适用于每一个会话。在源码中全局指令的读取路径由 Global 服务 提供config目录默认为~/.config/kilo遵循 XDG 约定并可通过KILO_CONFIG_DIR环境变量覆盖。目录级指令Per-Directory Instructions可以在项目的任意子目录放置AGENTS.md。这些文件是动态加载的——当 Agent 的 Read 工具访问该目录下的文件时对应的AGENTS.md才会被发现其内容以system-reminder标签的形式注入到会话上下文中。这一机制非常适合 monorepo 或多模块项目子目录的AGENTS.md无需重复根级指令只需补充该目录任务范围内的特定约束即可例如后端目录强调数据库规范、docs 目录强调文档写作规范。补充指令来源Additional Instruction Sourceskilo.jsonc中的instructions键接受一个指向额外指令文件的路径、glob 通配符或 URL 数组。这些条目可在Settings → Agent Behaviour → Rules子页签中管理# 指令来源示例 instructions: - ./docs/coding-standards.md - ./teams/frontend-rules.md - https://example.com/team-instructions.md关于 URL 型指令URL 指令源在会话启动时抓取超时时间为 5 秒。如果 URL 不可达该指令源会被静默跳过不会中断会话。旧版.kilocoderules支持如果项目里保留了 VSCode 扩展时代的.kilocoderules文件它们仍会通过自动迁移auto-migration被加载。不过对新项目官方推荐迁移到AGENTS.md。CLI 中的指令配置CLI 与 VSCode 的分层思路一致但配置载体是文件Agent 定义文件与kilo.jsonc。按 Agent 提示词Per-Agent Prompts每个 Agent 的自定义提示词可以写在.md文件中作为 Markdown 正文也可以通过kilo.jsonc的agent.name.prompt键指定// kilo.jsonc { agent: { code: { prompt: You are a Python specialist. Follow PEP8 strictly., }, }, }或者以 Markdown 正文形式放在.kilo/agents/code.md--- description: Python specialist --- You are a Python specialist. Follow PEP8 strictly.两种方式注入的是同一个 Agent 系统提示词槽位对所有使用该 Agent 的会话生效。从源码看Agent 定义文件位于agent/agents/**/*.md与mode/modes/*.md会由 config-agent 插件 自动发现并解析Markdown frontmatter 中的元数据字段model、description、permissions 等映射为 Agent 属性正文则作为系统提示词内容。指令文件Instruction Files与 VSCode 相同CLI 会在项目根目录及父目录自动发现以下文件通过findUpAGENTS.md—— 主指令文件CLAUDE.md—— 兼容支持CONTEXT.md—— 额外项目上下文。全局指令Global Instructions跨项目生效的全局AGENTS.md位置Kilo~/.config/kilo/AGENTS.mdClaude 兼容~/.claude/CLAUDE.md直到执行过 Claude Code 迁移。项目级指令先加载全局指令后加载且两者都适用于每个会话。目录级指令Per-Directory Instructions与 VSCode 行为完全一致任意子目录放置AGENTS.md当 Read 工具访问该目录文件时动态发现并注入system-reminder用于为 monorepo 的不同部分提供上下文专属指导。补充指令来源Additional Instruction SourcesCLI 中直接在kilo.jsonc配置instructions数组// kilo.jsonc { instructions: [ ./docs/coding-standards.md, ./teams/frontend-rules.md, https://example.com/team-instructions.md, ], }配置解析层对instructions的完整支持可由 config 测试 佐证——测试中验证了instructions数组同时接受普通路径如CONTRIBUTING.md、glob如.cursor/rules/*.md与 URL如https://example.com/shared-rules.md三种形式。旧版.kilocoderules支持CLI 同样兼容旧版.kilocoderules文件通过自动迁移加载新项目推荐迁移到AGENTS.md。源码级原理指令如何被发现、聚合与注入InstructionContext 系统上下文指令加载的核心实现位于 instruction-context.ts。它注册了一个名为core/instructions的 SystemContext负责把项目与全局的指令文件聚合成一段可注入的文本。核心逻辑在observe函数中instruction-context.ts#L40-L74以当前工作目录为起点、项目根目录为终点stop调用fs.up({ targets: [AGENTS.md], start, stop })向上查找所有AGENTS.md将全局配置目录下的AGENTS.mdjoin(global.config, AGENTS.md)并入结果并去重并发读取这些文件的全部内容组装为File { path, content }列表若某个被发现的文件在读取前消失则整体视为SystemContext.unavailable避免注入不完整指令。查找边界受Location.Service控制只有位于规范项目根目录内的目录才会触发项目指令查找否则跳过对应测试见 instruction-context.test.ts#L293-L322。向上查找fs.up的实现fs.up定义在 fs-util.ts签名如下readonly up: (options: { targets: string[]; start: string; stop?: string }) Effect.Effectstring[], Error它从start开始逐级向上在每个目录层级依次匹配targets中的文件名当前核心实现的目标数组为[AGENTS.md]直到stop为止返回所有命中文件的路径。聚合渲染与动态更新所有被发现的文件通过render函数合并为一段文本instruction-context.ts#L99-L101Instructions from: 文件路径 文件内容文件之间以空行分隔。由于该系统上下文是可观测的当某个AGENTS.md在会话中途被修改或删除时上下文会动态更新内容变化时更新文本为These instructions replace all previously loaded ambient instructions.并携带新内容全部文件被删除时更新文本为Previously loaded instructions no longer apply.这一行为由 instruction-context.test.ts#L32-L110 的实时测试完整验证测试创建全局、项目、子包三层AGENTS.md断言聚合基线顺序为 全局 → 子包 → 项目并验证修改、删除文件后上下文的增量更新。环境变量控制KILO_DISABLE_PROJECT_CONFIG置为非空值可整体关闭项目级指令发现flag.ts#L131-L134对应测试见 instruction-context.test.ts#L258-L291。注意它只禁用项目指令的向上扫描不会影响全局AGENTS.mdKILO_CONFIG_DIR覆盖全局配置目录位置flag.ts#L140-L142可用于将全局AGENTS.md指向自定义路径。与其他指令源的协作AGENTS.md并非唯一的指令来源。instructions配置项目级与全局级、Agent 提示词以及 Skills 会在会话组装时一同参与系统提示词的构建。instructions数组中的条目按配置顺序加载glob 匹配到的文件按文件系统顺序加载项目级指令在冲突时优先于全局指令。若项目中仍存在旧版.kilocode/rules/目录其内容也会为向后兼容而自动包含详见 Custom Rules 文档。实战建议用AGENTS.md承载会随仓库走的规则放入代码风格、架构约束、测试与安全要求随版本库提交保证团队成员与 CI 场景下的行为一致用instructions键承载本地化的规则如团队内部文档、临时约束需要时用 JSONC 的//注释即可暂时禁用某个条目用全局~/.config/kilo/AGENTS.md承载个人偏好例如个人偏好的格式化风格、默认语言习惯这些不该进入团队仓库用目录级AGENTS.md治理 monorepo让每个模块的规则就近维护避免根级文件无限膨胀指令应具体、可验证如限制圈复杂度小于 10优于写出好代码并配合代码示例说明期望模式。相关功能Custom Modes自定义模式Custom Rules自定义规则Settings 管理Auto-Approval 设置赞分享人工智能大模型AI Agent代码智能体工具调用交互助手CLI【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址https://gitcode.com/GitHub_Trending/ki/kilocode点击查看免费下载相关推荐VS Code 自定义指令Custom Instructions完全指南为 AI 编码助手配置项目级与文件级规则VS Code 自定义指令Custom Instructions完全指南为 AI 编码助手配置项目级与文件级规则 自定义指令Custom Instruc文档教程Zed Agent Instructions 机制详解AGENTS.md 与项目指令文件的配置、优先级与底层加载原理Zed Agent Instructions 机制详解AGENTS.md 与项目指令文件的配置、优先级与底层加载原理 本文基于 Zed 官方文档 instru开发工具代码编辑器桌面应用Kilo Code 自定义子代理Custom Subagents完全指南从配置、权限到源码级实现Kilo Code 自定义子代理Custom Subagents完全指南从配置、权限到源码级实现 导读 Kilo Code 的 CLI 与 VS Code人工智能大模型AI Agent代码智能体工具调用交互助手CLI上一篇hCaptcha Challenger 完全指南如何用AI对抗验证码的终极解决方案下一篇libsignal-protocol-javascript密钥管理终极指南IdentityKey与SignedPreKey实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考