规则、技能与工作流
项目与全局自定义规则(instructions 与 .kilo/rules)、Agent Skills 的位置与按需加载,以及用 .kilo/commands 做斜杠命令工作流。
自定义规则
自定义规则让你定义项目专用和全局的行为与约束,确保格式一致、限制对敏感文件的访问、强制执行编码标准,所有模型在与你的项目交互时都会遵循。推荐用 Markdown(标题分类、列表列举约束、代码块示例)。两类:项目规则(仅当前工作区)和全局规则(所有项目)。VS Code 扩展/CLI 里项目规则通过项目 kilo.jsonc 的 instructions 键配置,每项指向一个规则文件(支持 glob),也可以放在 .kilo/rules/ 目录结构里:
{
"instructions": [".kilo/rules/formatting.md", ".kilo/rules/*.md"]
}项目也可以用 AGENTS.md(/init 创建或更新)。官方另有 Custom Instructions 和 Agents.md 页面。
Agent Skills
Kilo Code 实现 Agent Skills 开放格式:技能是含 SKILL.md(元数据加指令)的文件夹,可带脚本、模板和参考材料,在各智能体间互操作、可分享。技能可以是通用的(所有模式可用)或模式专用的(仅在某个模式如 code、architect 下加载)。工作流程:发现(初始化时扫描指定目录,只读取名称、描述和路径);提示包含(模式激活时,相关技能的元数据进入系统提示);按需加载(智能体判断任务匹配某技能描述时,才把完整 SKILL.md 读入上下文)。智能体仅凭 description 判断是否使用——没有关键词匹配或语义搜索,所以描述要写得具体、贴近用户的说法;显式说「use the api-design skill」总是有效。位置:全局 ~/.kilo/skills/(以及默认也会发现的 ~/.agents/skills/<name>/SKILL.md);项目 .kilo/skills/。
工作流(斜杠命令)
工作流(新扩展里称斜杠命令)把重复任务自动化为逐步指令。它们是 Markdown 文件,存放在:全局 ~/.config/kilo/commands/(所有项目),项目 <project>/.kilo/commands/(仅该项目)。创建:写一个带逐步指令的 .md 文件,存到命令目录,在聊天里输入 /文件名(不带 .md)执行,例如 .kilo/commands/submit-pr.md 用 /submit-pr 调用;文件可带 YAML frontmatter。如果 .kilo/commands/ 是指向项目外目录的符号链接,需要在全局 kilo.jsonc 的 permission.markdown_source 里显式允许该来源,项目配置无法授予此权限;外部命令文件仍不受信任({env:...} 替换被阻止,{file:...} 限于项目内)。