浅谈 SKILL 研发的最佳实践——以百补详情助手为例
AI 前沿· 5 分钟阅读0 阅读
本文以百亿补贴详情助手 Skill 的迭代历程为例，总结 Skill 研发与迭代实践。文章先梳理业界方法论——Claude Skills 的渐进式披露与控制调优、MiniMax 的工
<div class="detail-content-box has-mask large">
<section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><span style="'font-weight:"><span style="letter-spacing: 1px;"></span></span><section style="'-webkit-tap-highlight-color:"><section style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px 1px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;width: 677px;display: flex;justify-content: flex-start;align-items: center;flex-direction: column;visibility: visible;"><section style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;letter-spacing: 0.544px;width: 675px;display: grid;grid-template-columns: 26px auto;visibility: visible;"><section style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px 0px 0px 7px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;display: flex;justify-content: flex-start;align-items: center;visibility: visible;"><section style="-webkit-tap-highlight-color: transparent;margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;width: 635px;height: 1px;border-top: 1px solid rgb(58, 92, 244);align-self: flex-end;visibility: visible;text-align: justify;line-height: 1.75em;"></section></section></section><section style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 7px 14px 9px 19px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;width: 675px;text-align: left;border-bottom: 1px solid rgb(58, 92, 244);visibility: visible;"><section><p style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span style="letter-spacing: 1px;font-size: 15px;"><span style="'font-family:"><span style="'font-family:"><span style="'font-family:"><span style="'font-family:"><span style="'font-family:"><span style="letter-spacing: 1px;">本文以百亿补贴详情助手 Skill </span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><span style="'box-sizing:"><span><span style="letter-spacing: 1px;">的迭代历程为例，总结 Skill 研发与迭代实践。文章先梳理业界方法论——Claude Skills 的渐进式披露与控制调优、MiniMax 的工业化规范、以及常见的 Skill 设计模式；随后从</span><span style="letter-spacing: 1px;font-weight: bold;">架构设计、研发效能、运行优化</span></span></span></span></span></span></span></span></span><span style="'font-family:"><span style="letter-spacing: 1px;"> </span></span><span style="'font-family:"><span style="letter-spacing: 1px;">3 个维度展开详细介绍了桥接器解耦本地 Skill 与远程 Agent、按需共享上下文、优先输出优质 HTML 报告等高效实践，帮助读者提高 Skill 研发效能。</span></span></span></p></section></section></section></section><section style="'-webkit-tap-highlight-color:"><span><br/></span></section><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><img src="https://pic.imgdb.cn/i/034BIJTB0hCGdHXrRoOAg2.png" alt="图片" class="rich_pages wxw-img" style="'-webkit-tap-highlight-color:"/></span></span></section><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><span style="'-webkit-tap-highlight-color:">背景</span></span></h2></section></section><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;text-indent: 0px;"><span><br/></span><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="font-size: 15px;"><span style="'font-family:"><span><span style="letter-spacing: 1px;">自从 Skill 概念被 Anthropic 提出，我所在的团队已开发 50+ Skill，涵盖补贴查询/创建/分析、舆情分析、频道巡检、智能圈品、素材生成、代码助手、商品诊断等场景。这一路做下来，我们也读了大量讲 Skill 最佳实践的文章和仓库，比如 Claude Skills 官方文档[1]、MiniMax 开源仓库[2]、Agent Skills 开放标准[3]，慢慢发现一个共同点：</span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;">对怎么写</span></span><span style="font-size: 15px;"><span style="'font-weight:"><span><span style="letter-spacing: 1px;">好</span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span><code><span style="'font-family:"><span><span style="letter-spacing: 1px;">的标准讲得多，但对 Skill 如何研发、如何迭代的具体实践介绍得相对少</span></span></span></code></span></span><span style="'font-family:"><span><span style="letter-spacing: 1px;">。</span></span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="font-size: 15px;"><span style="'font-family:"><span style="letter-spacing: 1px;font-size: 15px;"><span><span style="letter-spacing: 1px;">和内部运营、产品、研发小二聊得越多，我们越确信一件事：不能持续迭代的 Skill，说到底只是一次性的 demo。所以本文换个角度，从"架构设计、研发效能、运行优化、呈现方式"四个维度切入，以 </span></span></span></span><span style="'box-sizing:"></span><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code><span style="'box-sizing:"><span><span style="letter-spacing: 1px;">（百亿补贴详情助手，50+ commit）的实际研发历程为例，介绍我们在</span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;">迭代开发 Skill</span></span></span></span><span style="'font-family:"><span style="letter-spacing: 1px;font-size: 15px;"><span><span style="letter-spacing: 1px;"> 过程中攒下的经验，给读者一些简单、能直接上手的 Skill 开发实践。</span></span></span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span><br/></span></span></p><section><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><img src="https://pic.imgdb.cn/i/034BIJUUtO1zKi11PoWcSB.png" class="rich_pages wxw-img" style="'-webkit-tap-highlight-color:"/></span></span></section><section><span style="'-webkit-tap-highlight-color:">百亿补贴详情助手简介</span></section></section></span></h2></section></h2></section></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code><span style="'box-sizing:"><span><span style="letter-spacing: 1px;">（百亿补贴详情助手）是百亿补贴商品详情页的智能分析 Skill，由</span></span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;">本地 Skill</span></span></span><span style="'font-family:"><span><span style="letter-spacing: 1px;"> 文件和</span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;">远程 Agent</span></span></span><span style="'font-family:"><span><span style="letter-spacing: 1px;"> 两部分组成，两者之间通过 </span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">xiaomi.py</span></span></span></code></span></span></span></span><span style="'font-family:"><span style="font-size: 15px;"><span style="letter-spacing: 1px;"> 桥接脚本连接：</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"><span style="font-size: 15px;"><br/></span></span></p></section><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJW4HH4e7Ueog3tJU7.jpg" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">bybt-detail-assistant 的架构示意图</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">本地 Skill 的核心设计是"</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">决策树路由 + 远程 Agent API 桥接</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">"——本地负责信息收集、商品查询和结果呈现，而日志搜索、截屏分析这类依赖集团内部在线服务和知识库的深度分析，则交给远程 Agent。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span><br/></span></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJXZMob6HwfozTMqRz.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span><br/></span></span></p><section><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><img src="https://pic.imgdb.cn/i/034BIJYlqM4ZRlSv4CkS9Z.png" class="rich_pages wxw-img" style="'-webkit-tap-highlight-color:"/></span></span></section><section><span style="'-webkit-tap-highlight-color:">业界 Skill 最佳实践梳理</span></section></section></span></h2></section></h2></section></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span><br/></span></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">3.1 Claude Skills：渐进式披露 + 控制调优</span></span></h3></section></section></section></span></h2></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">Anthropic 的官方最佳实践[1]和 Agent Skills 开放标准[3]建立了 Skill 设计的核心框架。社区对其做过 14 种设计模式的深度拆解[4]，其中以下几个关键理念对我们影响最大。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">渐进式披露（Progressive Disclosure）</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">[1][4]：</span></span></span></p></section><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-size: 15px;"><span><span style="letter-spacing: 1px;">一般来说，Skill 的加载分三层：</span></span></span></span></span></p><ul class="list-paddingleft-1"><li><p style="text-align: left;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"></span><span style="font-size: 15px;"><code><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">L1 元信息（name + description）</span></span></span></code></span></code><span><span style="'font-family:"><span style="letter-spacing: 1px;"> → 每次会话启动时加载，决定 Skill 是否被激活；</span></span></span></span></p></li><li><p style="text-align: left;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"></span><span style="font-size: 15px;"><code><span><span style="font-size: 15px;"><span style="'font-family:"><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">L2 SKILL.md 正文</span></span></span></code></span></span></span></span><span style="'font-family:"><span style="letter-spacing: 1px;"> </span></span></span></code><span><span style="'font-family:"><span style="letter-spacing: 1px;">→ 判断需要使用时才加载，是 Skill 的主指令集；</span></span></span></span></p></li><li><p style="text-align: left;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"></span><span style="font-size: 15px;"><span style="'font-family:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">L3 附件资源（references/、scripts/）</span></span></span></code></span></span></span><span style="'font-size:"><span style="'font-family:"><span style="letter-spacing: 1px;">→ 执行过程中按需读取，不占用 L2 的 token 预算。</span></span></span></p></li></ul></section><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="font-size: 15px;"><span style="'font-family:"><span><span style="letter-spacing: 1px;">官方建议 </span></span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;"> 正文控制在 500 行以内</span></span></span><span style="'font-family:"><span><span style="letter-spacing: 1px;">，超过则拆分为独立文件[1]。其中，description 字段尤为关键，它不只是摘要，更是 Agent 在选择 Skill 时的</span></span></span><span style="'font-weight:"><span><span style="letter-spacing: 1px;">重要信号</span></span></span><span style="'font-family:"><span><span style="letter-spacing: 1px;">。官方建议 description 要写得"有侵略性"（pushy），明确列出触发条件和排除条件，</span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code></span></span></span><code><span style="'font-family:"><span><span style="letter-spacing: 1px;"> </span></span></span></code><span style="'font-family:"><span><span style="letter-spacing: 1px;">的 description 覆盖了"截图/链接/ID/</span></span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">traceId</span></span></span></code></span></span></span></span></span><span style="'font-family:"><span style="font-size: 15px;"><span style="letter-spacing: 1px;">/找日志"等多种触发词。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">控制调优（Control Tuning）</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">[1][4]：</span></span></span></p></section><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">核心原则是</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">让指令自由度与任务鲁棒性相匹配</span><span style="letter-spacing: 1px;">，</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">Anthropic 官方文档中这一概念叫 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-style: italic;">matching instruction freedom to task fragility</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，文章[4]中称为 Control Tuning pattern，部分中文文章译为"自由度匹配"。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJa98dh67IWRLR4j4v.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">3.2 MiniMax Skills：标准化仓库 + 工业化生产</span></span></h3></section></section></section></span></h2></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">MiniMax 的开源仓库[2]是目前社区中成熟的 Skill 工业化样板（16+ 生产级 Skill，含 frontend-dev、fullstack-dev、android-native-dev 等），其工程化体系值得借鉴：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJbX7CyNsAnoqFMuok.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">另外，MiniMax 的 </span></span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">CONTRIBUTING.md</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 还要求"One PR, one purpose"：每个 PR 只做一件事（新增/修复/改进 Skill），这和我们 §4.2.3 的小步提交思路正好一致。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">3.3 Skill 设计模式梳理</span></span></h3></section></section></section></span></h2></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">Skill 的设计模式是一个常被忽视但极有价值的维度。在对社区一批生产级 Skill 逐行分析的基础上，我们把它们归为两类：一类是决定 Skill 整体骨架的</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">工作流结构模式</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，另一类是贯穿</span></span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span><span style="'font-size:"><span style="letter-spacing: 1px;"> </span></span></span><code><span><span style="'font-size:"><span style="letter-spacing: 1px;">编写全过程的</span></span></span></code><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">高频实践模式</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">[4]。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">先看 6 种核心的工作流结构模式：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><br/></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJd7laAwgtn0QZnktb.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-family:"></span><code><span style="'font-family:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code></span></span></code><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 实际是</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">模式 2（决策树）为主干，路径内部混合模式 1（线性）和模式 3（循环迭代）</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 的复合结构。认清自己的 Skill 适合哪种模式，是结构设计的第一步，可以参考下图来选择。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><br/></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJgLnPFbVRXJPCR2dJ.png" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">Skill 工作流模式的决策树示意图</span></span></section></span></section></section></h2><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">选择建议</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：如果你的 Skill 有"输入类型多样 → 处理逻辑互斥"的特征，优先考虑模式 2（决策树）；如果有"尝试 → 验证 → 重试"的特征，混入模式 3（循环迭代）。两者组合是诊断类 Skill 的常见范式。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">在工作流骨架之外，还有几种贯穿 </span></span><span><span style="'font-family:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 编写的高频实践模式[4]，同样值得关注：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJhy0I0LxNeI4ycJYH.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">有了上述业界方法论作为参考，接下来我们回到 </span></span><span style="font-size: 15px;"><span style="'font-family:"><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 自身的迭代历程，逐一展开在架构设计、研发效能、运行优化和呈现方式四个维度中的具体做法。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><img src="https://pic.imgdb.cn/i/034BIJj6ZvOwQCZkyj3fg8.png" class="rich_pages wxw-img" style="'-webkit-tap-highlight-color:"/></span></span></section><section><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span style="font-size: 18px;"><span style="color: #0143FF;">bybt-detail-assistant</span></span></span></code></span></span></section><section><span style="'-webkit-tap-highlight-color:">技能研发最佳实践</span></section></section></span></h2></section></h2></section></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><br/></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin-top: 0px;margin-right: 0px;margin-left: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin-top: 0px;margin-right: 0px;margin-left: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin-top: 0px;margin-right: 0px;margin-left: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">4.1 架构设计</span></span></h3></section></section></section></span></h2></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">桥接器：解耦本地与远程的迭代</span></span></h4></li></ul></section></section></span></h2><p style="margin-bottom: 8px;margin-top: 8px;line-height: 1.75em;"><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span><span style="font-size: 15px;"><span style="'font-family:"><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">bybt-detail-assistant</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 目前处在边试用边迭代的阶段，需要频繁升级（新增埋点字段解读、优化匹配算法）。如果把所有逻辑都放在本地 Skill，每次升级都要改动 </span></span><span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 并重新发版，用户还得跟着频繁更新本地版本，很难保证所有用户体验一致。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">桥接器 </span></span><span><span style="font-size: 15px;"><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">xiaomi.py</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 本质是调用 Agent API（复用了原“百补详情小蜜 Agent”）客户端脚本。由于我们设计了稳定的协议，远程 Agent 升级时（如支持新埋点字段解读），S</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">kill 作者</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">无需修改本地 Skill。这就实现了"远程能力迭代"与"本地 Skill 版本"的解耦。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJkOVjkk0m3zk0PUui.jpg" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">本地 Skill文件 与远程 Agent 版本解耦示意图</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">这套分离架构，说到底是在</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">稳定性</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">与</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">迭代速度</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">之间做的一次主动取舍，值得展开讲讲。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">就缺点而言，最显而易见的代价就是跨系统桥接天然比单体更“脆”：本地与远程通过 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">xiaomi.py</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">约定的接口通信，多出一段网络链路和一层协议契约，任意一端的问题都可能让端到端链路失败；排查问题时也要在两个运行环境之间来回定位，归因成本更高。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">但我们还是进行了拆分，根本原因很简单：这两部分的 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">变化节奏</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 和 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">迭代成本</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 完全不同。远程 Agent 扛的是分析能力，比如埋点解读、问题排查，几乎每周都在跟着新增的埋点和排查场景往上加。这类逻辑要是塞在本地，既慢，又容易版本不一致，还没有灰度的余地。放在远程 Agent 就不一样：版本管理、灰度发布、可观测、一键回滚都很成熟，天生适合安全又快速地上线。想试新逻辑，先灰度一小撮流量；出了问题，一键回滚，用户完全无感，也不用天天升级本地。本地 Skill 只保留信息收集、商品查询、结果呈现这层「薄客户端」，改动少，本就该是整条链路里最稳的一环。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">就是基于上面的考虑，我们用 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">架构边界</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 把 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">需要保持稳定</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 和 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">需要高频迭代</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 两类诉求在物理上隔开，在远程分析能力还在高频迭代的当下，这道隔离带来的收益，远大于桥接本身的脆弱性。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">决策树：按需加载而非全量展开</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">我们的 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">曾经把各个功能的描述交织在一起</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，在低端模型上经常让 Agent 顾此失彼、迷失方向。因此，我们把 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">划分为三条逻辑互斥的路径（例如执行路径 A（输出详情访问报告）时，完全不需要知道路径 C（找详情访问日志）的细节），Agent 的执行效率明显提升。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">在共享全局约束的情况下，使用决策树拆分路径，每条路径自包含输出规则和主动引导逻辑。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section class="code-snippet__fix code-snippet__js"><ul class="code-snippet__line-index code-snippet__js"><li></li><li></li><li></li><li></li><li></li><li></li></ul><pre class="code-snippet__js">全局约束（所有路径共用，~60行） ↓决策树（4条规则，~20行） ├─ 路径A：traceId 分析（~30行）——线性模式 ├─ 路径B：商品查询（~15行）——线性模式 └─ 路径C：截图+日志（~250行）——循环迭代模式</pre></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">这是模式 2（决策树+按需加载）在单文件内的实现——通过层级标题实现逻辑隔离。这种基于执行路径隔离的实践还有一个好处是</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">便于后续拆分</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：目前百补详情助手的 </span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 还尚未达到 500 行，未来继续膨胀时，可以方便地按照路径把文件物理拆分为 </span></span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">path-a.md</span></span></span></code></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">、</span></span><span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">path-b.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 等，直接升级为完整的多文件渐进式披露。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">注意力聚焦：减少 </span><span><span style="font-size: 15px;"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;color: #0143FF;">SKILL.md</span></span></span></code></span></span></span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;"> 中的次要信息</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">最初尝试把远程 Agent 的所有分析规则（上百条埋点解读逻辑）写进 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，结果本地 Agent 在执行简单的日志搜索时也要加载全量规则，模型 token 开销大，还容易"走神"——偶尔会自作主张地去分析埋点，而不是老老实实搜日志；我们常常得打断 skill 执行、反复纠正，才能把 Agent 拉回正轨。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">对于埋点解读，本地 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 只描述"什么时候调 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">xiaomi.py</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">、参数怎么传、结果怎么输出"，不在 prompt 中塞入完整埋点分析规则。注意力开销从"全量规则库"缩减到"调用协议"，Agent 在执行当前步骤时注意力更集中。作为替代，我们用 Python 脚本固化埋点解读逻辑，经过实验，</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">相比让 LLM 处理，脚本直出最多快 7 倍，且格式 100% 统一</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">。这属于 Claude 所说的"低自由度"[1]——埋点解读报告有成熟的解析、展示规则，因此脚本可以直接固定"怎么输出"，把模型的注意力留给更重要的任务。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><blockquote><p><span>💡 Context Budget 意识[4]：当 </span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span><span> 接近 500 行阈值时，每次新增内容都要问："删掉这句话会不会导致 Agent 出错？"如果不会，就不应该加。Agent 已经知道的常识不需要重复。</span></p></blockquote><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">4.2 研发效能</span></span></h3></section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"><br/></span></span></h3></section></section></section></span></h2></section></h2><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">直接用最强模型开发：让 AI 帮写 Skill</span></span></h4><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;"><br/></span></span></h4></li></ul></section></section></span></h2></section><blockquote><p><span>💡 这是所有实践中最简单、效率提升最明显的一条。</span></p></blockquote><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">一开始为了省 token，我们用中端模型来写 Skill，结果频繁出现理解偏差——路径 C 日志搜索的循环逻辑写得支离破碎，改了三四轮还不对，算下来消耗的总 token 远超一次性用强模型的开销。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">随着实践的深入，我们越来越认同一个说法：在基于 Vibe Coding 进行 Skill 开发过程中，难点不在"怎么写文档"，而在"把需求讲清楚、把上下文喂足"。开发者的核心责任从从"手写文档"变成"描述意图 + 提供上下文 + 审查结果"之后，开发过程很最关键的一个变量，就是模型本身的能力。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">既然创建和优化 Skill 本身就是高复杂度任务，开发阶段直接用最强模型一步到位</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">把官方 Skills 最佳实践[1] + 真实案例数据（包括报错信息） + 现有 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 一并放入 Agent 上下文，要求 ta 解决当前问题/实现预期功能（</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">当然如果可以提供正确的解决思路会更好:D</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">）。然后让 ta 反思、总结自己解决问题的过程，自己输出 Skill。最终到了验证时，再测试弱模型的兼容性，保证 Skill 在各种环境下都能按预期稳定执行。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">本地远程共享视角：按需暴露上下文</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：本地 Skill 调用远程 Agent 返回结果后，经常出现格式解析失败——原因是本地开发时不了解远程 workflow 的返回结构变化。本地桥接器期望的 JSON schema 和远程实际返回的结构之间产生偏差，就像前后端接口协议不同步一样痛苦。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是：借鉴 Monorepo 的核心实践——将跨边界代码纳入同一可见范围</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJlpJcJELoruaAiIji.jpg" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">Skill 开发迭代的策略示意图</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">Google 的经典论文 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">"</span><span style="letter-spacing: 1px;font-style: italic;">Why Google Stores Billions of Lines of Code in a Single Repository</span><span style="letter-spacing: 1px;">"</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">[5] 总结了 Monorepo 的核心优势：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">统一版本视图、跨项目原子性修改、简化依赖管理</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">。在我们的场景中，虽然本地 Skill 和远程 Agent 物理上分属两个系统，但我们将远程 Agent 的代码（FC-style 节点 + LLM 节点 prompt）纳入 Agent 的同一工作区，让 ta 拥有完整的上下文：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section style="text-align: justify;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJnJd9Ff9V9rWiyRvQ.png" class="rich_pages wxw-img" style="width: 100%;"/></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">但在实践当中，我们也同时注意到 Monorepo 的经典取舍在 AI 场景下被放大了：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">全局视角 vs 注意力分散</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">。Google 的论文[5]就指出 Monorepo 的挑战之一是"工具必须能处理大规模代码"，而在 AI Agent 场景下，这个问题变成了"上下文窗口必须能处理大规模信息"。我们遇到的问题具体表现为：</span></span></span></p><ol class="list-paddingleft-1"><li><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">上下文污染导致注意力分散</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：例如，当我们只想修改本地的商品搜索策略时，Agent 之前读取的无关内容（例如：远程 workflow 的埋点解析规则）被无效地填入上下文窗口，白白消耗模型的注意力。</span></span></span></p></li><li><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">越界修改</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：Agent 看到远程代码后，有时会"好心"地顺便“优化”远程节点逻辑，导致本地和远程的改动纠缠在一起，难以独立回滚。</span></span></span></p></li></ol><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">我们的平衡策略是</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">按任务需要动态切换工作区范围，而不是把所有代码常驻在同一上下文中</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">：</span></span></span></p><ul class="list-paddingleft-1"><li><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">常规迭代</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（只改本地 or 只改远程）：另起独立的 Coding Agent 会话，只加载当前侧的代码，避免上下文污染。</span></span></span></p></li><li><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">协议设计 / 边界调整</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（本地+远程同时改）：先让 Coding Agent 反思两侧的新增改动，然后切换为共享视角进行跨边界的原子性修改。</span></span></span></p></li></ul><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">这本质上呼应了 Claude Code 官方最佳实践[6]所倡导的</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">聚焦当前任务上下文</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">的理念——平时缩小范围，需要时才扩大视野。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">小步提交：让每次改动可追溯、可回滚</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">早期我们经常一口气改完多个路径的逻辑，结果一旦出了问题，很难定位是哪处改动导致的，这导致回滚成本极高。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">使用 Git 管理</span><span style="letter-spacing: 1px;font-weight: normal;"> </span></span><span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;font-weight: normal;">skills/</span></span></span></code></span></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">目录，每次迭代只改一个维度（比如只调整时间窗口策略，或只修一个术语），改完验证通过后，立即 提交 commit。diff 越小，AI 辅助审查就越精准—— ta 能明确告诉你"这次修改是否引入了信息遗漏"，这与 §3.2 提到的 MiniMax "One PR, one purpose"[2] 理念一致。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">让 Agent 看到"运行时"：提供真实数据和完整报错</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">我们踩过两个坑：1、开发时 Agent 使用普通商品数据调试日志搜索功能一切正常，实际使用时才发现百补热门商品（例如：iPhone 17 系列）1 分钟内可能有上千条访问记录，默认 5 分钟的搜索窗口直接返回爆炸数据量。2、</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">search_detail_logs.py</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 遇到字段缺失、编码异常、JSON 嵌套层级变化时报错频出，只把报错的 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">ErrorMessage</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 丢给 Agent，ta 并不理解报错进程的真正上下文，几轮修改后问题仍在。经过分析，我们意识到这 2 个坑实际上对应同一个原因：我们没给 ta 系统运行时的充足上下文。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">把运行时现场原封不动交给 Agent。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">强调 Agent 端到端验证时，一律用包含热点的真实商品和日志，不再用虚构数据——只有让 Skill 跑在真实流量分布下，那些真实问题（包括热门商品、罕见氛围组合、跨单元链路等长尾场景）才会浮出水面。对于真实场景下暴露的极端 case，我们直接指导 Agent 进行评估，如果有价值，则立刻在 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><code><span><span style="'font-size:"><span style="letter-spacing: 1px;">里将其固化为一个 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">gotcha</span></span></span></code></span></span></span></span></code><span><span style="'font-size:"><span style="letter-spacing: 1px;">，把这份"运行时才发现的事"变成下次执行一开始就带着的经验。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">脚本异常时也一样：不要只丢一行 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">ErrorMessage</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">，而是把错误堆栈 + 源码 + 触发这次异常的那一份具体输入数据一次性打包给 Agent。如此一来，源码提供业务逻辑上下文、堆栈提供报错关键点、输入数据提供复现现场——三样凑齐才是完整的运行时快照。有了这份快照，Agent 会自己在"改一版 → 用同一份输入回放 → 再改"的 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">Loop</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 里收敛，比人工逐行看日志 debug 快得多。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><section><h3 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">▐</span><strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"> </span></strong><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: #FFFFFF;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 16px;letter-spacing: 1px;font-weight: bold;color: #0011FF;font-family: Optima-Regular, PingFangTC-light;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;">4.3 运行优化</span></span></h3></section></section></section></span></h2></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">强制"原文直出"：对抗 LLM 的"总结冲动"</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">如 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">4.1.3</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 小节所述，为了节省模型 Attention、降低返回时延，我们在远程 Agent 中用脚本生成 Markdown 格式的标准化分析报告，但本地模型拿到工具返回后，经常对报告进行二次加工——添加标题、改写措辞、截断表格，甚至添油加醋地补充不存在的分析结论。然而，在日志分析场景中，几乎任何"总结"都是信息损失。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJpDOD0nnf1LG24RvQ.png" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">“原文直出”对比示意图</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">在 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 中用极强语气定义禁止列表：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section class="code-snippet__fix code-snippet__js"><ul class="code-snippet__line-index code-snippet__js"><li></li><li></li><li></li><li></li><li></li><li></li></ul><pre class="code-snippet__js">FORBIDDEN actions:- ❌ 不要对 stdout 内容进行总结或改写- ❌ 不要重新排版或调整 Markdown 格式- ❌ 不要在 stdout 前后添加标题、解释或上下文✅ CORRECT: 直接输出 stdout，一字不改❌ INCORRECT: "根据分析结果，该商品..."</pre></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">我们限制 SKILL 输出后的实际效果如下：截图输入 → 远程分析 → 结构化报告原样直出</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJqrdzs2PeKIrYGB7D.png" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">路径A原文直出截图</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span><span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;color: #0143FF;font-weight: normal;">sessionld</span></span></span></code></span></span></span></span></span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">会话复用：维持远程 Agent 的上下文连贯</span></span></h4></li></ul></section></section></span></h2><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">如前所述，百亿补贴详情助手分为本地文件（负责处理用户输入、商品搜索等）和远程 Agent（日志搜索、埋点解析），早期每次调用远程 Agent 时，我们发现远程 Agent 总是"失忆"——用户先发截图让远程分析，再追问"刚才截图中的详情页面为什么无法加购？"，解决这个问题的日志信息存储在远程 Agent，然而远程 Agent 却完全不记得之前分析过什么日志，用户只能重新发一遍截图。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">在 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 中规定——每个会话的</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">第一次</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">调用 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">xiaomi.py</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 前生成一个随机 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">sessionId</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（格式 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">session-</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">），此后该会话内所有后续调用</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">复用同一个 ID</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">。远程 Agent 通过 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">sessionId</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 识别同一对话上下文，实现跨调用的记忆保持。这是一个极小的设计（</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 中只增加了 ~10 行），但对用户体验的提升非常显著。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">优先给出 HTML 报告：提高信息密度</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">一次日志搜索（路径 C）可能返回几十条记录，详情访问报告（路径 A）也常常占满两屏。如果全部展开在对话里，用户要翻好几屏才能找到关心的那条，既容易信息过载，也得等很久才能看到自己真正关注的内容。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">对于报告类型的长内容回复，本地 Skill 文件（</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 和脚本）直接处理为 html 文件，优先输出本地 html 报告路径，然后让 Agent 自己挖掘其中的关键信息进行展示，例如：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section class="code-snippet__fix code-snippet__js"><ul class="code-snippet__line-index code-snippet__js"><li></li><li></li></ul><pre class="code-snippet__js">> 👆 [日志搜索报告（浏览器打开）](file:///tmp/bybt_search_xxx.html)后续： Markdown 表格（折叠+链接）</pre></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">这样用户点击之后，可以直接在浏览器里打开报告等排版良好的页面，然后借助浏览器对 HTML 的完整支持做搜索等操作。实际效果如下：</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJscWiDdtHOAwAxziy.png" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">HTML 文件路径 + Markdown 回复</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">注意：这里一定要让本地 Agent 来执行 </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">html 文件转换，否则如果放到远程 Agent 产出报告链接，本地 Agent 很可能会丢失报告本身的内容信息，把这种信息密度高、价值大的上下文忽略掉，影响后续轮次的交互。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><ul style="list-style-type: disc;" class="list-paddingleft-1"><li style="color:#0143ff;"><h4 style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;text-align: justify;text-indent: 0px;line-height: 1.75em;box-sizing: border-box !important;overflow-wrap: break-word !important;"><span><span style="visibility: visible;font-size: 15px;-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;">主动引导：Agent 该问的先问清，用户没问到的主动递</span></span></h4></li></ul></section></section></span></h2><p><span><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">问题背景</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">主动引导要处理一头一尾两种场景。一种在开头：用户丢来一张截图问"帮我看看这次访问"，却没说是哪天、是预发还是线上——定位日志需要的关键前提缺了一块。Agent 要是闷头按默认值猜，很可能搜出一堆无关记录，用户白等一场。另一种在结尾：日志里其实藏着 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">regionLimit=true</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（区域限售）、</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">buyNow=false</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（无法立即购买）、</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">atm=false</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">（未命中百补氛围）这些信号，可用户只问了"这个商品正不正常"，你不主动点出来，ta 根本不知道真正的问题在哪。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">我们的解法是</span><span style="letter-spacing: 1px;">：</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">执行前，如果发现关键信息缺失导致无法定位到请求，那么先问清再动手。问也讲方式：使用 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">AskUserQuestion</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 将多个疑点合并成一轮，每个都配好选项和默认值，用户点一下或回一个词就行；如果用户实在拿不准选了"不确定"，就自动放宽搜索范围（跨天、上午下午全覆盖），并如实告诉 ta 这次搜得比较宽。反过来，能从截图或上下文推断出来的（像 24 小时制的"20:11"一看就是下午）绝不多此一问——澄清是为了让用户少等一个错误结果，而非机械式地填表。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJtmfQFLFOP1CoiFAE.jpg" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">执行日志搜索前主动澄清时间范围（1）</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><img src="https://pic.imgdb.cn/i/034BIJvGCIukLjU1BLJYo5.png" class="rich_pages wxw-img" style="width: 100%;"/></section><h2 style="'-webkit-tap-highlight-color:"><section><section style="'-webkit-tap-highlight-color:"><span style="'-webkit-tap-highlight-color:"><section style="text-align: center;margin-top: 0px;margin-bottom: 0px;line-height: 1em;"><span style="min-height: 13px;font-size: 15px;color: #9B9A97;"><span style="font-size: 12px;">执行日志搜索前主动澄清时间范围（2）</span></span></section></span></section></section></h2></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">执行后，Agent 再扫一遍分析结果，命中异常信号就在报告末尾追一句引导式提问，比如"检测到该商品区域限售（</span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">regionLimit=true</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">），要不要看看具体限售区域？"。把所有分析一股脑倒给用户，反而会淹没最要紧的那 3 条；所以我们只递出问题，深挖不深挖，用户自己定。这也正好落在 §3.1 控制调优表的"高自由度"一档——只给 Agent 定目标点出异常，不写死话术，具体怎么问让 ta 临场发挥。</span></span></span></p></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><br/></span></span></p><section><section style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><h2 style="'-webkit-tap-highlight-color:"><section><h2 style="'-webkit-tap-highlight-color:"><section><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><img src="https://pic.imgdb.cn/i/034BIJwUQWQf98azJBosNh.png" class="rich_pages wxw-img" style="'-webkit-tap-highlight-color:"/></span></span></section><section><span style="'-webkit-tap-highlight-color:">结语</span></section></span></section></h2></section></h2></section></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span style="'font-size:"><br/></span></p><section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">回顾百补详情助手迭代历程，我们有 2 点反思最想分享：</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">第一，Skill 的质量上限由"上下文工程"能力决定，而非写作技巧。</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">在对的时机（Agent 要做判断的那一刻），把对的信息（真实案例、错误堆栈、API 返回结构），以对的粒度（不多不少，刚好够做决策）递到模型面前——对于 Skill 迭代而言，这才是真正的核心竞争力，而 </span></span><span><span style="'font-weight:"><span style="font-size: 15px;"><code style="box-sizing: inherit;margin-right: 3px;margin-left: 3px;padding: 1px 4px;font-family: monospace;border: 1px solid rgba(23, 26, 29, 0.08);border-radius: 4px;word-break: break-all;background: none 0% 0% / auto repeat scroll padding-box border-box rgba(23, 26, 29, 0.06);color: rgb(44, 44, 43);font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: break-spaces;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;"><span style="box-sizing: inherit;max-width: 100%;"><span><span style="letter-spacing: 1px;">SKILL.md</span></span></span></code></span></span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;"> 只是这种能力的载体之一。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;font-weight: bold;">第二，让 Agent 自己写 Skill、自己改 Skill，是一种"元能力"。</span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">当你把写 Skill、改 Skill 这件事本身也交给 Agent，人类开发者就从"编写者"变成了"审查者 + 上下文提供者"。这带来的不只是效率，还是一种全新的人机协作方式。</span></span></span></p><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span><span style="'font-size:"><span style="letter-spacing: 1px;">Code is Cheap，Show Me Your Skills! </span></span></span><span><span style="'font-size:"><span style="letter-spacing: 1px;">——让我们一起构建可以带来实际提效的 Skills!</span></span></span></p></section><section><section><h2 style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"><section style="'-webkit-tap-highlight-color:"><span style="-webkit-tap-highlight-color: transparent;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;font-size: 15px;letter-spacing: 1px;"><span style="-webkit-tap-highlight-color: ;margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"></span></span></section></span></section></span></h2></section></section></section><p style="text-align: justify;text-indent: 0px;margin-left: 0px;margin-top: 8px;margin-bottom: 8px;line-height: 1.75em;"><span></span></p></section><section></section> <div class="content-mask">
<a href="javascript:void (0);" class="mask-text login-trigger">
<i class="iconfont icon-suo"></i>
登录查看剩余 70% 内容
<i class="iconfont icon-arrow-right-o"></i>
</a>
</div>
</div>
</div>
标签：AI
想了解 AI 如何助力您的企业？
免费获取企业 AI 成熟度诊断报告，发现转型机会
