字数 1557,阅读大约需 8 分钟
🚀 核心功能概览
🎐 AI交互模式矩阵
基础模式
Kilo Code 提供多种专业模式,灵活适配您的需求:
🔧 代码模式
通用型编程任务解决方案
🏗️ 架构师模式
技术规划与系统设计专家
🤔 问答模式
专业技术咨询与知识解答🐞 调试模式
系统性故障诊断专家(Debug解决问题)
✨ 自定义模式
可无限扩展的专属场景方案:
• 安全审计
• 性能优化
• 文档编写
• 及其他任意定制化任务
🔧 协调者模式
Rule配置
自定义规则指南
见官方文档
自定义规则概述
自定义规则是定义项目专属AI行为约束的强大工具,可确保:
✅ 统一代码格式化标准
🔒 限制敏感文件访问
📐 强制执行编码规范
🎯 定制AI行为满足项目需求
规则存放位置(推荐结构)
project/
├── .kilocode/
│ ├── rules/
│ │ ├── formatting.md
│ │ ├── restricted_files.md
│ │ └── naming_conventions.md
├── src/
└── ...
规则加载优先级
1. 通用规则加载顺序:
• 首选
.kilocode/rules/
目录• 次选根目录下(兼容旧版):
.roorules
→.clinerules
→.kilocoderules
2. 模式专属规则:
• 优先加载
.kilocode/rules-${模式名}/
目录• 次选
.kilocoderules-${模式名}
文件
💡 强烈建议使用目录结构
规则编写规范
# 使用Markdown语法编写(推荐)
## 章节标题
- 列表形式声明规则
- 每条规则单独成项
`代码块`展示示例:
```python
def 规范示例():
print("使用4空格缩进")
典型规则示例
🔧 代码风格
# 代码格式化
- 严格使用4空格缩进
- 变量命名采用小驼峰式
- 所有新函数必须包含单元测试
🔐 安全限制
# Restricted files
Files in the list contain sensitive data, they MUST NOT be read
- supersecrets.txt
- credentials.json
- .env
📝 文档规范
# API文档要求
- 每个导出函数需包含JSDoc注释
- 必须包含@param和@return说明
最佳实践
1. 团队协作:将规则文件纳入版本控制,确保团队统一
2. 规则设计:
• 每条规则保持原子性
• 相同类型规则集中管理
• 复杂规则需配示例说明
3. 版本迭代:随项目演进定期更新规则
故障排查
❌ 规则未生效时检查:
1. 文件是否存放在支持的位置
2. Markdown语法是否正确
3. 规则表述是否无歧义
4. 重启IDE加载最新规则
🚀 通过精心设计的自定义规则,您可以让Kilo Code成为项目的智能协作者!
Prompt
提示词工程是一门为 AI 模型(如 Kilo Code)设计高效指令的艺术。精心编写的提示词能带来更优质的结果、减少错误,并提升工作效率。
核心原则
✅ 清晰明确
避免模糊表述,明确任务目标。
✖ 差示例:“修复代码”
✔ 好示例:“修复 calculateTotal 函数中导致返回错误结果的 bug”
✅ 提供上下文
使用 @上下文引用 指定文件、目录或问题。
✔ 好示例:@/src/utils.ts 将 calculateTotal 函数重构为使用 async/await
✅ 任务拆解
将复杂任务分解为小而明确的步骤。
✅ 提供示例
若需特定代码风格或模式,请给出参考示例。
✅ 指定输出格式
如需特定格式(如 JSON、Markdown),请在提示词中说明。
✅ 迭代优化
若初次结果不理想,可调整提示词再次尝试。
"思考-执行"流程
建议引导 Kilo Code 分阶段完成任务:
分析:让 AI 分析当前代码、识别问题或规划方案。
规划:要求 AI 列出任务执行步骤。
执行:逐步实施计划中的每一步。
审查:在继续前仔细检查每一步的结果。
自定义指令
可通过两种方式定制 Kilo Code 行为:
🔹 全局指令:适用于所有模式
🔹 模式专属指令:仅针对特定模式(如代码模式、架构师模式等)
自定义指令用途:
1. 强制代码风格规范
2. 指定首选库或框架
3. 定义项目特定约定
4. 调整 AI 语气或交互风格
(详见 自定义指令 部分)
处理模糊指令
若提示词含糊或信息不足,Kilo Code 可能:
⚠ 自行假设:按最佳猜测执行,结果可能不符预期
⚠ 追问澄清:使用 ask_followup_question 工具请求补充说明
建议:尽量从开始就提供清晰、具体的指令,避免无效来回沟通。
反馈机制
若结果不理想,可通过以下方式优化:
🛑 拒绝操作:点击 “拒绝” 按钮并说明原因,帮助 AI 学习
✍ 重述需求:用更具体的指令重新表述任务
🛠 手动修正:直接修改代码后再接受变更
示例对比
✅ 优质提示词
@/src/components/Button.tsx 将 Button 组件从 useReducer 重构为 useState
创建 utils.py 文件,添加计算列表平均值的 calculate_average 函数
@problems 修复当前文件中的所有错误和警告
❌ 劣质提示词
“修复按钮”
“写点 Python 代码”
“全部修好”
评论区