qwen-code /simplify 技能深度解析基于并行审查的代码简化清理工作流【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code/simplify是 qwen-code 内置bundled的一项代码清理技能用于在编码任务收尾后对最近的改动执行一次结构化的简化清理先并行跑三路只读代码审查复用性、质量、效率再直接落地低风险的改进最后做针对性验证。本文将以 SKILL.md 为骨架结合 qwen-code 技能系统的源码实现完整讲解它的调用方式、五步工作流、并行 subagent 设计背后的原因以及技能加载与权限授予的底层机制读完即可在自己的项目里正确使用并深入理解它。一、simplify 是什么、何时用、怎么调用从 SKILL.md 的 frontmatter 可以看到该技能对自己的定位非常明确Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup improvements.它面向三类典型场景实现后的清理收尾post-implementation cleanup passPR 提交前的打磨pre-PR polish用户主动要求简化/精炼最近改动simplify/refine recent changes。与只评论不改的审查不同simplify 的最终目标是安全地改进代码——它不只是输出意见而是会把低风险的清理直接落地。调用方式有两种在交互界面输入/simplify对最近改动执行默认三路审查输入/simplify focus在默认审查维度之外将附加指令作为额外的审查重点例如performance、duplication、rendering、API clarity、testability、naming consistency详见第七节。二、frontmatter 剖析技能元数据与 allowedTools 权限simplify 的 SKILL.md 顶部是一段 YAML frontmatter这是 qwen-code 技能系统的标准元数据格式--- name: simplify description: Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup improvements. Use when the user wants a post-implementation cleanup pass, pre-PR polish, or asks to simplify/refine recent changes. Invoke with /simplify or /simplify focus. allowedTools: - agent - run_shell_command - grep_search - read_file - write_file - edit - glob ---其中name与description为必填项缺一不可。从 skill-load.ts 的解析实现看frontmatter 通过正则^---\n([\s\S]*?)\n---切分随后用 YAML 解析器提取字段name会经过 validateSkillName 校验必须匹配SKILL_NAME_PATTERN/^[\p{L}\p{N}_:.-]$/u即只允许字母、数字、下划线、冒号、点、连字符因为技能名会流入available_skills描述、SkillTool schema 枚举、路径激活提醒等多个可信上下文。allowedTools 的语义会话级自动放行allowedTools是本技能最值得深究的字段。根据 types.ts 中SkillConfig.allowedTools的注释它的语义是每一项都是权限规则字符串语法与settings.json中permissions.allow完全一致例如Bash(git *)、Edit、Read、mcp__server__tool当技能被调用通过模型的 Skill-tool 或用户的/skill斜杠命令时每一条都会被添加为会话级 allow 规则匹配的工具调用会被自动批准不再弹出确认它是纯增量授权永远不会隐藏或限制模型可见的工具。即使某个工具被settings.tools.eager白名单遗漏也只是保持延迟注册可通过tool_search加载并不会因为这条授权而改变注册状态格式非法的条目会被静默忽略。simplify 声明的 7 个工具恰好覆盖了它的完整工作流agent启动三个并行审查子代理、run_shell_command执行 git 命令与验证命令、grep_search与glob仓库级搜索、确认删除代码无残留调用者、read_file读 diff 与源码、write_file与edit落地清理修改。这也是它既审查又动手的能力基础。三、Step 1精确界定审查范围review scopesimplify 的第一步不是直接看代码而是先用 git 状态确定要审查哪些文件判定顺序层层递进先检查当前 git 状态优先使用以下命令之一按推荐顺序git diff --name-only、git diff --staged --name-only、git diff HEAD --name-only、git diff、git diff HEAD、git status --short若存在暂存staged改动一律以git diff HEAD为基准确保暂存与未暂存的已跟踪改动都被纳入否则审查当前未提交的 diffgit diff若没有 git diff回退到git ls-files --modified --others --exclude-standard——这个命令的关键在于--exclude-standard会让结果尊重.gitignore从而把构建产物、node_modules等被忽略的路径挡在清理范围之外若仍为空回退到本会话中编辑过的文件若依旧无法确定有意义的范围停止并告知用户没有可简化的近期改动。这一步的意义在于清理必须作用在真实改动上而不是把整个仓库拖下水。从实现角度看这正是git diff家族命令与ls-files组合使用的典型模式确保范围可复现、可验证。四、Step 2并行启动三路只读审查范围确定后simplify 通过agent工具在同一条响应中一次性发起三个审查 pass让它们并发运行。每个 pass 都收到相同的审查范围与 diff 命令各自只读地检查与自己维度相关的文件输出 findings不修改任何文件所有修改都留到 Step 4。三路 pass 的分工如下。Pass 1代码复用审查Code Reuse Review寻找减少重复、复用既有代码的机会应该复用但没复用的现有工具函数/helper新代码中引入的重复逻辑应该委托给既有抽象的内联逻辑项目已有对应工具时仍然临时手写的 string/path/env/parsing/类型检查 helper。Pass 2代码质量审查Code Quality Review寻找可维护性问题应该统一的复制粘贴变体参数泛滥或别扭的 API冗余状态或多余间接层抽象泄漏应该被更清晰建模的 stringly-typed字符串化类型代码不必要的嵌套只解释做了什么而没解释为什么的多余注释与周边代码风格不一致的命名或结构。Pass 3效率审查Efficiency Review寻找浪费性工作与不必要开销可以 memoize、缓存或删除的重复计算可以安全并行的串行工作不必要的扫描、分配、读取或遍历热点路径上的阻塞操作冗余的 no-op 更新过宽的操作本可用更窄的操作完成引入 TOCTOU 式浪费或风险的先检查存在性再操作模式。关键约束为什么必须用 general-purpose 且禁止 forkSKILL.md 对这三个 agent 调用做了硬性规定并用加粗强调必须设置subagent_type: general-purpose必须设置run_in_background: false——每个 pass 必须内联返回 findingsStep 3 才能聚合绝不使用subagent_type: fork——fork 是 fire-and-forget即发即忘不会返回 findingsStep 3 将无内容可聚合。从仓库中其他技能的实践看general-purposerun_in_background: false是 qwen-code 内置技能中并行 worker 的通用模式例如 batch/SKILL.md 同样要求 worker 使用general-purpose并设置run_in_background: false使结果内联返回。simplify 的三个 pass 是审查-聚合-修改三段式中的输入侧必须同步拿到全部 findings 才能进入聚合这正是该约束存在的根本原因。五、Step 3聚合 findings 并排序等三路 pass 全部结束后simplify 合并重叠的 findings并按照以下标准给修复排序优先处理低风险局部作用域与现有项目模式明显一致容易用测试或针对性命令验证。同时有一条重要红线如果某项清理需要投机性的架构改动就不要强行执行。这一步保证了 simplify 是保守的清理者而非激进的重构者与它directly apply straightforward cleanup improvements的定位一致。六、Step 4 与 Step 5落地改进与验证Step 4直接实施安全的清理改进可自动修复的典型例子包括用既有 helper 替换重复逻辑删除冗余代码——但前提是已做仓库级搜索、确认没有剩余调用者这正是grep_search/glob工具被列入 allowedTools 的原因简化条件判断或控制流收紧循环或重复工作减少不必要的状态或包装代码删除低价值注释让代码与附近约定对齐。对于不确定、有风险或过于侵入的条目直接跳过不在被否决的 findings 上浪费时间辩论。Step 5验证清理结果修改完成后按以下顺序验证改动区域存在测试时运行聚焦测试运行能识别到的、覆盖所改动代码的相关项目质量检查若无适用测试至少运行覆盖被编辑文件的针对性 build、typecheck 或 lint。simplify 明确偏好针对性验证而非全仓命令——除非项目只暴露仓库级检查。这与 Step 3 的易验证优先级形成闭环低风险 局部 可验证是每个自动修复被采纳的前提。七、Additional focus用参数注入自定义审查重点SKILL.md 最后一部分说明如果用户在/simplify后附加了额外指令例如/simplify performance这些指令会被当作额外的审查重点与默认三个维度同等优先。原始调用文本会在技能运行时被注入用于提取诸如性能、重复、渲染、API 清晰度、可测试性、命名一致性等关注点。这意味着 simplify 不是封闭的固定流程而是一个可扩展的审查框架。八、底层机制技能如何被发现、加载与授予权限理解 simplify 的定位还需要知道它在技能系统中的位置。技能层级与加载优先级simplify 位于 packages/core/src/skills/bundled/simplify/属于bundled层级随 qwen-code 内置分发。技能共有四种层级见 types.tsproject项目.qwen/skills/、user用户~/.qwen/skills/、extension扩展提供、bundled内置。skill-manager.ts 中loadSkill的查找顺序是project → user → extension → bundledbundled 优先级最低——同名技能可以被项目级或用户级覆盖。测试 skill-manager.test.ts 验证了相关行为bundled 技能会被listSkills正确加载并标记level: bundled当配置了disabledSkillLevels: [bundled]时整个 bundled 层被跳过、loadSkill(simplify)返回 null且不会扫描 bundled 目录同名技能按 project/user 优先级去重而 simplify 因无同名冲突会与去重后的 review 技能共存。斜杠命令的注册在 CLI 侧SkillCommandLoader.ts注意其实际路径为packages/cli/src/services/SkillCommandLoader.ts会把用户级、项目级、扩展级技能加载为斜杠命令bundled 技能同样可通过/skill-name触发且受slashCommands.disabled全局禁用列表约束。因此simplify既是模型可通过 SkillTool 调用的能力也是用户可手动触发的斜杠命令。技能的查看与管理查看内置技能源码直接阅读 packages/core/src/skills/bundled/ 目录下各子目录的SKILL.mdsimplify 所在目录当前仅含 SKILL.md 一个文件技能的整体架构与契约可参考 skill-manager.ts、skill-load.ts 以及 types.ts想深入了解 qwen-code 技能系统的设计演进可参阅 docs 下的相关设计文档例如 skills-default-disabled、daemon-skill-toggle、workspace-skills-read-model 与 auto-skill-curator。九、与 review 技能的定位差异仓库中还内置了功能相近的 review 技能二者容易混淆值得厘清review侧重审面向 PR/变更做系统性评审输出评审结论其设计文档 review/DESIGN.md 还包含对 subagent 工具面开销的实测分析并明确说明general-purpose不是它的替代品——因为general-purpose不声明工具列表每个子代理会继承并重复声明会话的完整工具面simplify侧重简目标是把低风险的清理直接落地其三个 pass 使用general-purpose是刻意选择——pass 只需只读审查工具面开销可接受真正的修改由主代理在 Step 4 统一执行因此不需要为审查子代理裁剪专用工具集。两者互补review 发现问题、给出结论simplify 直接动手清理低风险项共同构成实现 → 清理 → 评审的开发闭环。十、小结/simplify是 qwen-code 内置技能体系中结构化清理的代表以 git diff 精确圈定范围以三个并行的general-purpose子代理分别审查复用性、质量与效率以低风险、局部、可验证为标准聚合排序最终直接落地改进并通过聚焦测试验证。它的 frontmatter 设计allowedTools会话级增量授权、加载优先级project → user → extension → bundled与斜杠命令注册机制均由 types.ts、skill-load.ts、skill-manager.ts 与 SkillCommandLoader.ts 中的源码与测试一一印证。对开发者而言理解这一技能不仅是学会一条斜杠命令更是掌握了一种先并行审查、再保守落地、后针对性验证的可复用代码清理方法论。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考