.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-Agentname: reviewer description: 代码审查专家专注于代码质量和安全性 tools: [FileReadTool, GrepTool, LspTool] model: inherit你是一个严格的代码审查专家。请检查代码中的潜在的安全漏洞性能问题代码风格不一致架构设计问题**代理调用方式** 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 } ] }权限模式对比模式安全性便利性适用场景Permissive中高个人开发、快速原型Safe高中生产环境、团队协作Strict最高低敏感项目、安全审查自定义命令开发开发者可以创建自定义命令扩展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模型获得最相关的信息上下文注入策略项目文档优先自动读取AGENTS.md、CLAUDE.md等文档Git状态感知包含最近的提交和变更状态目录结构分析理解项目组织架构会话历史记忆保留相关对话上下文// 上下文管理核心逻辑 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实现了多层缓存系统提升响应速度缓存层级缓存内容过期策略性能提升内存缓存最近的文件读取5分钟40-60%模型响应AI生成的内容会话期间30-50%工具发现MCP工具列表1小时20-40%配置缓存用户设置重启时15-30%扩展开发与二次开发自定义工具开发指南创建新工具只需实现标准接口// 自定义数据库查询工具示例 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) Promisevoid; onDeactivate?: () Promisevoid; }安全架构与最佳实践多层安全防护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在不同场景下的性能表现任务类型传统方式耗时Kode-Agent耗时效率提升代码审查15-30分钟2-5分钟70-85%项目初始化30-60分钟5-10分钟80-85%数据库迁移20-40分钟3-8分钟75-85%调试分析10-25分钟1-3分钟85-90%文档生成15-30分钟2-4分钟80-85%未来发展方向短期路线图3-6个月增强的代码理解能力支持更多编程语言和框架改进代码重构建议添加架构模式识别团队协作功能共享代理配置协作代码审查团队知识库集成性能优化更快的上下文加载智能缓存策略并行工具执行中期规划6-12个月AI模型深度集成本地模型支持模型微调接口多模型协同推理开发工作流自动化CI/CD流水线集成自动化测试生成部署监控一体化生态系统扩展插件市场第三方服务集成企业级功能结语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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考