多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

Claude Code 系统提示词解析:/simplify 在 Agent 工具不可用时的内联单趟清理模式

Claude Code 系统提示词解析:/simplify 在 Agent 工具不可用时的内联单趟清理模式 文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读本文深入剖析claude-code-system-prompts仓库中的 Agent Prompt: /simplify unavailable-agent inline mode621 tokens——这是 Claude Code/simplify命令在Agent 工具subagent 扇出机制不可用时启用的降级提示词。它要求模型在同一上下文内、单趟完成对改动代码的复用性Reuse、简化Simplification、效率Efficiency与抽象层次Altitude四维清理评审并直接落地修复。读完本文你将理解常规/simplify的 4-Agent 并行扇出模型如何工作、工具不可用时内联模式如何保持同等质量、其与/code-review的职责边界以及降级模式必须遵循的自我披露纪律。一、背景/simplify 的两套运行形态在 Claude Code 中/simplify是面向代码质量清理的斜杠命令与面向正确性缺陷的/code-review形成互补。仓库 README 对二者的定位给出了明确索引Agent Prompt: /simplify slash command362tks——Instructions for the /simplify slash command that reviews changed code for reuse, simplification, efficiency, and altitude cleanups, then applies the fixes常规形态4 个清理 Agent 并行Agent Prompt: /simplify unavailable-agent inline mode621tks——Runs the /simplify cleanup workflow inline across reuse, simplification, efficiency, and altitude angles when the Agent tool is unavailable降级形态本文主角。根据 CHANGELOG.md 的 v2.1.213 版本记录# [2.1.213]一节内联模式是作为一项新增能力引入的NEW:Agent Prompt: /simplify unavailable-agent inline mode — Adds a single-pass fallback that reviews changed code for reuse, simplification, efficiency, and abstraction-level issues, applies safe cleanup fixes, and discloses that the normal four-agent fan-out was unavailable.即该模式在 Agent 工具缺失时仍以单趟方式覆盖四个清理角度应用安全的清理修复并披露常规的 4-Agent 扇出未能执行。两份提示词均以ccVersion: 2.1.213标注版本属于同一发布周期的配套产物。二、职责边界清理而非查错两份/simplify提示词的开篇都给出了同一句硬性定位这是理解整个模式的前提You are improving the quality of the changed code, not hunting for bugs. Review it for reuse, simplification, efficiency, and altitude issues, then fix what you find. Do not look for correctness bugs — that is what/code-reviewis for.翻译并拆解为三条纪律目标不是抓 bug/simplify改善的是改动代码的质量而非正确性四个审查维度复用性、简化、效率、抽象层次altitude明确的分工边界正确性缺陷属于/code-review的范畴。仓库中 agent-prompt-code-review-unavailable-agent-inline-mode.md 即对应/code-review在相同降级场景下的内联实现Builds a single-pass inline code-review prompt ... when the Agent tool is unavailable二者一清一查共同构成工具不可用时的完整兜底矩阵。此外CHANGELOG v2.1.213 还记录了配套调整/code-review的 medium-/high-/extra-high-/maximum-effort 各模式中原本注入的 reuse、simplification、efficiency、altitude、conventions 清理角度被移出正确性审查提示词——进一步印证清理归 /simplify、查错归 /code-review的架构取向避免两类提示词职责重叠。三、触发条件与降级逻辑内联模式文档首行的流程标签定义了其触发链路/simplify → ${AGENT_TOOL_NAME} tool unavailable → single-pass inline cleanup → apply the fixes结合文档正文中的变量与说明可以还原完整的决策逻辑模板变量AGENT_TOOL_NAME是 Agent 工具的真实名称在 Claude Code 中即Task/Agent工具由上层系统在渲染提示词时注入当该工具在当前上下文不可用时常规的4-agent fan-out4 个独立清理 Agent 并行扇出无法运行提示词明确要求Work through all four angles below yourself, in this same context, in one pass — do not skip an angle for lack of fan-out在同一上下文、单趟自行走完四个角度不得因缺少扇出而跳过任一角度。这条禁止因降级而偷工减料的约束是该模式的核心设计意图工具降级 ≠ 质量降级四个审查角度必须一个不少地内联完成。与常规形态的对照在 agent-prompt-simplify-slash-command.md 的常规形态中Phase 1 的指令是Launch4 independent review agentsvia the ${AGENT_TOOL_NAME} tool, all in a single message so they run concurrently. Pass each agent the diff and one of the four angles below.即常规模式通过单条消息并发启动 4 个独立 Agent各自携带 diff 与四个角度之一分别由REUSE_FINDER_ANGLE_BLOCK、SIMPLIFICATION_FINDER_ANGLE_BLOCK、EFFICIENCY_FINDER_ANGLE_BLOCK、ALTITUDE_FINDER_ANGLE_BLOCK四个变量注入对应角度块。而内联模式将同样的四角度逻辑改为顺序、自审执行变量REUSE_GUIDANCE、SIMPLIFICATION_GUIDANCE、EFFICIENCY_GUIDANCE、ALTITUDE_GUIDANCE承载各角度的详细指导。四、Phase 1 — 四角度单趟评审内联模式的 Phase 1 要求对 diff 逐一对照四个角度进行审查并为每个发现记录结构化字段file文件line行号一行summary概要具体代价concrete cost——即重复了什么、浪费了什么、什么变得更难维护要求记录代价而非仅描述现象是为了让后续的修复决策Phase 2有量化的取舍依据。四个角度由模板变量注入详细指导其主题语义如下角度关注点典型信号结合代价语义推断Reuse复用重复逻辑是否可抽取复用相似代码块多次出现维护成本随副本数线性上升Simplification简化是否有过度复杂、可更直白的实现冗余分支、绕路写法、不必要的抽象Efficiency效率是否存在浪费的计算或资源重复计算、多余遍历、可避免的 I/OAltitude抽象层次抽象层级是否恰当过高/过低在错误层次暴露细节、层次错位的封装需要说明四个角度的具体指导文本以REUSE_GUIDANCE等变量注入其完整实体位于上游系统的渲染层本仓库仅承载提示词骨架与变量占位符但从角度命名、README 描述reuse, simplification, efficiency, and altitude cleanups及 CHANGELOGabstraction-level issues可以确认其语义范围。五、Phase 2 — 去重、修复与跳过Phase 2 的指令同样清晰包含三个步骤去重Dedup将指向同一行或同一机制的发现合并直接修复对剩余每条发现直接落地修改跳过Skip若某条发现的修复会改变预期行为、需要大幅超出本次 diff 范围的改动或被判定为误报false positive则跳过——但必须记录跳过原因note the skip而不是与之争论。这一安全修复原则与 CHANGELOG 的描述applies safe cleanup fixes完全一致清理修复以不改变行为、不越界、不误伤为前提宁可跳过也不冒险破坏功能。常规形态的 Phase 2 还多一步Wait for all four agents to complete等待四个 Agent 全部完成后才合并结果内联模式则因自审自修而无需此步。六、收尾结果汇报与自我披露Phase 2 结束后提示词要求给出简短总结修复了什么、跳过了什么若代码本就干净则明确确认already clean明确声明本次是未使用 Agent 工具的 single-pass 评审而非完整的 4-agent fan-out——so whoever reads it isnt misled about what actually ran。最后这一点是内联模式最具工程价值的设计降级运行必须自我披露。它防止下游读者如审查者、后续维护者将内联单趟结果误认为经过 4 个独立 Agent 并发交叉验证的完整结论从而避免对评审覆盖度产生错误预期。这一披露纪律与 /code-review 内联模式 中的explicit disclosure that no subagent verification ran如出一辙可见是 Claude Code 降级提示词的通用设计规范。七、模板变量与渲染机制该提示词文件头部 YAML frontmatter 声明了 7 个模板变量理解它们有助于把握提示词的复用方式变量作用AGENT_TOOL_NAMEAgent 工具的真实名称用于表述工具不可用与未使用该工具DIFF_GATHERING_PHASEdiff 采集阶段文本插入 Phase 1 之前负责定义如何获取待评审改动REUSE_GUIDANCEReuse 角度的具体评审指导SIMPLIFICATION_GUIDANCESimplification 角度的具体评审指导EFFICIENCY_GUIDANCEEfficiency 角度的具体评审指导ALTITUDE_GUIDANCEAltitude抽象层次角度的具体评审指导可见该文件本质是一个可组合的提示词模板同一份骨架可以随变量注入内容的不同适配不同的 diff 来源与角度指导版本。这也是本仓库All parts of Claude Codes system prompt定位的体现——每个提示词文件都是 Claude Code 某个版本系统提示词的可追溯构件。八、适用前提与限制适用场景Agent 工具在当前上下文如子代理深度上限、受限会话不可用但仍需对改动代码执行清理评审时。质量等价性内联模式通过禁止跳过角度约束保证四维覆盖但其发现未经独立 Agent 交叉验证覆盖度与置信度低于常规 4-Agent 扇出这也是强制披露声明的根本原因。职责边界不要用/simplify替代/code-review正确性缺陷的排查必须走 code-review 系列提示词。版本基准本仓库该文件标注ccVersion: 2.1.213与 CHANGELOG.md 的 v2.1.213 记录对应如需确认更早或更新版本的差异可对照 CHANGELOG 的时间线阅读。结语/simplify unavailable-agent inline mode是 Claude Code 提示词工程中优雅降级的典型样本在核心扇出机制缺失时通过内联单趟 四角度全覆盖 安全修复 强制披露四重设计在单上下文内尽力还原清理质量同时诚实标注运行方式的差异。对于研究 Agent 提示词设计、或希望理解 Claude Code 工具可用性如何影响系统提示词编排的读者这份 621-token 的文档与它的常规形态 agent-prompt-simplify-slash-command.md 是对照阅读的最佳起点。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude 3.7 Sonnet 全量系统提示词拆解Anthropic 多工具 Agent 的提示词工程解剖Claude 3.7 Sonnet 全量系统提示词拆解Anthropic 多工具 Agent 的提示词工程解剖 导读...文档知识库深入解析 Tabby Agent 内联编辑 Insert 模式的系统提示词模板edit-command-insert.md深入解析 Tabby Agent 内联编辑 Insert 模式的系统提示词模板edit command insert.md 导读 本文以 Tabby 自托管人工智能大模型本地部署模型推理服务后端RAG交互助手Claude CodeClaude Opus 4.8系统提示词深度拆解主 Agent 指令、子代理、技能与 32 个工具契约全解析Claude CodeClaude Opus 4.8系统提示词深度拆解主 Agent 指令、子代理、技能与 32 个工具契约全解析 本文以开源仓库 sys文档知识库上一篇如何用象棋AI辅助工具在3分钟内获得大师级棋局分析下一篇3分钟掌握Vin象棋AI视觉分析让你的棋力瞬间翻倍 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表