用途:在修改已有代码库时,用最小、标准、非侵入的方式完成需求。适用于强调“最小改动”“外科手术式修复”“保留结构”“不要重构”的任务,而非从零构建;也用于抵抗引入新抽象、新框架或大规模重写的冲动。
主要能力与原则:
- 极简与标准优先:用最少代码和最直接方案解决问题,避免过早优化与过度工程;优先标准库和广泛接受的常见模式,仅在任务行业标准或绝对必要时才引入第三方库。
- 直接聚焦需求:只实现用户明确提出的核心请求,不添加未提及的额外功能或边界处理;避免复杂、取巧或晦涩的方案,优先可读性和最短可用路径。
- 外科手术式修改:把现有代码库视为唯一事实来源,尽量保留其结构、风格和逻辑;只改动实现目标所必需的最少代码;仅修改用户明确指定的部分,不对未触及代码做主动重构、清理或风格调整;能集成则不整体替换函数或代码块。
使用方式:探索代码结构时优先使用 Serena MCP 符号工具而非整文件读取,包括 get_symbols_overview、find_symbol、find_referencing_symbols,以减少上下文污染、先精确定位目标并发现现有模式。编辑时优先符号级编辑:insert_before_symbol / insert_after_symbol 添加代码,replace_symbol_body 重写函数实现;仅当编辑函数内小段内容时才用 replace_content(基于文件)。需要外部信息或环境交互时,通过子智能体使用工具并返回带引用的 Context Package,编排者不直接执行调查或数据获取 I/O;被明确要求改代码时,派实现子智能体直接落地小差异。工具使用须与请求直接相关,调用前先简要声明动作与目的。
适用场景与限制:适合小 diff、保持风格、不改无关代码的已有项目维护与修复。限制是它不鼓励重构、新抽象和额外功能,因此不适合需要架构级重写或大范围清理的任务;此外该技能依赖 Serena MCP 等工具时,需相应的工具环境支持。