.kode/agents/reviewer.md

.kode/agents/reviewer.md

【免费下载链接】Kode-AgentKode CLI — Design for post-human workflows. One unit agent for every human & computer task.项目地址: https://gitcode.com/gh_mirrors/ko/Kode-Agent

name: reviewer description: "代码审查专家，专注于代码质量和安全性" tools: ["FileReadTool", "GrepTool", "LspTool"] model: inherit

你是一个严格的代码审查专家。请检查代码中的：

1. 潜在的安全漏洞
2. 性能问题
3. 代码风格不一致
4. 架构设计问题

**代理调用方式：** ```bash # 通过@run语法调用代理 @run-agent-reviewer 请审查src/utils/validation.ts文件

MCP（模型上下文协议）集成

Kode-Agent完全支持MCP协议，可以无缝集成第三方工具和服务：

// MCP工具集成示例 const mcpTools = await getMCPTools(); const allTools = [...getAllTools(), ...mcpTools];

支持的MCP服务器类型：

• stdio服务器：本地进程通信
• SSE服务器：HTTP流式传输
• WebSocket服务器：双向实时通信

实战应用场景详解

代码审查与重构工作流

# 1. 代码审查 kode "请审查src/components/Button.tsx，找出潜在问题" # 2. 自动修复 kode "根据审查结果，修复所有发现的问题" # 3. 测试验证 kode "为修复后的代码添加单元测试"

审查结果示例输出：

✅ 代码结构良好 ⚠️ 发现3个潜在问题： 1. 缺少错误边界处理（第45行） 2. 性能优化建议（第78行） 3. TypeScript类型不严格（第102行） 🔧 已自动修复问题1和3，问题2需要手动优化

项目初始化与配置

# 创建新项目 kode "初始化一个TypeScript + React项目，包含ESLint、Prettier和Jest" # 配置开发环境 kode "设置.gitignore、README.md和package.json脚本" # 添加核心依赖 kode "安装React Router、Axios和Tailwind CSS"

数据库迁移与数据操作

# 生成数据库迁移脚本 kode "为users表添加email_verified字段，生成SQL迁移文件" # 数据批量处理 kode "将CSV文件users.csv导入到PostgreSQL数据库" # 查询优化 kode "分析这个SQL查询的性能瓶颈并提供优化建议"

高级配置与自定义指南

权限系统配置

Kode-Agent提供灵活的权限控制，平衡安全性与开发效率：

// ~/.kode/permissions.json { "permission_mode": "permissive", "rules": [ { "tool": "BashTool", "pattern": "npm run *", "action": "auto_approve" }, { "tool": "FileEditTool", "pattern": "src/**/*.ts", "action": "ask" }, { "tool": "FileWriteTool", "pattern": "*.json", "action": "auto_approve" }, { "tool": "FileWriteTool", "pattern": "*.env*", "action": "deny" } ] }

权限模式对比：

自定义命令开发

开发者可以创建自定义命令，扩展Kode-Agent的功能：

自定义命令示例：

# .kode/commands/deploy.md --- name: deploy description: "部署应用到生产环境" tools: ["BashTool", "FileReadTool"] --- 执行生产环境部署流程： 1. 运行测试套件 2. 构建生产版本 3. 执行数据库迁移 4. 重启服务 5. 验证部署状态

调用自定义命令：

# 使用斜杠命令调用 /deploy staging # 或直接描述任务 kode "部署到生产环境"

技能市场集成

Kode-Agent支持从技能市场安装预构建的技能：

# 安装Vercel技能包 npx add-skill vercel-labs/agent-skills -a kode # 管理已安装技能 kode plugin list kode plugin install @skill/database kode plugin remove @skill/legacy

性能优化与最佳实践

上下文管理策略

Kode-Agent采用智能的上下文管理机制，确保AI模型获得最相关的信息：

上下文注入策略：

1. 项目文档优先：自动读取AGENTS.md、CLAUDE.md等文档
2. Git状态感知：包含最近的提交和变更状态
3. 目录结构分析：理解项目组织架构
4. 会话历史记忆：保留相关对话上下文

// 上下文管理核心逻辑 const contextManager = { async injectContext(prompt: string, projectPath: string) { const contexts = []; // 1. 项目文档 contexts.push(await readProjectDocs(projectPath)); // 2. Git状态 contexts.push(await getGitStatus(projectPath)); // 3. 文件结构 contexts.push(await analyzeDirectoryStructure(projectPath)); // 4. 会话历史 contexts.push(await getRelevantHistory(prompt)); return contexts.join('\n\n'); } };

工具执行优化

异步生成器模式：所有工具都使用异步生成器，支持实时进度更新和取消操作：

// 工具执行流程优化 async function* executeTool(tool: Tool, input: any, context: ToolUseContext) { // 1. 输入验证 const validated = await validateInput(tool, input); // 2. 权限检查 const hasPermission = await checkPermissions(tool, input, context); if (!hasPermission) { yield { type: 'permission_denied', message: '权限不足' }; return; } // 3. 执行并实时更新 for await (const result of tool.call(input, context)) { if (result.type === 'progress') { yield { type: 'progress', data: result.content }; } else if (result.type === 'result') { yield { type: 'complete', data: result.data }; } } }

缓存策略设计

Kode-Agent实现了多层缓存系统，提升响应速度：

扩展开发与二次开发

自定义工具开发指南

创建新工具只需实现标准接口：

// 自定义数据库查询工具示例 import { defineTool } from '@core/tools/defineTool'; import { z } from 'zod'; export const DatabaseQueryTool = defineTool({ name: 'DatabaseQuery', description: '执行SQL查询并返回结果', inputSchema: z.object({ query: z.string().describe('SQL查询语句'), database: z.string().optional().describe('数据库名称'), parameters: z.array(z.any()).optional().describe('查询参数'), }), async prompt() { return `你是一个数据库查询工具。请提供SQL查询语句和必要的参数。`; }, isReadOnly: () => true, async *call(input, context) { try { // 连接数据库 const connection = await connectToDatabase(input.database); // 执行查询 yield { type: 'progress', content: '正在执行查询...' }; const result = await connection.query(input.query, input.parameters); // 格式化结果 yield { type: 'result', data: { rows: result.rows, rowCount: result.rowCount, fields: result.fields, } }; } catch (error) { throw new Error(`查询失败: ${error.message}`); } }, renderResultForAssistant(output) { return `查询结果：${output.rowCount} 行数据`; }, });

插件系统集成

Kode-Agent支持插件化扩展，可以通过插件添加新功能：

插件结构示例：

my-kode-plugin/ ├── package.json ├── src/ │ ├── index.ts # 插件入口 │ ├── tools/ # 自定义工具 │ ├── commands/ # 自定义命令 │ └── services/ # 服务集成 └── README.md

插件注册机制：

// 插件注册接口 interface KodePlugin { name: string; version: string; tools?: Tool[]; commands?: Command[]; services?: Service[]; onActivate?: (context: PluginContext) => Promise<void>; onDeactivate?: () => Promise<void>; }

安全架构与最佳实践

多层安全防护

Kode-Agent采用深度防御策略，确保系统安全：

1. 输入验证层：

// Zod模式验证 const commandSchema = z.object({ command: z.string() .min(1) .max(1000) .regex(/^[a-zA-Z0-9\s\-_\.\/]+$/) .describe('要执行的命令'), args: z.array(z.string()).optional(), });

2. 权限检查层：

// 权限检查逻辑 async function checkBashPermission(command: string, context: ToolUseContext) { // 检查命令是否在安全列表中 if (isSafeCommand(command)) return true; // 检查用户是否已授权 if (hasUserPermission(command)) return true; // 请求用户确认 return await requestUserConfirmation(command); }

3. 沙箱执行层：

// 命令沙箱执行 async function executeInSandbox(command: string, cwd: string) { const sandbox = await createSandbox({ network: false, // 禁用网络 filesystem: 'read', // 只读文件系统 env: sanitizedEnv, // 净化环境变量 }); return await sandbox.exec(command, { cwd }); }

安全模式配置

# 启用安全模式（推荐用于生产环境） kode --safe # 配置安全规则 kode config set security.level high kode config set security.auto_approve false kode config set security.timeout 30

性能基准测试

通过实际测试，Kode-Agent在不同场景下的性能表现：

未来发展方向

短期路线图（3-6个月）

1. 增强的代码理解能力

   • 支持更多编程语言和框架
   • 改进代码重构建议
   • 添加架构模式识别

2. 团队协作功能

   • 共享代理配置
   • 协作代码审查
   • 团队知识库集成

3. 性能优化

   • 更快的上下文加载
   • 智能缓存策略
   • 并行工具执行

中期规划（6-12个月）

1. AI模型深度集成

   • 本地模型支持
   • 模型微调接口
   • 多模型协同推理

2. 开发工作流自动化

   • CI/CD流水线集成
   • 自动化测试生成
   • 部署监控一体化

3. 生态系统扩展

   • 插件市场
   • 第三方服务集成
   • 企业级功能

结语：AI终端助手的未来

Kode-Agent代表了AI辅助开发的未来方向——将复杂的开发任务转化为自然的对话交互。通过其创新的工具化架构、多模型协作系统和强大的扩展能力，Kode-Agent不仅提升了开发效率，更重新定义了开发者与工具的交互方式。

核心价值总结：

• 🚀开发效率革命：将复杂任务从小时级降至分钟级
• 🛡️安全与可控：多层权限控制，平衡效率与安全
• 🔌无限扩展：工具化架构支持任意功能扩展
• 🤝智能协作：多模型协同，发挥各自优势
• 📊透明可控：完整的过程可见性和控制权

无论你是个人开发者寻求效率提升，还是团队领导者希望统一开发流程，Kode-Agent都提供了强大而灵活的解决方案。其开源特性确保了社区的持续创新，而企业级的架构设计保证了系统的稳定性和可靠性。

开始使用Kode-Agent：

# 安装 npm install -g @shareai-lab/kode # 快速开始 kode "帮我分析这个项目的架构"

【免费下载链接】Kode-AgentKode CLI — Design for post-human workflows. One unit agent for every human & computer task.项目地址: https://gitcode.com/gh_mirrors/ko/Kode-Agent